@churchapps/content-providers 0.4.1 → 0.5.0

package/dist/index.cjs

@@ -22,13 +22,16 @@ var index_exports = {};
 __export(index_exports, {
   APlayProvider: () => APlayProvider,
   B1ChurchProvider: () => B1ChurchProvider,
+  BaseProvider: () => BaseProvider,
   BibleProjectProvider: () => BibleProjectProvider,
   CbnProvider: () => CbnProvider,
+  DeviceFlowHelper: () => DeviceFlowHelper,
   DropboxProvider: () => DropboxProvider,
   HighVoltageKidsProvider: () => HighVoltageKidsProvider,
   JesusFilmProvider: () => JesusFilmProvider,
   LessonsChurchProvider: () => LessonsChurchProvider,
   LifeChurchProvider: () => LifeChurchProvider,
+  OAuthHelper: () => OAuthHelper,
   PlanningCenterProvider: () => PlanningCenterProvider,
   SignPresenterProvider: () => SignPresenterProvider,
   TokenHelper: () => TokenHelper,
@@ -40,7 +43,8 @@ __export(index_exports, {
   isContentFile: () => isContentFile,
   isContentFolder: () => isContentFolder,
   navigateToPath: () => navigateToPath,
-  registerProvider: () => registerProvider
+  registerProvider: () => registerProvider,
+  toAuthData: () => toAuthData
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -64,33 +68,81 @@ function navigateToPath(instructions, path) {
   return current;
 }
 
+// src/helpers/TokenHelper.ts
+function toAuthData(data, fallbacks) {
+  return {
+    access_token: data.access_token,
+    refresh_token: data.refresh_token || fallbacks?.refreshToken || "",
+    token_type: data.token_type || "Bearer",
+    created_at: Math.floor(Date.now() / 1e3),
+    expires_in: data.expires_in,
+    scope: data.scope || fallbacks?.scope || ""
+  };
+}
+var TokenHelper = class {
+  isAuthValid(auth) {
+    if (!auth) return false;
+    return !this.isTokenExpired(auth);
+  }
+  isTokenExpired(auth) {
+    if (!auth.created_at || !auth.expires_in) return true;
+    const expiresAt = (auth.created_at + auth.expires_in) * 1e3;
+    return Date.now() > expiresAt - 5 * 60 * 1e3;
+  }
+  async refreshToken(config, auth) {
+    if (!auth.refresh_token) return null;
+    try {
+      const params = new URLSearchParams({
+        grant_type: "refresh_token",
+        refresh_token: auth.refresh_token,
+        client_id: config.clientId
+      });
+      const response = await fetch(`${config.oauthBase}/token`, { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: params.toString() });
+      if (!response.ok) {
+        console.warn(`[TokenHelper] Token refresh failed: ${response.status} ${response.statusText}`);
+        return null;
+      }
+      const data = await response.json();
+      return toAuthData(data, { refreshToken: auth.refresh_token, scope: auth.scope });
+    } catch {
+      return null;
+    }
+  }
+};
+
 // src/helpers/OAuthHelper.ts
+function generateCodeVerifier() {
+  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~";
+  const length = 64;
+  const array = new Uint8Array(length);
+  crypto.getRandomValues(array);
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    result += chars.charAt(array[i] % chars.length);
+  }
+  return result;
+}
+async function generateCodeChallenge(verifier) {
+  const encoder = new TextEncoder();
+  const data = encoder.encode(verifier);
+  const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+  const hashArray = new Uint8Array(hashBuffer);
+  let binary = "";
+  for (let i = 0; i < hashArray.length; i++) {
+    binary += String.fromCharCode(hashArray[i]);
+  }
+  const base64 = btoa(binary);
+  return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
 var OAuthHelper = class {
   generateCodeVerifier() {
-    const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~";
-    const length = 64;
-    const array = new Uint8Array(length);
-    crypto.getRandomValues(array);
-    let result = "";
-    for (let i = 0; i < length; i++) {
-      result += chars.charAt(array[i] % chars.length);
-    }
-    return result;
+    return generateCodeVerifier();
   }
   async generateCodeChallenge(verifier) {
-    const encoder = new TextEncoder();
-    const data = encoder.encode(verifier);
-    const hashBuffer = await crypto.subtle.digest("SHA-256", data);
-    const hashArray = new Uint8Array(hashBuffer);
-    let binary = "";
-    for (let i = 0; i < hashArray.length; i++) {
-      binary += String.fromCharCode(hashArray[i]);
-    }
-    const base64 = btoa(binary);
-    return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+    return generateCodeChallenge(verifier);
   }
   async buildAuthUrl(config, codeVerifier, redirectUri, state) {
-    const codeChallenge = await this.generateCodeChallenge(codeVerifier);
+    const codeChallenge = await generateCodeChallenge(codeVerifier);
     const params = new URLSearchParams({
       response_type: "code",
       client_id: config.clientId,
@@ -117,39 +169,7 @@ var OAuthHelper = class {
         return null;
       }
       const data = await response.json();
-      return { access_token: data.access_token, refresh_token: data.refresh_token, token_type: data.token_type || "Bearer", created_at: Math.floor(Date.now() / 1e3), expires_in: data.expires_in, scope: data.scope || config.scopes.join(" ") };
-    } catch {
-      return null;
-    }
-  }
-};
-
-// src/helpers/TokenHelper.ts
-var TokenHelper = class {
-  isAuthValid(auth) {
-    if (!auth) return false;
-    return !this.isTokenExpired(auth);
-  }
-  isTokenExpired(auth) {
-    if (!auth.created_at || !auth.expires_in) return true;
-    const expiresAt = (auth.created_at + auth.expires_in) * 1e3;
-    return Date.now() > expiresAt - 5 * 60 * 1e3;
-  }
-  async refreshToken(config, auth) {
-    if (!auth.refresh_token) return null;
-    try {
-      const params = new URLSearchParams({
-        grant_type: "refresh_token",
-        refresh_token: auth.refresh_token,
-        client_id: config.clientId
-      });
-      const response = await fetch(`${config.oauthBase}/token`, { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: params.toString() });
-      if (!response.ok) {
-        console.warn(`[TokenHelper] Token refresh failed: ${response.status} ${response.statusText}`);
-        return null;
-      }
-      const data = await response.json();
-      return { access_token: data.access_token, refresh_token: data.refresh_token || auth.refresh_token, token_type: data.token_type || "Bearer", created_at: Math.floor(Date.now() / 1e3), expires_in: data.expires_in, scope: data.scope || auth.scope };
+      return toAuthData(data, { scope: config.scopes.join(" ") });
     } catch {
       return null;
     }
@@ -176,7 +196,7 @@ var DeviceFlowHelper = class {
       const response = await fetch(`${config.oauthBase}/token`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ grant_type: "urn:ietf:params:oauth:grant-type:device_code", device_code: deviceCode, client_id: config.clientId }) });
       if (response.ok) {
         const data = await response.json();
-        return { access_token: data.access_token, refresh_token: data.refresh_token, token_type: data.token_type || "Bearer", created_at: Math.floor(Date.now() / 1e3), expires_in: data.expires_in, scope: data.scope || config.scopes.join(" ") };
+        return toAuthData(data, { scope: config.scopes.join(" ") });
       }
       const errorData = await response.json();
       switch (errorData.error) {
@@ -226,6 +246,19 @@ var ApiHelper = class {
   }
 };
 
+// src/providers/BaseProvider.ts
+var BaseProvider = class {
+  constructor() {
+    this.apiHelper = new ApiHelper();
+  }
+  apiRequest(path, auth, method = "GET", body) {
+    return this.apiHelper.apiRequest(this.config, this.id, path, auth, method, body);
+  }
+  supportsDeviceFlow() {
+    return !!this.config.supportsDeviceFlow && !!this.config.deviceAuthEndpoint;
+  }
+};
+
 // src/pathUtils.ts
 function parsePath(path) {
   if (!path || path === "/" || path === "") {
@@ -239,26 +272,6 @@ function getSegment(path, index) {
   return segments[index] ?? null;
 }
 
-// src/providers/aPlay/APlayApi.ts
-var API_BASE = "https://api-prod.amazingkids.app";
-async function checkMediaLicense(mediaId, auth) {
-  if (!auth) return null;
-  try {
-    const url = `${API_BASE}/prod/reports/media/license-check`;
-    const response = await fetch(url, { method: "POST", headers: { "Authorization": `Bearer ${auth.access_token}`, "Content-Type": "application/json", "Accept": "application/json" }, body: JSON.stringify({ mediaIds: [mediaId] }) });
-    if (!response.ok) return null;
-    const data = await response.json();
-    const licenseData = Array.isArray(data) ? data : data.data || [];
-    const result = licenseData.find((item) => item.mediaId === mediaId);
-    if (result?.isLicensed) {
-      return { mediaId, status: "valid", message: "Media is licensed for playback", expiresAt: result.expiresAt };
-    }
-    return { mediaId, status: "not_licensed", message: "Media is not licensed" };
-  } catch {
-    return { mediaId, status: "unknown", message: "Unable to verify license status" };
-  }
-}
-
 // src/utils.ts
 var IMAGE_DURATION_SECONDS = 15;
 function slugify(text) {
@@ -296,6 +309,31 @@ function createFile(id, title, url, options) {
 function generateId() {
   return "gen-" + Math.random().toString(36).substring(2, 11);
 }
+function fileToActionItem(file) {
+  return {
+    id: file.id + "-action",
+    itemType: "action",
+    label: file.title,
+    actionType: "play",
+    seconds: file.seconds || void 0,
+    children: [
+      {
+        id: file.id,
+        itemType: "file",
+        label: file.title,
+        seconds: file.seconds || void 0,
+        downloadUrl: file.downloadUrl || file.url,
+        thumbnail: file.thumbnail,
+        mediaType: file.mediaType
+      }
+    ]
+  };
+}
+function filesToInstructions(name, files, section) {
+  const actions = files.map(fileToActionItem);
+  const items = section ? [{ id: section.id, itemType: "section", label: section.label ?? name, children: actions }] : actions;
+  return { name, items };
+}
 function instructionsToPlaylist(instructions) {
   const files = [];
   function extractFiles(items) {
@@ -310,6 +348,26 @@ function instructionsToPlaylist(instructions) {
   return files;
 }
 
+// src/providers/aPlay/APlayApi.ts
+var API_BASE = "https://api-prod.amazingkids.app";
+async function checkMediaLicense(mediaId, auth) {
+  if (!auth) return null;
+  try {
+    const url = `${API_BASE}/prod/reports/media/license-check`;
+    const response = await fetch(url, { method: "POST", headers: { "Authorization": `Bearer ${auth.access_token}`, "Content-Type": "application/json", "Accept": "application/json" }, body: JSON.stringify({ mediaIds: [mediaId] }) });
+    if (!response.ok) return null;
+    const data = await response.json();
+    const licenseData = Array.isArray(data) ? data : data.data || [];
+    const result = licenseData.find((item) => item.mediaId === mediaId);
+    if (result?.isLicensed) {
+      return { mediaId, status: "valid", message: "Media is licensed for playback", expiresAt: result.expiresAt };
+    }
+    return { mediaId, status: "not_licensed", message: "Media is not licensed" };
+  } catch {
+    return { mediaId, status: "unknown", message: "Unable to verify license status" };
+  }
+}
+
 // src/providers/aPlay/APlayConverters.ts
 function extractLibraryId(path) {
   const { segments, depth } = parsePath(path);
@@ -376,25 +434,6 @@ function convertProductsToFolders(products, currentPath) {
     return createFolder(id, p.title || p.name, `${currentPath}/products/${id}`, p.image);
   });
 }
-function convertFilesToInstructions(files, _libraryId) {
-  const items = files.map((file) => ({
-    id: file.id + "-action",
-    itemType: "action",
-    label: file.title,
-    actionType: "play",
-    children: [
-      {
-        id: file.id,
-        itemType: "file",
-        label: file.title,
-        seconds: file.seconds,
-        downloadUrl: file.url,
-        thumbnail: file.thumbnail
-      }
-    ]
-  }));
-  return { name: "Library", items };
-}
 
 // src/providers/aPlay/APlayProvider.ts
 function extractArray(response, ...keys) {
@@ -407,20 +446,17 @@ function extractArray(response, ...keys) {
   }
   return [];
 }
-var APlayProvider = class {
+var APlayProvider = class extends BaseProvider {
   constructor() {
-    this.apiHelper = new ApiHelper();
+    super(...arguments);
     this.id = "aplay";
     this.name = "APlay";
     this.logos = { light: "https://www.joinamazing.com/_assets/v11/3ba846c5afd7e73d27bc4d87b63d423e7ae2dc73.svg", dark: "https://www.joinamazing.com/_assets/v11/3ba846c5afd7e73d27bc4d87b63d423e7ae2dc73.svg" };
-    this.config = { id: "aplay", name: "APlay", apiBase: API_BASE, oauthBase: "https://api.joinamazing.com/prod/aims/oauth", clientId: "xFJFq7yNYuXXXMx0YBiQ", scopes: ["openid", "profile", "email"], endpoints: { modules: "/prod/curriculum/modules", productLibraries: (productId) => `/prod/curriculum/modules/products/${productId}/libraries`, libraryMedia: (libraryId) => `/prod/creators/libraries/${libraryId}/media` } };
+    this.config = { id: "aplay", name: "APlay", apiBase: API_BASE, oauthBase: "https://api.joinamazing.com/prod/aims/oauth", clientId: "xFJFq7yNYuXXXMx0YBiQ", scopes: ["openid", "profile", "email"] };
     this.requiresAuth = true;
     this.authTypes = ["oauth_pkce"];
     this.capabilities = { browse: true, playlist: true, instructions: true, mediaLicensing: true };
   }
-  async apiRequest(path, auth) {
-    return this.apiHelper.apiRequest(this.config, this.id, path, auth);
-  }
   async browse(path, auth) {
     const { segments, depth } = parsePath(path);
     if (depth === 0) {
@@ -436,12 +472,12 @@ var APlayProvider = class {
     return [];
   }
   async getModules(auth) {
-    const response = await this.apiRequest(this.config.endpoints.modules, auth);
+    const response = await this.apiRequest("/prod/curriculum/modules", auth);
     const modules = extractArray(response, "data", "modules");
     return convertModulesToFolders(modules);
   }
   async getModuleContent(moduleId, currentPath, auth) {
-    const response = await this.apiRequest(this.config.endpoints.modules, auth);
+    const response = await this.apiRequest("/prod/curriculum/modules", auth);
     const modules = extractArray(response, "data", "modules");
     const module2 = modules.find((m) => (m.id || m.moduleId) === moduleId);
     if (!module2) return [];
@@ -457,14 +493,12 @@ var APlayProvider = class {
     }
   }
   async getLibraryFolders(productId, currentPath, auth) {
-    const pathFn = this.config.endpoints.productLibraries;
-    const response = await this.apiRequest(pathFn(productId), auth);
+    const response = await this.apiRequest(`/prod/curriculum/modules/products/${productId}/libraries`, auth);
     const libraries = extractArray(response, "data", "libraries");
     return convertLibrariesToFolders(libraries, currentPath);
   }
   async getMediaFiles(libraryId, auth) {
-    const pathFn = this.config.endpoints.libraryMedia;
-    const response = await this.apiRequest(pathFn(libraryId), auth);
+    const response = await this.apiRequest(`/prod/creators/libraries/${libraryId}/media`, auth);
     const mediaItems = extractArray(response, "data", "media");
     return convertMediaToFiles(mediaItems);
   }
@@ -479,63 +513,47 @@ var APlayProvider = class {
     if (!libraryId) return null;
     const files = await this.getMediaFiles(libraryId, auth);
     if (files.length === 0) return null;
-    return convertFilesToInstructions(files, libraryId);
+    return filesToInstructions("Library", files);
   }
   async checkMediaLicense(mediaId, auth) {
     return checkMediaLicense(mediaId, auth);
   }
-  supportsDeviceFlow() {
-    return false;
-  }
 };
 
 // src/providers/signPresenter/SignPresenterProvider.ts
-var SignPresenterProvider = class {
+var SignPresenterProvider = class extends BaseProvider {
   constructor() {
-    this.apiHelper = new ApiHelper();
+    super(...arguments);
     this.oauthHelper = new OAuthHelper();
     this.deviceFlowHelper = new DeviceFlowHelper();
     this.id = "signpresenter";
     this.name = "SignPresenter";
     this.logos = { light: "https://signpresenter.com/files/shared/images/logo.png", dark: "https://signpresenter.com/files/shared/images/logo.png" };
-    this.config = { id: "signpresenter", name: "SignPresenter", apiBase: "https://api.signpresenter.com", oauthBase: "https://api.signpresenter.com/oauth", clientId: "lessonsscreen-tv", scopes: ["openid", "profile", "content"], supportsDeviceFlow: true, deviceAuthEndpoint: "/device/authorize", endpoints: { playlists: "/content/playlists", messages: (playlistId) => `/content/playlists/${playlistId}/messages` } };
+    this.config = { id: "signpresenter", name: "SignPresenter", apiBase: "https://api.signpresenter.com", oauthBase: "https://api.signpresenter.com/oauth", clientId: "lessonsscreen-tv", scopes: ["openid", "profile", "content"], supportsDeviceFlow: true, deviceAuthEndpoint: "/device/authorize" };
     this.requiresAuth = true;
     this.authTypes = ["oauth_pkce", "device_flow"];
     this.capabilities = { browse: true, playlist: true, instructions: true, mediaLicensing: false };
   }
-  async apiRequest(path, auth) {
-    return this.apiHelper.apiRequest(this.config, this.id, path, auth);
-  }
   async browse(path, auth) {
     const { segments, depth } = parsePath(path);
     if (depth === 0) {
-      return [
-        {
-          type: "folder",
-          id: "playlists-root",
-          title: "Playlists",
-          path: "/playlists"
-        }
-      ];
-    }
-    const root = segments[0];
-    if (root !== "playlists") return [];
-    if (depth === 1) {
-      return this.getPlaylists(auth);
-    }
-    if (depth === 2) {
-      const playlistId = segments[1];
-      return this.getMessages(playlistId, auth);
+      return [{ type: "folder", id: "playlists-root", title: "Playlists", path: "/playlists" }];
     }
+    if (segments[0] !== "playlists") return [];
+    if (depth === 1) return this.getPlaylists(auth);
+    if (depth === 2) return this.getMessages(segments[1], auth);
     return [];
   }
+  extractList(response, key) {
+    if (Array.isArray(response)) return response;
+    const record = response;
+    const list = record?.data || record?.[key] || [];
+    return Array.isArray(list) ? list : [];
+  }
   async getPlaylists(auth) {
-    const apiPath = this.config.endpoints.playlists;
-    const response = await this.apiRequest(apiPath, auth);
+    const response = await this.apiRequest("/content/playlists", auth);
     if (!response) return [];
-    const playlists = Array.isArray(response) ? response : response.data || response.playlists || [];
-    if (!Array.isArray(playlists)) return [];
-    return playlists.map((p) => ({
+    return this.extractList(response, "playlists").map((p) => ({
       type: "folder",
       id: p.id,
       title: p.name,
@@ -545,26 +563,17 @@ var SignPresenterProvider = class {
     }));
   }
   async getMessages(playlistId, auth) {
-    const pathFn = this.config.endpoints.messages;
-    const response = await this.apiRequest(pathFn(playlistId), auth);
+    const response = await this.apiRequest(`/content/playlists/${playlistId}/messages`, auth);
     if (!response) return [];
-    const messages = Array.isArray(response) ? response : response.data || response.messages || [];
-    if (!Array.isArray(messages)) return [];
     const files = [];
-    for (const msg of messages) {
+    for (const msg of this.extractList(response, "messages")) {
       if (!msg.url) continue;
       const url = msg.url;
-      const seconds = msg.seconds;
-      const file = createFile(
-        msg.id,
-        msg.name,
-        url,
-        {
-          mediaType: detectMediaType(url, msg.mediaType),
-          thumbnail: msg.thumbnail || msg.image,
-          seconds
-        }
-      );
+      const file = createFile(msg.id, msg.name, url, {
+        mediaType: detectMediaType(url, msg.mediaType),
+        thumbnail: msg.thumbnail || msg.image,
+        seconds: msg.seconds
+      });
       file.downloadUrl = url;
       files.push(file);
     }
@@ -573,8 +582,7 @@ var SignPresenterProvider = class {
   async getPlaylist(path, auth, _resolution) {
     const { segments, depth } = parsePath(path);
     if (depth < 2 || segments[0] !== "playlists") return null;
-    const playlistId = segments[1];
-    const files = await this.getMessages(playlistId, auth);
+    const files = await this.getMessages(segments[1], auth);
     return files.length > 0 ? files : null;
   }
   async getInstructions(path, auth) {
@@ -584,43 +592,11 @@ var SignPresenterProvider = class {
     const files = await this.getMessages(playlistId, auth);
     if (files.length === 0) return null;
     const playlists = await this.getPlaylists(auth);
-    const playlist = playlists.find((p) => p.id === playlistId);
-    const title = playlist?.title || "Playlist";
-    const actionItems = files.map((file) => ({
-      id: file.id + "-action",
-      itemType: "action",
-      label: file.title,
-      actionType: "play",
-      seconds: file.seconds,
-      children: [
-        {
-          id: file.id,
-          itemType: "file",
-          label: file.title,
-          seconds: file.seconds,
-          downloadUrl: file.downloadUrl || file.url,
-          thumbnail: file.thumbnail
-        }
-      ]
-    }));
-    const sectionItem = {
-      id: playlistId + "-section",
-      itemType: "section",
-      label: title,
-      children: actionItems
-    };
-    const headerItem = {
-      id: playlistId + "-header",
-      itemType: "header",
-      label: title,
-      children: [sectionItem]
-    };
-    return { name: title, items: [headerItem] };
+    const title = playlists.find((p) => p.id === playlistId)?.title || "Playlist";
+    const instructions = filesToInstructions(title, files, { id: playlistId + "-section", label: title });
+    return { name: title, items: [{ id: playlistId + "-header", itemType: "header", label: title, children: instructions.items }] };
   }
   // Auth methods
-  supportsDeviceFlow() {
-    return this.deviceFlowHelper.supportsDeviceFlow(this.config);
-  }
   generateCodeVerifier() {
     return this.oauthHelper.generateCodeVerifier();
   }
@@ -667,6 +643,23 @@ function truncateForLabel(text) {
   const truncated = text.length > cutoff ? text.substring(0, cutoff) : text;
   return stripMarkdown(truncated) + (text.length > cutoff ? "..." : "");
 }
+function getEmbedUrl(apiType, relatedId) {
+  if (!relatedId) return void 0;
+  const baseUrl = "https://lessons.church";
+  switch (apiType) {
+    case "action":
+    case "lessonAction":
+      return `${baseUrl}/embed/action/${relatedId}`;
+    case "addon":
+    case "lessonAddOn":
+      return `${baseUrl}/embed/addon/${relatedId}`;
+    case "section":
+    case "lessonSection":
+      return `${baseUrl}/embed/section/${relatedId}`;
+    default:
+      return void 0;
+  }
+}
 async function convertAddOnToFile(addOn) {
   const apiPath = `/addOns/public/${addOn.id}`;
   const detail = await apiRequest(apiPath);
@@ -813,12 +806,13 @@ async function convertAddOnCategoryToInstructions(category) {
 }
 
 // src/providers/lessonsChurch/LessonsChurchProvider.ts
-var LessonsChurchProvider = class {
+var LessonsChurchProvider = class extends BaseProvider {
   constructor() {
+    super(...arguments);
     this.id = "lessonschurch";
     this.name = "Lessons.church";
     this.logos = { light: "https://lessons.church/images/logo.png", dark: "https://lessons.church/images/logo-dark.png" };
-    this.config = { id: "lessonschurch", name: "Lessons.church", apiBase: API_BASE2, oauthBase: "", clientId: "", scopes: [], endpoints: { programs: "/programs/public", studies: (programId) => `/studies/public/program/${programId}`, lessons: (studyId) => `/lessons/public/study/${studyId}`, venues: (lessonId) => `/venues/public/lesson/${lessonId}`, playlist: (venueId) => `/venues/playlist/${venueId}`, feed: (venueId) => `/venues/public/feed/${venueId}`, addOns: "/addOns/public", addOnDetail: (id) => `/addOns/public/${id}` } };
+    this.config = { id: "lessonschurch", name: "Lessons.church", apiBase: API_BASE2, oauthBase: "", clientId: "", scopes: [] };
     this.requiresAuth = false;
     this.authTypes = ["none"];
     this.capabilities = { browse: true, playlist: true, instructions: true, mediaLicensing: false };
@@ -874,28 +868,25 @@ var LessonsChurchProvider = class {
     return [];
   }
   async getPrograms() {
-    const response = await apiRequest(this.config.endpoints.programs);
+    const response = await apiRequest("/programs/public");
     if (!response) return [];
     const programs = Array.isArray(response) ? response : [];
     return programs.map((p) => createFolder(p.id, p.name, `/lessons/${p.id}`, p.image));
   }
   async getStudies(programId, currentPath) {
-    const pathFn = this.config.endpoints.studies;
-    const response = await apiRequest(pathFn(programId));
+    const response = await apiRequest(`/studies/public/program/${programId}`);
     if (!response) return [];
     const studies = Array.isArray(response) ? response : [];
     return studies.map((s) => createFolder(s.id, s.name, `${currentPath}/${s.id}`, s.image)).sort((a, b) => a.title.localeCompare(b.title));
   }
   async getLessons(studyId, currentPath) {
-    const pathFn = this.config.endpoints.lessons;
-    const response = await apiRequest(pathFn(studyId));
+    const response = await apiRequest(`/lessons/public/study/${studyId}`);
     if (!response) return [];
     const lessons = Array.isArray(response) ? response : [];
     return lessons.map((l) => createFolder(l.id, l.name || l.title, `${currentPath}/${l.id}`, l.image));
   }
   async getVenues(lessonId, currentPath) {
-    const pathFn = this.config.endpoints.venues;
-    const response = await apiRequest(pathFn(lessonId));
+    const response = await apiRequest(`/venues/public/lesson/${lessonId}`);
     if (!response) return [];
     const lessonResponse = await apiRequest(`/lessons/public/${lessonId}`);
     const lessonImage = lessonResponse?.image;
@@ -918,7 +909,7 @@ var LessonsChurchProvider = class {
     return file ? [file] : [];
   }
   async getAddOnCategories() {
-    const response = await apiRequest(this.config.endpoints.addOns);
+    const response = await apiRequest("/addOns/public");
     if (!response) return [];
     const addOns = Array.isArray(response) ? response : [];
     const categories = Array.from(new Set(addOns.map((a) => a.category).filter(Boolean)));
@@ -926,7 +917,7 @@ var LessonsChurchProvider = class {
   }
   async getAddOnsByCategory(category, currentPath) {
     const decodedCategory = decodeURIComponent(category);
-    const response = await apiRequest(this.config.endpoints.addOns);
+    const response = await apiRequest("/addOns/public");
     if (!response) return [];
     const allAddOns = Array.isArray(response) ? response : [];
     const filtered = allAddOns.filter((a) => a.category === decodedCategory);
@@ -969,9 +960,6 @@ var LessonsChurchProvider = class {
     }
     return null;
   }
-  supportsDeviceFlow() {
-    return false;
-  }
 };
 
 // src/providers/registry.ts
@@ -987,18 +975,6 @@ function registerProvider(provider) {
 }
 
 // src/providers/b1Church/B1ChurchAuth.ts
-async function generateCodeChallenge(verifier) {
-  const encoder = new TextEncoder();
-  const data = encoder.encode(verifier);
-  const hashBuffer = await crypto.subtle.digest("SHA-256", data);
-  const hashArray = new Uint8Array(hashBuffer);
-  let binary = "";
-  for (let i = 0; i < hashArray.length; i++) {
-    binary += String.fromCharCode(hashArray[i]);
-  }
-  const base64 = btoa(binary);
-  return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
-}
 async function buildB1AuthUrl(config, appBase, redirectUri, codeVerifier, state) {
   const codeChallenge = await generateCodeChallenge(codeVerifier);
   const oauthParams = new URLSearchParams({
@@ -1022,7 +998,7 @@ async function exchangeCodeForTokensWithPKCE(config, code, redirectUri, codeVeri
       return null;
     }
     const data = await response.json();
-    return { access_token: data.access_token, refresh_token: data.refresh_token, token_type: data.token_type || "Bearer", created_at: Math.floor(Date.now() / 1e3), expires_in: data.expires_in, scope: data.scope || config.scopes.join(" ") };
+    return toAuthData(data, { scope: config.scopes.join(" ") });
   } catch {
     return null;
   }
@@ -1036,7 +1012,7 @@ async function exchangeCodeForTokensWithSecret(config, code, redirectUri, client
       return null;
     }
     const data = await response.json();
-    return { access_token: data.access_token, refresh_token: data.refresh_token, token_type: data.token_type || "Bearer", created_at: Math.floor(Date.now() / 1e3), expires_in: data.expires_in, scope: data.scope || config.scopes.join(" ") };
+    return toAuthData(data, { scope: config.scopes.join(" ") });
   } catch {
     return null;
   }
@@ -1048,7 +1024,7 @@ async function refreshTokenWithSecret(config, auth, clientSecret) {
     const response = await fetch(`${config.oauthBase}/token`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(params) });
     if (!response.ok) return null;
     const data = await response.json();
-    return { access_token: data.access_token, refresh_token: data.refresh_token || auth.refresh_token, token_type: data.token_type || "Bearer", created_at: Math.floor(Date.now() / 1e3), expires_in: data.expires_in, scope: data.scope || auth.scope };
+    return toAuthData(data, { refreshToken: auth.refresh_token, scope: auth.scope });
   } catch {
     return null;
   }
@@ -1073,78 +1049,32 @@ async function authFetch(url, auth) {
   }
 }
 async function fetchMinistries(auth) {
-  const result = await authFetch(`${API_BASE3}/membership/groups/tag/ministry`, auth);
-  return result || [];
+  return await authFetch(`${API_BASE3}/membership/groups/tag/ministry`, auth) || [];
 }
 async function fetchPlanTypes(ministryId, auth) {
-  const result = await authFetch(`${API_BASE3}/doing/planTypes/ministryId/${ministryId}`, auth);
-  return result || [];
+  return await authFetch(`${API_BASE3}/doing/planTypes/ministryId/${ministryId}`, auth) || [];
 }
 async function fetchPlans(planTypeId, auth) {
-  const result = await authFetch(`${API_BASE3}/doing/plans/types/${planTypeId}`, auth);
-  return result || [];
+  return await authFetch(`${API_BASE3}/doing/plans/types/${planTypeId}`, auth) || [];
 }
-var DOING_API_BASE = "https://api.churchapps.org/doing";
 async function fetchCurrentPlanByType(planTypeId) {
-  try {
-    const response = await fetch(`${DOING_API_BASE}/plans/public/current/${planTypeId}`, { method: "GET", headers: { Accept: "application/json" } });
-    if (!response.ok) {
-      console.warn(`[B1Church] fetchCurrentPlanByType failed: HTTP ${response.status} for planTypeId=${planTypeId}`);
-      return null;
-    }
-    return await response.json();
-  } catch (err) {
-    console.error(`[B1Church] fetchCurrentPlanByType error: planTypeId=${planTypeId}`, err);
-    return null;
-  }
+  return authFetch(`${API_BASE3}/doing/plans/public/current/${planTypeId}`);
 }
 async function fetchPlanItems(churchId, planId) {
-  try {
-    const response = await fetch(`${DOING_API_BASE}/planItems/presenter/${churchId}/${planId}`, { method: "GET", headers: { Accept: "application/json" } });
-    if (!response.ok) return [];
-    return await response.json() || [];
-  } catch {
-    return [];
-  }
+  return await authFetch(`${API_BASE3}/doing/planItems/presenter/${churchId}/${planId}`) || [];
 }
 async function fetchVenueFeed(venueId) {
-  try {
-    const response = await fetch(`${LESSONS_API_BASE}/venues/public/feed/${venueId}`, { method: "GET", headers: { Accept: "application/json" } });
-    if (!response.ok) {
-      console.warn(`[B1Church] fetchVenueFeed failed: HTTP ${response.status} for venueId=${venueId}`);
-      return null;
-    }
-    return await response.json();
-  } catch (err) {
-    console.error(`[B1Church] fetchVenueFeed error: venueId=${venueId}`, err);
-    return null;
-  }
+  return authFetch(`${LESSONS_API_BASE}/venues/public/feed/${venueId}`);
 }
 async function fetchVenueActions(venueId) {
-  try {
-    const response = await fetch(`${LESSONS_API_BASE}/venues/public/actions/${venueId}`, { method: "GET", headers: { Accept: "application/json" } });
-    if (!response.ok) {
-      console.warn(`[B1Church] fetchVenueActions failed: HTTP ${response.status} for venueId=${venueId}`);
-      return null;
-    }
-    return await response.json();
-  } catch (err) {
-    console.error(`[B1Church] fetchVenueActions error: venueId=${venueId}`, err);
-    return null;
-  }
+  return authFetch(`${LESSONS_API_BASE}/venues/public/actions/${venueId}`);
 }
 async function fetchVenueImages(venueIds) {
   const map = /* @__PURE__ */ new Map();
   if (venueIds.length === 0) return map;
-  try {
-    const url = `${LESSONS_API_BASE}/venues/public/images?ids=${venueIds.join(",")}`;
-    const response = await fetch(url, { method: "GET", headers: { Accept: "application/json" } });
-    if (!response.ok) return map;
-    const data = await response.json();
-    for (const row of data) {
-      if (row.venueId && row.lessonImage) map.set(row.venueId, row.lessonImage);
-    }
-  } catch {
+  const data = await authFetch(`${LESSONS_API_BASE}/venues/public/images?ids=${venueIds.join(",")}`);
+  for (const row of data || []) {
+    if (row.venueId && row.lessonImage) map.set(row.venueId, row.lessonImage);
   }
   return map;
 }
@@ -1233,18 +1163,7 @@ function getFileFromProviderFileItem(item) {
   };
 }
 function planItemToInstruction(item, thumbnail) {
-  let itemType = item.itemType;
-  switch (item.itemType) {
-    case "lessonSection":
-      itemType = "section";
-      break;
-    case "lessonAction":
-      itemType = "action";
-      break;
-    case "lessonAddOn":
-      itemType = "action";
-      break;
-  }
+  const itemType = normalizeItemType(item.itemType);
   const isFileType = itemType === "file" || item.link && !item.children?.length;
   return {
     id: item.id,
@@ -1258,23 +1177,6 @@ function planItemToInstruction(item, thumbnail) {
     children: item.children?.map((child) => planItemToInstruction(child, thumbnail))
   };
 }
-function getEmbedUrl(apiType, relatedId) {
-  if (!relatedId) return void 0;
-  const baseUrl = "https://lessons.church";
-  switch (apiType) {
-    case "action":
-    case "lessonAction":
-      return `${baseUrl}/embed/action/${relatedId}`;
-    case "addon":
-    case "lessonAddOn":
-      return `${baseUrl}/embed/addon/${relatedId}`;
-    case "section":
-    case "lessonSection":
-      return `${baseUrl}/embed/section/${relatedId}`;
-    default:
-      return void 0;
-  }
-}
 function buildSectionActionsMap2(actionsResponse, thumbnail) {
   const sectionActionsMap = /* @__PURE__ */ new Map();
   if (actionsResponse?.sections) {
@@ -1388,9 +1290,9 @@ function isExternalProviderItem(item) {
   const itemType = item.itemType || "";
   return itemType.startsWith("provider");
 }
-var B1ChurchProvider = class {
+var B1ChurchProvider = class extends BaseProvider {
   constructor() {
-    this.apiHelper = new ApiHelper();
+    super(...arguments);
     this.deviceFlowHelper = new DeviceFlowHelper();
     // Unified cache for external provider data to avoid duplicate calls across methods
     this.externalContentCache = {
@@ -1401,16 +1303,13 @@ var B1ChurchProvider = class {
     this.id = "b1church";
     this.name = "B1.Church";
     this.logos = { light: "https://b1.church/b1-church-logo.png", dark: "https://b1.church/b1-church-logo.png" };
-    this.config = { id: "b1church", name: "B1.Church", apiBase: `${API_BASE3}/doing`, oauthBase: `${API_BASE3}/membership/oauth`, clientId: "nsowldn58dk", scopes: ["plans"], supportsDeviceFlow: true, deviceAuthEndpoint: "/device/authorize", endpoints: { planItems: (churchId, planId) => `/planFeed/presenter/${churchId}/${planId}` } };
+    this.config = { id: "b1church", name: "B1.Church", apiBase: `${API_BASE3}/doing`, oauthBase: `${API_BASE3}/membership/oauth`, clientId: "nsowldn58dk", scopes: ["plans"], supportsDeviceFlow: true, deviceAuthEndpoint: "/device/authorize" };
     this.appBase = "https://admin.b1.church";
     this.requiresAuth = true;
     this.authTypes = ["oauth_pkce", "device_flow"];
     this.capabilities = { browse: true, playlist: true, instructions: true, mediaLicensing: false };
     this.planTypeId = null;
   }
-  async apiRequest(path, authData) {
-    return this.apiHelper.apiRequest(this.config, this.id, path, authData);
-  }
   async buildAuthUrl(codeVerifier, redirectUri, state) {
     return buildB1AuthUrl(this.config, this.appBase, redirectUri, codeVerifier, state);
   }
@@ -1556,8 +1455,7 @@ var B1ChurchProvider = class {
       console.warn("[B1Church getInstructions] planFolder missing churchId:", planFolder.id);
       return null;
     }
-    const pathFn = this.config.endpoints.planItems;
-    const planItems = await this.apiRequest(pathFn(churchId, planId), authData);
+    const planItems = await this.apiRequest(`/planFeed/presenter/${churchId}/${planId}`, authData);
     if ((!planItems || planItems.length === 0) && planFolder.providerId && planFolder.providerPlanId) {
       const externalInstructions = await fetchFromProviderProxy(
         "getInstructions",
@@ -1665,8 +1563,7 @@ var B1ChurchProvider = class {
       console.warn("[B1Church] getPlaylist: planFolder missing churchId:", planFolder.id);
       return null;
     }
-    const pathFn = this.config.endpoints.planItems;
-    const planItems = await this.apiRequest(pathFn(churchId, planId), authData);
+    const planItems = await this.apiRequest(`/planFeed/presenter/${churchId}/${planId}`, authData);
     if ((!planItems || planItems.length === 0) && planFolder.providerId && planFolder.providerPlanId) {
       const externalFiles = await fetchFromProviderProxy(
         "getPlaylist",
@@ -1761,9 +1658,6 @@ var B1ChurchProvider = class {
     }
     return files;
   }
-  supportsDeviceFlow() {
-    return !!this.config.supportsDeviceFlow;
-  }
 };
 
 // src/providers/dropbox/DropboxConverters.ts
@@ -1789,38 +1683,13 @@ function filterMediaEntries(entries) {
   }
   return { folders, mediaFiles };
 }
-function buildInstructionsFromFiles(files, folderName) {
-  const actionItems = files.map((file) => ({
-    id: file.id + "-action",
-    itemType: "action",
-    label: file.title,
-    actionType: "play",
-    children: [
-      {
-        id: file.id,
-        itemType: "file",
-        label: file.title,
-        seconds: file.seconds,
-        downloadUrl: file.downloadUrl || file.url,
-        thumbnail: file.thumbnail
-      }
-    ]
-  }));
-  const sectionItem = {
-    id: "dropbox-section",
-    itemType: "section",
-    label: folderName,
-    children: actionItems
-  };
-  return { name: folderName, items: [sectionItem] };
-}
 
 // src/providers/dropbox/DropboxProvider.ts
 var MAX_PAGINATION_CALLS = 50;
-var DropboxProvider = class {
+var DropboxProvider = class extends BaseProvider {
   constructor() {
+    super(...arguments);
     this.oauthHelper = new OAuthHelper();
-    this.apiHelper = new ApiHelper();
     this.id = "dropbox";
     this.name = "Dropbox";
     this.logos = {
@@ -1833,12 +1702,7 @@ var DropboxProvider = class {
       apiBase: "https://api.dropboxapi.com",
       oauthBase: "https://www.dropbox.com/oauth2",
       clientId: "9io0q0q9angdz9j",
-      scopes: [],
-      endpoints: {
-        listFolder: "/2/files/list_folder",
-        listFolderContinue: "/2/files/list_folder/continue",
-        getTemporaryLink: "/2/files/get_temporary_link"
-      }
+      scopes: []
     };
     this.requiresAuth = true;
     this.authTypes = ["oauth_pkce"];
@@ -1855,12 +1719,12 @@ var DropboxProvider = class {
       console.error("[Dropbox] No auth token provided");
       return Promise.resolve(null);
     }
-    return this.apiHelper.apiRequest(this.config, this.id, endpoint, auth, "POST", body);
+    return this.apiRequest(endpoint, auth, "POST", body);
   }
   async listAllEntries(dropboxPath, auth) {
     const allEntries = [];
     const response = await this.dropboxPost(
-      this.config.endpoints.listFolder,
+      "/2/files/list_folder",
       { path: dropboxPath, recursive: false, include_media_info: false },
       auth
     );
@@ -1871,7 +1735,7 @@ var DropboxProvider = class {
     let calls = 0;
     while (hasMore && calls < MAX_PAGINATION_CALLS) {
       const cont = await this.dropboxPost(
-        this.config.endpoints.listFolderContinue,
+        "/2/files/list_folder/continue",
         { cursor },
         auth
       );
@@ -1921,7 +1785,7 @@ var DropboxProvider = class {
   }
   async getTemporaryLink(filePath, auth) {
     const response = await this.dropboxPost(
-      this.config.endpoints.getTemporaryLink,
+      "/2/files/get_temporary_link",
       { path: filePath },
       auth
     );
@@ -1942,7 +1806,7 @@ var DropboxProvider = class {
   // -- Leaf detection --
   async checkIsLeaf(folderPath, auth) {
     const response = await this.dropboxPost(
-      this.config.endpoints.listFolder,
+      "/2/files/list_folder",
       { path: folderPath, recursive: false, include_media_info: false },
       auth
     );
@@ -1961,31 +1825,29 @@ var DropboxProvider = class {
     const fileItems = await this.resolveFileLinks(mediaFiles, auth);
     return [...folderItems, ...fileItems];
   }
-  async getPlaylist(path, auth, _resolution) {
+  /** Resolve a folder path to playable files (list + media filter + link resolution). */
+  async resolveMediaFiles(path, auth) {
     if (!path || path === "/") return null;
     const dropboxPath = path.startsWith("/") ? path : "/" + path;
     const allEntries = await this.listAllEntries(dropboxPath, auth);
     const { mediaFiles } = filterMediaEntries(allEntries);
     if (mediaFiles.length === 0) return null;
     const files = await this.resolveFileLinks(mediaFiles, auth);
-    return files.length > 0 ? files : null;
+    if (files.length === 0) return null;
+    return { files, dropboxPath };
+  }
+  async getPlaylist(path, auth, _resolution) {
+    const resolved = await this.resolveMediaFiles(path, auth);
+    return resolved?.files ?? null;
   }
   async getInstructions(path, auth) {
-    if (!path || path === "/") return null;
-    const dropboxPath = path.startsWith("/") ? path : "/" + path;
-    const allEntries = await this.listAllEntries(dropboxPath, auth);
-    const { mediaFiles } = filterMediaEntries(allEntries);
-    if (mediaFiles.length === 0) return null;
-    const files = await this.resolveFileLinks(mediaFiles, auth);
-    if (files.length === 0) return null;
-    const segments = dropboxPath.split("/").filter(Boolean);
+    const resolved = await this.resolveMediaFiles(path, auth);
+    if (!resolved) return null;
+    const segments = resolved.dropboxPath.split("/").filter(Boolean);
     const folderName = segments[segments.length - 1] || "Dropbox";
-    return buildInstructionsFromFiles(files, folderName);
+    return filesToInstructions(folderName, resolved.files, { id: "dropbox-section", label: folderName });
   }
   // -- Auth methods --
-  supportsDeviceFlow() {
-    return false;
-  }
   generateCodeVerifier() {
     return this.oauthHelper.generateCodeVerifier();
   }
@@ -2022,61 +1884,43 @@ var DropboxProvider = class {
         body: params.toString()
       });
       if (!response.ok) return null;
-      const data = await response.json();
-      return {
-        access_token: data.access_token,
-        refresh_token: data.refresh_token,
-        token_type: data.token_type || "Bearer",
-        created_at: Math.floor(Date.now() / 1e3),
-        expires_in: data.expires_in,
-        scope: data.scope || ""
-      };
+      return toAuthData(await response.json());
     } catch {
       return null;
     }
   }
 };
 
-// src/providers/planningCenter/PlanningCenterConverters.ts
-var apiHelper = new ApiHelper();
+// src/providers/planningCenter/PlanningCenterProvider.ts
+var ONE_WEEK_MS = 6048e5;
 function formatDate(dateString) {
-  const date = new Date(dateString);
-  return date.toISOString().slice(0, 10);
+  return new Date(dateString).toISOString().slice(0, 10);
 }
-
-// src/providers/planningCenter/PlanningCenterProvider.ts
-var PlanningCenterProvider = class {
+var PlanningCenterProvider = class extends BaseProvider {
   constructor() {
-    this.apiHelper = new ApiHelper();
+    super(...arguments);
     this.id = "planningcenter";
     this.name = "Planning Center";
     this.logos = { light: "https://www.planningcenter.com/icons/icon-512x512.png", dark: "https://www.planningcenter.com/icons/icon-512x512.png" };
-    this.config = { id: "planningcenter", name: "Planning Center", apiBase: "https://api.planningcenteronline.com", oauthBase: "https://api.planningcenteronline.com/oauth", clientId: "", scopes: ["services"], endpoints: { serviceTypes: "/services/v2/service_types", plans: (serviceTypeId) => `/services/v2/service_types/${serviceTypeId}/plans`, planItems: (serviceTypeId, planId) => `/services/v2/service_types/${serviceTypeId}/plans/${planId}/items`, song: (itemId) => `/services/v2/songs/${itemId}`, arrangement: (songId, arrangementId) => `/services/v2/songs/${songId}/arrangements/${arrangementId}`, arrangementSections: (songId, arrangementId) => `/services/v2/songs/${songId}/arrangements/${arrangementId}/sections`, media: (mediaId) => `/services/v2/media/${mediaId}`, mediaAttachments: (mediaId) => `/services/v2/media/${mediaId}/attachments` } };
-    this.ONE_WEEK_MS = 6048e5;
+    this.config = { id: "planningcenter", name: "Planning Center", apiBase: "https://api.planningcenteronline.com", oauthBase: "https://api.planningcenteronline.com/oauth", clientId: "", scopes: ["services"] };
     this.requiresAuth = true;
     this.authTypes = ["oauth_pkce"];
-    this.capabilities = { browse: true, playlist: true, instructions: true, mediaLicensing: false };
-  }
-  async apiRequest(path, auth) {
-    return this.apiHelper.apiRequest(this.config, this.id, path, auth);
+    // Plan items come back without media URLs, so playlist/instructions are not actually supported yet.
+    this.capabilities = { browse: true, playlist: false, instructions: false, mediaLicensing: false };
   }
   async browse(path, auth) {
     const { segments, depth } = parsePath(path);
     if (depth === 0) {
       return [{ type: "folder", id: "serviceTypes-root", title: "Service Types", path: "/serviceTypes" }];
     }
-    const root = segments[0];
-    if (root !== "serviceTypes") return [];
+    if (segments[0] !== "serviceTypes") return [];
     if (depth === 1) return this.getServiceTypes(auth);
     if (depth === 2) return this.getPlans(segments[1], path, auth);
     if (depth === 3) return this.getPlanItems(segments[1], segments[2], auth);
     return [];
   }
   async getServiceTypes(auth) {
-    const response = await this.apiRequest(
-      this.config.endpoints.serviceTypes,
-      auth
-    );
+    const response = await this.apiRequest("/services/v2/service_types", auth);
     if (!response?.data) return [];
     return response.data.map((serviceType) => ({
       type: "folder",
@@ -2086,9 +1930,8 @@ var PlanningCenterProvider = class {
     }));
   }
   async getPlans(serviceTypeId, currentPath, auth) {
-    const pathFn = this.config.endpoints.plans;
     const response = await this.apiRequest(
-      `${pathFn(serviceTypeId)}?filter=future&order=sort_date`,
+      `/services/v2/service_types/${serviceTypeId}/plans?filter=future&order=sort_date`,
       auth
     );
     if (!response?.data) return [];
@@ -2096,7 +1939,7 @@ var PlanningCenterProvider = class {
     const filteredPlans = response.data.filter((plan) => {
       if (plan.attributes.items_count === 0) return false;
       const planDate = new Date(plan.attributes.sort_date).getTime();
-      return planDate < now + this.ONE_WEEK_MS;
+      return planDate < now + ONE_WEEK_MS;
     });
     return filteredPlans.map((plan) => ({
       type: "folder",
@@ -2107,17 +1950,13 @@ var PlanningCenterProvider = class {
     }));
   }
   async getPlanItems(serviceTypeId, planId, auth) {
-    const pathFn = this.config.endpoints.planItems;
     const response = await this.apiRequest(
-      `${pathFn(serviceTypeId, planId)}?per_page=100`,
+      `/services/v2/service_types/${serviceTypeId}/plans/${planId}/items?per_page=100`,
       auth
     );
     if (!response?.data) return [];
     return response.data.map((item) => ({ type: "file", id: item.id, title: item.attributes.title || "", mediaType: "image", url: "" }));
   }
-  supportsDeviceFlow() {
-    return false;
-  }
 };
 
 // src/providers/bibleProject/data.json
@@ -4512,8 +4351,9 @@ var data_default = {
 };
 
 // src/providers/bibleProject/BibleProjectProvider.ts
-var BibleProjectProvider = class {
+var BibleProjectProvider = class extends BaseProvider {
   constructor() {
+    super(...arguments);
     this.id = "bibleproject";
     this.name = "The Bible Project";
     this.logos = {
@@ -4526,10 +4366,8 @@ var BibleProjectProvider = class {
       apiBase: "https://bibleproject.com",
       oauthBase: "",
       clientId: "",
-      scopes: [],
-      endpoints: { downloads: "/downloads/" }
+      scopes: []
     };
-    this.data = data_default;
     this.requiresAuth = false;
     this.authTypes = ["none"];
     this.capabilities = {
@@ -4538,133 +4376,71 @@ var BibleProjectProvider = class {
       instructions: true,
       mediaLicensing: false
     };
+    this.data = data_default;
   }
   getMuxThumbnail(muxPlaybackId, width = 400, height = 225) {
     return `https://image.mux.com/${muxPlaybackId}/thumbnail.jpg?width=${width}&height=${height}`;
   }
-  async browse(path, _auth) {
-    const { segments, depth } = parsePath(path);
-    if (depth === 0) {
-      return this.getCollections();
-    }
-    if (depth === 1) {
-      const collectionSlug = segments[0];
-      return this.getLessonFolders(collectionSlug, path);
-    }
-    if (depth === 2) {
-      const collectionSlug = segments[0];
-      const videoId = segments[1];
-      return this.getVideoFile(collectionSlug, videoId);
-    }
-    return [];
-  }
-  getCollections() {
-    return this.data.collections.filter((collection) => collection.videos.length > 0).map((collection) => ({
-      type: "folder",
-      id: slugify(collection.name),
-      title: collection.name,
-      thumbnail: collection.image || void 0,
-      path: `/${slugify(collection.name)}`
-    }));
-  }
-  getLessonFolders(collectionSlug, currentPath) {
-    const collection = this.data.collections.find((c) => slugify(c.name) === collectionSlug);
-    if (!collection) return [];
-    return collection.videos.map((video) => ({
-      type: "folder",
-      id: video.id,
-      title: video.title,
+  videoToFile(video) {
+    return createFile(video.id, video.title, video.videoUrl, {
+      mediaType: "video",
       thumbnail: this.getMuxThumbnail(video.muxPlaybackId),
-      isLeaf: true,
-      path: `${currentPath}/${video.id}`
-    }));
-  }
-  getVideoFile(collectionSlug, videoId) {
-    const collection = this.data.collections.find((c) => slugify(c.name) === collectionSlug);
-    if (!collection) return [];
-    const video = collection.videos.find((v) => v.id === videoId);
-    if (!video) return [];
-    return [createFile(video.id, video.title, video.videoUrl, { mediaType: "video", muxPlaybackId: video.muxPlaybackId, seconds: 0 })];
+      muxPlaybackId: video.muxPlaybackId,
+      seconds: 0
+    });
   }
-  async getPlaylist(path, _auth, _resolution) {
+  /** Resolve a path to its collection and files: all videos at depth 1, a single video at depth 2. */
+  resolve(path) {
     const { segments, depth } = parsePath(path);
-    if (depth < 1) return null;
-    const collectionSlug = segments[0];
-    const collection = this.data.collections.find((c) => slugify(c.name) === collectionSlug);
+    if (depth < 1 || depth > 2) return null;
+    const collection = this.data.collections.find((c) => slugify(c.name) === segments[0]);
     if (!collection) return null;
     if (depth === 1) {
-      const files = collection.videos.map((video) => ({ type: "file", id: video.id, title: video.title, mediaType: "video", url: video.videoUrl, thumbnail: this.getMuxThumbnail(video.muxPlaybackId), muxPlaybackId: video.muxPlaybackId, seconds: 0 }));
-      return files.length > 0 ? files : null;
+      return { collection, files: collection.videos.map((v) => this.videoToFile(v)), name: collection.name };
     }
-    if (depth === 2) {
-      const videoId = segments[1];
-      const video = collection.videos.find((v) => v.id === videoId);
-      if (!video) return null;
-      return [{ type: "file", id: video.id, title: video.title, mediaType: "video", url: video.videoUrl, thumbnail: this.getMuxThumbnail(video.muxPlaybackId), muxPlaybackId: video.muxPlaybackId, seconds: 0 }];
-    }
-    return null;
+    const video = collection.videos.find((v) => v.id === segments[1]);
+    if (!video) return null;
+    return { collection, files: [this.videoToFile(video)], name: video.title };
   }
-  async getInstructions(path, _auth) {
+  async browse(path, _auth) {
     const { segments, depth } = parsePath(path);
-    if (depth < 1) return null;
-    const collectionSlug = segments[0];
-    const collection = this.data.collections.find((c) => slugify(c.name) === collectionSlug);
-    if (!collection) return null;
+    if (depth === 0) {
+      return this.data.collections.filter((collection) => collection.videos.length > 0).map((collection) => ({
+        type: "folder",
+        id: slugify(collection.name),
+        title: collection.name,
+        thumbnail: collection.image || void 0,
+        path: `/${slugify(collection.name)}`
+      }));
+    }
     if (depth === 1) {
-      const actionItems = collection.videos.map((video) => ({
-        id: video.id + "-action",
-        itemType: "action",
-        label: video.title,
-        actionType: "play",
-        children: [
-          {
-            id: video.id,
-            itemType: "file",
-            label: video.title,
-            downloadUrl: video.videoUrl,
-            thumbnail: this.getMuxThumbnail(video.muxPlaybackId)
-          }
-        ]
+      const collection = this.data.collections.find((c) => slugify(c.name) === segments[0]);
+      if (!collection) return [];
+      return collection.videos.map((video) => ({
+        type: "folder",
+        id: video.id,
+        title: video.title,
+        thumbnail: this.getMuxThumbnail(video.muxPlaybackId),
+        isLeaf: true,
+        path: `${path}/${video.id}`
       }));
-      const sectionItem = {
-        id: slugify(collection.name) + "-section",
-        itemType: "section",
-        label: collection.name,
-        children: actionItems
-      };
-      return { name: collection.name, items: [sectionItem] };
     }
     if (depth === 2) {
-      const videoId = segments[1];
-      const video = collection.videos.find((v) => v.id === videoId);
-      if (!video) return null;
-      const actionItem = {
-        id: video.id + "-action",
-        itemType: "action",
-        label: video.title,
-        actionType: "play",
-        children: [
-          {
-            id: video.id,
-            itemType: "file",
-            label: video.title,
-            downloadUrl: video.videoUrl,
-            thumbnail: this.getMuxThumbnail(video.muxPlaybackId)
-          }
-        ]
-      };
-      const sectionItem = {
-        id: slugify(collection.name) + "-section",
-        itemType: "section",
-        label: collection.name,
-        children: [actionItem]
-      };
-      return { name: video.title, items: [sectionItem] };
+      return this.resolve(path)?.files ?? [];
     }
-    return null;
+    return [];
   }
-  supportsDeviceFlow() {
-    return false;
+  async getPlaylist(path, _auth, _resolution) {
+    const resolved = this.resolve(path);
+    return resolved && resolved.files.length > 0 ? resolved.files : null;
+  }
+  async getInstructions(path, _auth) {
+    const resolved = this.resolve(path);
+    if (!resolved) return null;
+    return filesToInstructions(resolved.name, resolved.files, {
+      id: slugify(resolved.collection.name) + "-section",
+      label: resolved.collection.name
+    });
   }
 };
 
@@ -12288,8 +12064,9 @@ function buildLessonInstructions(lesson) {
 }
 
 // src/providers/highVoltage/HighVoltageKidsProvider.ts
-var HighVoltageKidsProvider = class {
+var HighVoltageKidsProvider = class extends BaseProvider {
   constructor() {
+    super(...arguments);
     this.id = "highvoltagekids";
     this.name = "High Voltage Kids";
     this.logos = {
@@ -12302,8 +12079,7 @@ var HighVoltageKidsProvider = class {
       apiBase: "https://highvoltagekids.com",
       oauthBase: "",
       clientId: "",
-      scopes: [],
-      endpoints: { downloads: "/membership-downloads/" }
+      scopes: []
     };
     this.data = data_default2;
     this.requiresAuth = false;
@@ -12353,9 +12129,6 @@ var HighVoltageKidsProvider = class {
     }
     return null;
   }
-  supportsDeviceFlow() {
-    return false;
-  }
 };
 
 // src/providers/jesusFilm/JesusFilmProvider.ts
@@ -12367,8 +12140,14 @@ var CATEGORY_MAP = {
   "series": "series",
   "collections": "collection"
 };
-var JesusFilmProvider = class {
+var CATEGORY_NAMES = {
+  "feature-films": "Feature Films",
+  "series": "Series",
+  "collections": "Collections"
+};
+var JesusFilmProvider = class extends BaseProvider {
   constructor() {
+    super(...arguments);
     this.id = "jesusfilm";
     this.name = "Jesus Film Project";
     this.logos = {
@@ -12381,8 +12160,7 @@ var JesusFilmProvider = class {
       apiBase: API_BASE4,
       oauthBase: "",
       clientId: "",
-      scopes: [],
-      endpoints: { watch: "/watch" }
+      scopes: []
     };
     this.requiresAuth = false;
     this.authTypes = ["none"];
@@ -12393,6 +12171,7 @@ var JesusFilmProvider = class {
       mediaLicensing: false
     };
   }
+  // Not ApiHelper: Arclight needs the apiKey query param and callers rely on throw-on-error.
   async fetchApi(path) {
     const separator = path.includes("?") ? "&" : "?";
     const url = `${API_BASE4}${path}${separator}apiKey=${API_KEY}`;
@@ -12400,6 +12179,12 @@ var JesusFilmProvider = class {
     if (!response.ok) throw new Error(`Arclight API error: ${response.status}`);
     return response.json();
   }
+  async fetchCategoryComponents(subType) {
+    const data = await this.fetchApi(
+      `/media-components?filter=master&subTypes=${subType}&languageIds=${LANGUAGE_ID}&limit=100`
+    );
+    return data._embedded.mediaComponents;
+  }
   async browse(path, _auth) {
     const { segments, depth } = parsePath(path);
     if (depth === 0) return this.getCategories();
@@ -12422,19 +12207,14 @@ var JesusFilmProvider = class {
   async getItemsInCategory(category) {
     const subType = CATEGORY_MAP[category];
     if (!subType) return [];
-    const data = await this.fetchApi(
-      `/media-components?filter=master&subTypes=${subType}&languageIds=${LANGUAGE_ID}&limit=100`
-    );
-    return data._embedded.mediaComponents.map((item) => {
-      const isLeaf = item.containsCount === 0;
-      return createFolder(
-        item.mediaComponentId,
-        item.title,
-        `/${category}/${item.mediaComponentId}`,
-        item.imageUrls.mobileCinematicHigh || item.imageUrls.videoStill || item.imageUrls.thumbnail,
-        isLeaf
-      );
-    });
+    const components = await this.fetchCategoryComponents(subType);
+    return components.map((item) => createFolder(
+      item.mediaComponentId,
+      item.title,
+      `/${category}/${item.mediaComponentId}`,
+      item.imageUrls.mobileCinematicHigh || item.imageUrls.videoStill || item.imageUrls.thumbnail,
+      item.containsCount === 0
+    ));
   }
   async getVideoFile(mediaComponentId) {
     const variant = await this.fetchApi(
@@ -12449,11 +12229,10 @@ var JesusFilmProvider = class {
     const title = component?.title || mediaComponentId;
     const seconds = component ? Math.round(component.lengthInMilliseconds / 1e3) : 0;
     const thumbnail = component?.imageUrls.mobileCinematicHigh || component?.imageUrls.videoStill;
-    const muxPlaybackId = this.extractMuxPlaybackId(downloadUrl);
     return [
       createFile(mediaComponentId, title, downloadUrl, {
         mediaType: "video",
-        muxPlaybackId,
+        muxPlaybackId: this.extractMuxPlaybackId(downloadUrl),
         seconds,
         thumbnail
       })
@@ -12465,9 +12244,8 @@ var JesusFilmProvider = class {
     );
     const childIds = linksData.linkedMediaComponentIds?.contains;
     if (!childIds || childIds.length === 0) return [];
-    const idsParam = childIds.join(",");
     const childrenData = await this.fetchApi(
-      `/media-components?ids=${idsParam}&languageIds=${LANGUAGE_ID}`
+      `/media-components?ids=${childIds.join(",")}&languageIds=${LANGUAGE_ID}`
     );
     if (!childrenData._embedded?.mediaComponents) return [];
     return childrenData._embedded.mediaComponents.map((item) => createFolder(
@@ -12482,36 +12260,6 @@ var JesusFilmProvider = class {
     const match = url.match(/stream\.mux\.com\/([^/]+)/);
     return match ? match[1] : void 0;
   }
-  async getPlaylist(path, _auth, _resolution) {
-    const { segments, depth } = parsePath(path);
-    if (depth < 1) return null;
-    const category = segments[0];
-    if (depth >= 3) {
-      const lastId = segments[depth - 1];
-      const items = await this.getVideoFile(lastId);
-      const files2 = items.filter((item) => item.type === "file");
-      if (files2.length > 0) return files2;
-      const containerFiles = await this.fetchContainerVideoFiles(lastId);
-      return containerFiles.length > 0 ? containerFiles : null;
-    }
-    if (depth === 2) {
-      if (category === "feature-films") {
-        const items = await this.getVideoFile(segments[1]);
-        if (items.length === 0) return null;
-        return items.filter((item) => item.type === "file");
-      }
-      const files2 = await this.fetchContainerVideoFiles(segments[1]);
-      return files2.length > 0 ? files2 : null;
-    }
-    const subType = CATEGORY_MAP[category];
-    if (!subType) return null;
-    const data = await this.fetchApi(
-      `/media-components?filter=master&subTypes=${subType}&languageIds=${LANGUAGE_ID}&limit=100`
-    );
-    const contentComponents = data._embedded.mediaComponents.filter((item) => item.containsCount === 0);
-    const files = await this.fetchVideoFiles(contentComponents);
-    return files.length > 0 ? files : null;
-  }
   async fetchVideoFiles(components) {
     const files = [];
     for (const component of components) {
@@ -12542,9 +12290,8 @@ var JesusFilmProvider = class {
     );
     const childIds = linksData.linkedMediaComponentIds?.contains;
     if (!childIds || childIds.length === 0) return [];
-    const idsParam = childIds.join(",");
     const childrenData = await this.fetchApi(
-      `/media-components?ids=${idsParam}&languageIds=${LANGUAGE_ID}`
+      `/media-components?ids=${childIds.join(",")}&languageIds=${LANGUAGE_ID}`
     );
     if (!childrenData._embedded?.mediaComponents) return [];
     const contentItems = childrenData._embedded.mediaComponents.filter((c) => c.containsCount === 0);
@@ -12556,64 +12303,47 @@ var JesusFilmProvider = class {
     }
     return files;
   }
+  async getPlaylist(path, _auth, _resolution) {
+    const { segments, depth } = parsePath(path);
+    if (depth < 1) return null;
+    const category = segments[0];
+    if (depth >= 3) {
+      const lastId = segments[depth - 1];
+      const items = await this.getVideoFile(lastId);
+      const files2 = items.filter((item) => item.type === "file");
+      if (files2.length > 0) return files2;
+      const containerFiles = await this.fetchContainerVideoFiles(lastId);
+      return containerFiles.length > 0 ? containerFiles : null;
+    }
+    if (depth === 2) {
+      if (category === "feature-films") {
+        const items = await this.getVideoFile(segments[1]);
+        if (items.length === 0) return null;
+        return items.filter((item) => item.type === "file");
+      }
+      const files2 = await this.fetchContainerVideoFiles(segments[1]);
+      return files2.length > 0 ? files2 : null;
+    }
+    const subType = CATEGORY_MAP[category];
+    if (!subType) return null;
+    const components = await this.fetchCategoryComponents(subType);
+    const files = await this.fetchVideoFiles(components.filter((item) => item.containsCount === 0));
+    return files.length > 0 ? files : null;
+  }
   async buildVideoInstructions(mediaComponentId, category) {
     const items = await this.getVideoFile(mediaComponentId);
-    if (items.length === 0) return null;
-    const file = items[0];
-    if (file.type !== "file") return null;
-    const actionItem = {
-      id: mediaComponentId + "-action",
-      itemType: "action",
-      label: file.title,
-      actionType: "play",
-      children: [
-        {
-          id: mediaComponentId,
-          itemType: "file",
-          label: file.title,
-          downloadUrl: file.url,
-          thumbnail: file.thumbnail
-        }
-      ]
-    };
-    const sectionItem = {
-      id: category + "-section",
-      itemType: "section",
-      label: file.title,
-      children: [actionItem]
-    };
-    return { name: file.title, items: [sectionItem] };
+    const file = items.find((item) => item.type === "file");
+    if (!file) return null;
+    return filesToInstructions(file.title, [file], { id: category + "-section", label: file.title });
   }
-  async buildContainerInstructions(containerId, category) {
+  async buildContainerInstructions(containerId) {
     const containerData = await this.fetchApi(
       `/media-components?ids=${containerId}&languageIds=${LANGUAGE_ID}`
     );
-    const container = containerData._embedded?.mediaComponents?.[0];
-    const containerName = container?.title || containerId;
+    const containerName = containerData._embedded?.mediaComponents?.[0]?.title || containerId;
     const videoFiles = await this.fetchContainerVideoFiles(containerId);
     if (videoFiles.length === 0) return { name: containerName, items: [] };
-    const actionItems = videoFiles.map((file) => ({
-      id: file.id + "-action",
-      itemType: "action",
-      label: file.title,
-      actionType: "play",
-      children: [
-        {
-          id: file.id,
-          itemType: "file",
-          label: file.title,
-          downloadUrl: file.url,
-          thumbnail: file.thumbnail
-        }
-      ]
-    }));
-    const sectionItem = {
-      id: containerId + "-section",
-      itemType: "section",
-      label: containerName,
-      children: actionItems
-    };
-    return { name: containerName, items: [sectionItem] };
+    return filesToInstructions(containerName, videoFiles, { id: containerId + "-section", label: containerName });
   }
   async getInstructions(path, _auth) {
     const { segments, depth } = parsePath(path);
@@ -12622,61 +12352,19 @@ var JesusFilmProvider = class {
     const subType = CATEGORY_MAP[category];
     if (!subType) return null;
     if (depth === 1) {
-      const data = await this.fetchApi(
-        `/media-components?filter=master&subTypes=${subType}&languageIds=${LANGUAGE_ID}&limit=100`
-      );
-      const categoryName = category === "feature-films" ? "Feature Films" : category === "series" ? "Series" : "Collections";
-      const actionItems = await Promise.all(
-        data._embedded.mediaComponents.map(async (component) => {
-          let downloadUrl;
-          if (component.containsCount === 0) {
-            try {
-              const variant = await this.fetchApi(
-                `/media-components/${component.mediaComponentId}/languages/${LANGUAGE_ID}?platform=web`
-              );
-              downloadUrl = variant.downloadUrls.high?.url || variant.downloadUrls.low?.url;
-            } catch {
-            }
-          }
-          return {
-            id: component.mediaComponentId + "-action",
-            itemType: "action",
-            label: component.title,
-            actionType: "play",
-            children: downloadUrl ? [
-              {
-                id: component.mediaComponentId,
-                itemType: "file",
-                label: component.title,
-                downloadUrl,
-                thumbnail: component.imageUrls.mobileCinematicHigh || component.imageUrls.videoStill
-              }
-            ] : []
-          };
-        })
-      );
-      const sectionItem = {
-        id: category + "-section",
-        itemType: "section",
-        label: categoryName,
-        children: actionItems.filter((a) => a.children && a.children.length > 0)
-      };
-      return { name: categoryName, items: [sectionItem] };
+      const categoryName = CATEGORY_NAMES[category];
+      const components = await this.fetchCategoryComponents(subType);
+      const files = await this.fetchVideoFiles(components.filter((c) => c.containsCount === 0));
+      return filesToInstructions(categoryName, files, { id: category + "-section", label: categoryName });
     }
     if (depth === 2) {
       if (category === "feature-films") return this.buildVideoInstructions(segments[1], category);
-      return this.buildContainerInstructions(segments[1], category);
-    }
-    if (depth >= 3) {
-      const lastId = segments[depth - 1];
-      const videoResult = await this.buildVideoInstructions(lastId, category);
-      if (videoResult) return videoResult;
-      return this.buildContainerInstructions(lastId, category);
+      return this.buildContainerInstructions(segments[1]);
     }
-    return null;
-  }
-  supportsDeviceFlow() {
-    return false;
+    const lastId = segments[depth - 1];
+    const videoResult = await this.buildVideoInstructions(lastId, category);
+    if (videoResult) return videoResult;
+    return this.buildContainerInstructions(lastId);
   }
 };
 
@@ -12720,35 +12408,15 @@ function convertPlaylistToFiles(playlist) {
     return file;
   });
 }
-function convertPlaylistToInstructions(playlist) {
-  const files = convertPlaylistToFiles(playlist);
-  const items = files.map((file) => ({
-    id: file.id + "-action",
-    itemType: "action",
-    label: file.title,
-    actionType: "play",
-    children: [
-      {
-        id: file.id,
-        itemType: "file",
-        label: file.title,
-        seconds: file.seconds,
-        downloadUrl: file.url,
-        thumbnail: file.thumbnail
-      }
-    ]
-  }));
-  return { name: playlist.lesson_title || "Lesson", items };
-}
 
 // src/providers/cbn/logo.ts
 var CBN_LOGO = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZAAAAGQCAMAAAC3Ycb+AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAA/tpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDcuMi1jMDAwIDc5LjFiNjVhNzliNCwgMjAyMi8wNi8xMy0yMjowMTowMSAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wTU09Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9tbS8iIHhtbG5zOnN0UmVmPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VSZWYjIiB4bWxuczp4bXA9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8iIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyIgeG1wTU06T3JpZ2luYWxEb2N1bWVudElEPSJ1dWlkOjVEMjA4OTI0OTNCRkRCMTE5MTRBODU5MEQzMTUwOEM4IiB4bXBNTTpEb2N1bWVudElEPSJ4bXAuZGlkOjczNTFDMjdFNENEMDExRURCNUVBQkI4RUVDOUM5MkUwIiB4bXBNTTpJbnN0YW5jZUlEPSJ4bXAuaWlkOjczNTFDMjdENENEMDExRURCNUVBQkI4RUVDOUM5MkUwIiB4bXA6Q3JlYXRvclRvb2w9IkFkb2JlIElsbHVzdHJhdG9yIENDIDIwMTcgKE1hY2ludG9zaCkiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0idXVpZDo4NGJiYzc1OC1iNjBhLTFlNGQtODJlMS1mYTQyNzhlMmZhMTciIHN0UmVmOmRvY3VtZW50SUQ9InhtcC5kaWQ6OTQzMjNlNWMtYjBlMS00YTliLWJjZWUtODljYjRlOGVjZjAwIi8+IDxkYzp0aXRsZT4gPHJkZjpBbHQ+IDxyZGY6bGkgeG1sOmxhbmc9IngtZGVmYXVsdCI+Q0JOLUZMQU1FPC9yZGY6bGk+IDwvcmRmOkFsdD4gPC9kYzp0aXRsZT4gPC9yZGY6RGVzY3JpcHRpb24+IDwvcmRmOlJERj4gPC94OnhtcG1ldGE+IDw/eHBhY2tldCBlbmQ9InIiPz40pvOUAAAC2VBMVEUdmtYhnNf8/v/7/f4emtb9/v8fm9by+f0nntjU7Pf6/f4gm9b2+/0lntfk8/q43/L3+/5Nr9/5/P4poNg1pdovotnj8voknddQsd84ptsqoNjp9fve8PnX7fgpn9hRsd/1+/3M6Pba7vhmuuO/4vMinNfG5vUtodmGyenm9Pq64PKOzOrz+f2c0+15w+fw+PyVz+zx+fyq2fCl1+9tvuREq91ateGx3PHv+Pz4/P6d0+0mnthxwOXf8fng8fkroNlhuOI3pduk1u7B4/Ts9/zq9ftAqdxHrd54w+ft9/yu2/CKy+pOsN88qNxft+I+qdy74fNIrd7n9PtDq93z+v1Ws+BrveTS6/eW0OxCq91/xuiz3fFvvuXN6fYzpNqZ0e2Ly+oxo9q94fO94vPc7/nF5fSn2O/o9ft2wuYwotk2pdtVs+Du9/ySzutqvOQjnddPsN8uotl3wubY7vjC5PSEyOl1weZpvORSsuBctuHl9Po5p9vT6/eMzOo7p9uBx+iv2/GTz+vh8vq03fFguOLs9vvV7Pe23/JXtOBkuuMon9i+4vOQzetfuOKg1e6Jyurr9vvi8vp+xuhnu+Op2e/R6vf0+v3c8Pnb7/h+xehLr946p9ssodmj1u40pNqUz+zd8PlJrt57xOdXtOFdt+Kw3PFAqtxbtuG33/J8xOd6xOet2vDI5vW54PJwv+VBqt1FrN2a0u1luuOAxuhsveSh1e6s2vCNzOqt2/Ci1e7E5PTJ5/XH5vXL6PY9qNx0weZ9xedYteHK5/WFyOmCx+hnu+TQ6vZovOS13vLD5PSb0u1Mr9/O6fay3fG84fPZ7vhiueNKrt5zwObP6vZZteFjueOm1+9TsuCf1O6o2O+DyOhUs+DF5fWPzeuX0ezW7fhGrN0wo9qOzetet+IypNqr2fC13vGY0exvv+WRzuue1O2IyumHyulywOVuvuU/qdye0+3A4/T///96A0GMAAAA83RSTlP//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////wB12P98AAAWOklEQVR42uzd5YMUx9YG8JpZN3ZZdHFblg3u7u7uGtzdITgkwUJCsBCc4CRA8BASEgJxtxtPbpKrr52/4EUvK3VqWk5V9+ye5+vOdE3Xb2e6u1QAx1cRXAUMwmEQBuEwCINwGIRBOAzCIBwG4TAIg3AYhEE4DMIgHAZhEA6DcBiEQTgMwiAcBmEQDoMwCIdBOAzCIBwGYRAOgzAIh0EYhMMgHAZhEA6DMAiHQRiEwyAMwmEQDoMwCIdBsmdfcwbxVeLWt2EQX2WT2BrDID7KcCGWDWQQH2WKEOnjGcQ/eU/cyZAgg/gm9e+KfFmTQfyS8XdBRM/9DOKTpBS5J1KkPIP4JFXugYikxxjEH1kVeV8k+iKD+COHxYM0YRBf5PRDEFGLQfyQ4F7/i+Sv5vd/C9+L5C+Q/Y9AxE8M4oOUzSJyhUG8z1+ygIgVDOJ5+jXNAhJoyyCeZ0DWr0jsLQbxOqOzgohfizKIx4kokk1kcAyDeJwT2UDE0SCDeJvy2UHEmwzicdJyiFxkEG8zJAdIsYEM4ml+yAEi0qYyiKf3WS/mFNnEIJ7mXE4QMZJBvMzIXCCBWwziYT7MBSKWVWMQDy8igdwiExnEwwzODSJGM4h3eUcCMmIqg3iWJyQgoh6DeJY2MhCxgUG8ymkpSFoig3iU4VIQ8TaDeJSf5SAJcQziTYrKQcQ3DOIvELGaQfwFsqQxg3iRChiIWMkgXmQgChLbjkE8yHsoiBjCIB7kJA5SLJNBzGcfDiI6MYj5dFKABJoziPFMUYCI+QxiPBkqkEBJBjGckkKZ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";
 
 // src/providers/cbn/CbnProvider.ts
 var API_BASE5 = "https://sbamemberdev.wpenginepowered.com/wp-json/superbook/v1";
-var CbnProvider = class {
+var CbnProvider = class extends BaseProvider {
   constructor() {
-    this.apiHelper = new ApiHelper();
+    super(...arguments);
     this.deviceFlowHelper = new DeviceFlowHelper();
     this.id = "cbn";
     this.name = "CBN";
@@ -12761,66 +12429,48 @@ var CbnProvider = class {
       clientId: "freeplay",
       scopes: [],
       supportsDeviceFlow: true,
-      deviceAuthEndpoint: "/device",
-      endpoints: {
-        catalog: "/catalog",
-        courseDetail: (courseId) => `/catalog/${courseId}`,
-        lessonPlaylist: (lessonId) => `/lesson-playlist/${lessonId}`
-      }
+      deviceAuthEndpoint: "/device"
     };
     this.requiresAuth = true;
     this.authTypes = ["device_flow"];
     this.capabilities = { browse: true, playlist: true, instructions: true, mediaLicensing: false };
   }
-  async apiRequest(path, auth) {
-    return this.apiHelper.apiRequest(this.config, this.id, path, auth);
-  }
   async browse(path, auth) {
     const { segments, depth } = parsePath(path);
     if (depth === 0) {
       return [{ type: "folder", id: "catalog-root", title: "Catalog", path: "/catalog" }];
     }
     if (segments[0] !== "catalog") return [];
-    if (depth === 1) return this.getCourses(auth);
-    if (depth === 2) return this.getLessons(segments[1], path, auth);
-    if (depth === 3) return this.getVideos(segments[2], auth);
+    if (depth === 1) {
+      const response = await this.apiRequest("/catalog", auth);
+      return Array.isArray(response) ? convertCoursesToFolders(response) : [];
+    }
+    if (depth === 2) {
+      const response = await this.apiRequest(`/catalog/${segments[1]}`, auth);
+      return response?.lessons ? convertLessonsToFolders(response.lessons, path) : [];
+    }
+    if (depth === 3) {
+      const resolved = await this.resolveFiles(path, auth);
+      return resolved?.files ?? [];
+    }
     return [];
   }
-  async getCourses(auth) {
-    const response = await this.apiRequest(this.config.endpoints.catalog, auth);
-    if (!Array.isArray(response)) return [];
-    return convertCoursesToFolders(response);
-  }
-  async getLessons(courseId, coursePath, auth) {
-    const pathFn = this.config.endpoints.courseDetail;
-    const response = await this.apiRequest(pathFn(courseId), auth);
-    if (!response?.lessons) return [];
-    return convertLessonsToFolders(response.lessons, coursePath);
-  }
-  async getVideos(lessonId, auth) {
-    const playlist = await this.fetchPlaylist(lessonId, auth);
-    return playlist ? convertPlaylistToFiles(playlist) : [];
-  }
-  async fetchPlaylist(lessonId, auth) {
-    const pathFn = this.config.endpoints.lessonPlaylist;
-    return this.apiRequest(pathFn(lessonId), auth);
-  }
-  async getPlaylist(path, auth, _resolution) {
+  /** Resolve a leaf path (/catalog/{courseId}/{lessonId}) to its playlist files. */
+  async resolveFiles(path, auth) {
     const { segments, depth } = parsePath(path);
     if (depth !== 3 || segments[0] !== "catalog") return null;
-    const playlist = await this.fetchPlaylist(segments[2], auth);
+    const playlist = await this.apiRequest(`/lesson-playlist/${segments[2]}`, auth);
     if (!playlist || playlist.playlist.length === 0) return null;
-    return convertPlaylistToFiles(playlist);
+    return { files: convertPlaylistToFiles(playlist), lessonTitle: playlist.lesson_title };
   }
-  async getInstructions(path, auth) {
-    const { segments, depth } = parsePath(path);
-    if (depth !== 3 || segments[0] !== "catalog") return null;
-    const playlist = await this.fetchPlaylist(segments[2], auth);
-    if (!playlist || playlist.playlist.length === 0) return null;
-    return convertPlaylistToInstructions(playlist);
+  async getPlaylist(path, auth, _resolution) {
+    const resolved = await this.resolveFiles(path, auth);
+    return resolved?.files ?? null;
   }
-  supportsDeviceFlow() {
-    return this.deviceFlowHelper.supportsDeviceFlow(this.config);
+  async getInstructions(path, auth) {
+    const resolved = await this.resolveFiles(path, auth);
+    if (!resolved) return null;
+    return filesToInstructions(resolved.lessonTitle || "Lesson", resolved.files);
   }
   async initiateDeviceFlow() {
     return this.deviceFlowHelper.initiateDeviceFlow(this.config);
@@ -16451,8 +16101,9 @@ var data_default3 = {
 };
 
 // src/providers/lifeChurch/LifeChurchProvider.ts
-var LifeChurchProvider = class {
+var LifeChurchProvider = class extends BaseProvider {
   constructor() {
+    super(...arguments);
     this.id = "lifechurch";
     this.name = "Life.Church";
     this.logos = {
@@ -16465,8 +16116,7 @@ var LifeChurchProvider = class {
       apiBase: "https://www.life.church",
       oauthBase: "",
       clientId: "",
-      scopes: [],
-      endpoints: {}
+      scopes: []
     };
     this.requiresAuth = false;
     this.authTypes = ["none"];
@@ -16481,20 +16131,14 @@ var LifeChurchProvider = class {
   findSeries(seriesId) {
     return this.data.series.find((s) => s.id === seriesId);
   }
-  findUnit(series, unitId) {
-    return series.units.find((u) => u.id === unitId);
-  }
-  findLesson(unit, lessonId) {
-    return unit.lessons.find((l) => l.id === lessonId);
-  }
   findScheduled(scheduledId) {
     return this.data.scheduledLessons?.find((s) => s.id === scheduledId);
   }
   /** Resolve a scheduled-lesson reference to the underlying lesson + unit + series. */
   resolveScheduled(sched) {
     const series = this.findSeries(sched.seriesId);
-    const unit = series && this.findUnit(series, sched.unitId);
-    const lesson = unit && this.findLesson(unit, sched.lessonId);
+    const unit = series?.units.find((u) => u.id === sched.unitId);
+    const lesson = unit?.lessons.find((l) => l.id === sched.lessonId);
     if (!series || !unit || !lesson) return null;
     return { series, unit, lesson };
   }
@@ -16509,17 +16153,40 @@ var LifeChurchProvider = class {
       providerData: { sourceUrl: lesson.sourceUrl }
     };
   }
+  /** Resolve a leaf-or-unit path to its files plus the name/section used for instructions. */
+  resolve(path) {
+    const { segments, depth } = parsePath(path);
+    if (segments[0] === "scheduled") {
+      if (depth !== 2) return null;
+      const sched = this.findScheduled(segments[1]);
+      const resolved = sched && this.resolveScheduled(sched);
+      if (!sched || !resolved) return null;
+      const label = `${sched.ageGroup} \u2014 ${resolved.lesson.title}`;
+      return {
+        files: [this.lessonToFile(resolved.lesson, label)],
+        name: label,
+        section: { id: `scheduled-${sched.id}-section`, label: "This Sunday" }
+      };
+    }
+    const series = this.findSeries(segments[0]);
+    const unit = series?.units.find((u) => u.id === segments[1]);
+    if (!unit) return null;
+    if (depth === 2) {
+      return { files: unit.lessons.map((l) => this.lessonToFile(l)), name: unit.name, section: { id: `${unit.id}-section`, label: unit.name } };
+    }
+    if (depth === 3) {
+      const lesson = unit.lessons.find((l) => l.id === segments[2]);
+      if (!lesson) return null;
+      return { files: [this.lessonToFile(lesson)], name: lesson.title, section: { id: `${unit.id}-section`, label: unit.name } };
+    }
+    return null;
+  }
   async browse(path, _auth) {
     const { segments, depth } = parsePath(path);
     if (depth === 0) {
       const items = [];
       if (this.data.scheduledLessons && this.data.scheduledLessons.length > 0) {
-        items.push({
-          type: "folder",
-          id: "scheduled",
-          title: "This Sunday",
-          path: "/scheduled"
-        });
+        items.push({ type: "folder", id: "scheduled", title: "This Sunday", path: "/scheduled" });
       }
       for (const s of this.data.series) {
         items.push({ type: "folder", id: s.id, title: s.name, thumbnail: s.thumbnail, path: `/${s.id}` });
@@ -16540,13 +16207,7 @@ var LifeChurchProvider = class {
           };
         });
       }
-      if (depth === 2) {
-        const sched = this.findScheduled(segments[1]);
-        const resolved = sched && this.resolveScheduled(sched);
-        if (!sched || !resolved) return [];
-        return [this.lessonToFile(resolved.lesson, `${sched.ageGroup} \u2014 ${resolved.lesson.title}`)];
-      }
-      return [];
+      return this.resolve(path)?.files ?? [];
     }
     if (depth === 1) {
       const series = this.findSeries(segments[0]);
@@ -16561,8 +16222,8 @@ var LifeChurchProvider = class {
     }
     if (depth === 2) {
       const series = this.findSeries(segments[0]);
-      const unit = series && this.findUnit(series, segments[1]);
-      if (!series || !unit) return [];
+      const unit = series?.units.find((u) => u.id === segments[1]);
+      if (!unit) return [];
       return unit.lessons.map((l) => ({
         type: "folder",
         id: l.id,
@@ -16573,78 +16234,18 @@ var LifeChurchProvider = class {
       }));
     }
     if (depth === 3) {
-      const series = this.findSeries(segments[0]);
-      const unit = series && this.findUnit(series, segments[1]);
-      const lesson = unit && this.findLesson(unit, segments[2]);
-      if (!lesson) return [];
-      return [this.lessonToFile(lesson)];
+      return this.resolve(path)?.files ?? [];
     }
     return [];
   }
   async getPlaylist(path, _auth, _resolution) {
-    const { segments, depth } = parsePath(path);
-    if (segments[0] === "scheduled" && depth === 2) {
-      const sched = this.findScheduled(segments[1]);
-      const resolved = sched && this.resolveScheduled(sched);
-      return resolved ? [this.lessonToFile(resolved.lesson, `${sched.ageGroup} \u2014 ${resolved.lesson.title}`)] : null;
-    }
-    if (depth === 3) {
-      const series = this.findSeries(segments[0]);
-      const unit = series && this.findUnit(series, segments[1]);
-      const lesson = unit && this.findLesson(unit, segments[2]);
-      return lesson ? [this.lessonToFile(lesson)] : null;
-    }
-    if (depth === 2 && segments[0] !== "scheduled") {
-      const series = this.findSeries(segments[0]);
-      const unit = series && this.findUnit(series, segments[1]);
-      if (!unit) return null;
-      const files = unit.lessons.map((l) => this.lessonToFile(l));
-      return files.length > 0 ? files : null;
-    }
-    return null;
+    const resolved = this.resolve(path);
+    return resolved && resolved.files.length > 0 ? resolved.files : null;
   }
   async getInstructions(path, _auth) {
-    const { segments, depth } = parsePath(path);
-    const buildItem = (lesson, label) => ({
-      id: `${lesson.id}-action`,
-      itemType: "action",
-      label: label ?? lesson.title,
-      actionType: "play",
-      children: [
-        {
-          id: lesson.id,
-          itemType: "file",
-          label: label ?? lesson.title,
-          downloadUrl: lesson.videoUrl,
-          thumbnail: lesson.thumbnail,
-          mediaType: "video"
-        }
-      ]
-    });
-    if (segments[0] === "scheduled" && depth === 2) {
-      const sched = this.findScheduled(segments[1]);
-      const resolved = sched && this.resolveScheduled(sched);
-      if (!sched || !resolved) return null;
-      const label = `${sched.ageGroup} \u2014 ${resolved.lesson.title}`;
-      return {
-        name: label,
-        items: [{ id: `scheduled-${sched.id}-section`, itemType: "section", label: "This Sunday", children: [buildItem(resolved.lesson, label)] }]
-      };
-    }
-    if (depth === 3) {
-      const series = this.findSeries(segments[0]);
-      const unit = series && this.findUnit(series, segments[1]);
-      const lesson = unit && this.findLesson(unit, segments[2]);
-      if (!series || !unit || !lesson) return null;
-      return { name: lesson.title, items: [{ id: `${unit.id}-section`, itemType: "section", label: unit.name, children: [buildItem(lesson)] }] };
-    }
-    if (depth === 2 && segments[0] !== "scheduled") {
-      const series = this.findSeries(segments[0]);
-      const unit = series && this.findUnit(series, segments[1]);
-      if (!unit) return null;
-      return { name: unit.name, items: [{ id: `${unit.id}-section`, itemType: "section", label: unit.name, children: unit.lessons.map((l) => buildItem(l)) }] };
-    }
-    return null;
+    const resolved = this.resolve(path);
+    if (!resolved) return null;
+    return filesToInstructions(resolved.name, resolved.files, resolved.section);
   }
   /**
    * Returns the most recent scheduled lesson from data.scheduledLessons.
@@ -16672,9 +16273,6 @@ var LifeChurchProvider = class {
       ]
     };
   }
-  supportsDeviceFlow() {
-    return false;
-  }
 };
 
 // src/providers/index.ts
@@ -16769,18 +16367,21 @@ function getAvailableProviders(ids) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.4.1" : "dev";
+var VERSION = true ? "0.5.0" : "dev";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   APlayProvider,
   B1ChurchProvider,
+  BaseProvider,
   BibleProjectProvider,
   CbnProvider,
+  DeviceFlowHelper,
   DropboxProvider,
   HighVoltageKidsProvider,
   JesusFilmProvider,
   LessonsChurchProvider,
   LifeChurchProvider,
+  OAuthHelper,
   PlanningCenterProvider,
   SignPresenterProvider,
   TokenHelper,
@@ -16792,6 +16393,7 @@ var VERSION = true ? "0.4.1" : "dev";
   isContentFile,
   isContentFolder,
   navigateToPath,
-  registerProvider
+  registerProvider,
+  toAuthData
 });
 //# sourceMappingURL=index.cjs.map