@churchapps/content-providers 0.9.4 → 0.11.0

package/README.md

@@ -52,6 +52,7 @@ const plan = await provider.getPresentations(serviceId);
 - **CbnProvider** - CBN Superbook curriculum
 - **HighVoltageKidsProvider** - High Voltage Kids curriculum (static catalog)
 - **LifeChurchProvider** - Life.Church kids curriculum (static catalog)
+- **FreeShowProvider** - FreeShow shows discovered on the local network (mocked announcements playlist)
 
 ### Create a Custom Provider
 
@@ -66,6 +67,7 @@ class MyProvider extends BaseProvider {
   //                   (OAuthHelper implements the standard flow; delegate to it like SignPresenterProvider)
   //   device_flow  -> initiateDeviceFlow / pollDeviceFlowToken (see DeviceFlowHelper)
   //   form_login   -> performLogin
+  //   network_discovery -> discoverInstances
   //   playlist / instructions / mediaLicensing -> getPlaylist / getInstructions / checkMediaLicense
   // The protected apiRequest() helper performs authenticated JSON fetches against config.apiBase.
 }

package/dist/index.cjs

@@ -27,16 +27,19 @@ __export(index_exports, {
   CbnProvider: () => CbnProvider,
   DeviceFlowHelper: () => DeviceFlowHelper,
   DropboxProvider: () => DropboxProvider,
+  FreeShowProvider: () => FreeShowProvider,
   HighVoltageKidsProvider: () => HighVoltageKidsProvider,
   JesusFilmProvider: () => JesusFilmProvider,
   LessonsChurchProvider: () => LessonsChurchProvider,
   LifeChurchProvider: () => LifeChurchProvider,
+  MOCK_FREESHOW_INSTANCE: () => MOCK_FREESHOW_INSTANCE,
   OAuthHelper: () => OAuthHelper,
   PlanningCenterProvider: () => PlanningCenterProvider,
   SignPresenterProvider: () => SignPresenterProvider,
   TokenHelper: () => TokenHelper,
   VERSION: () => VERSION,
   authIsExpired: () => authIsExpired,
+  authToNetworkInstance: () => authToNetworkInstance,
   getAllProviders: () => getAllProviders,
   getAvailableProviders: () => getAvailableProviders,
   getProvider: () => getProvider,
@@ -44,6 +47,7 @@ __export(index_exports, {
   isContentFile: () => isContentFile,
   isContentFolder: () => isContentFolder,
   navigateToPath: () => navigateToPath,
+  networkInstanceToAuth: () => networkInstanceToAuth,
   registerProvider: () => registerProvider,
   setProviderSecret: () => setProviderSecret,
   toAuthData: () => toAuthData
@@ -338,6 +342,12 @@ function isMediaFile(filename) {
   const lower = filename.toLowerCase();
   return [...VIDEO_EXTENSIONS, ...IMAGE_EXTENSIONS, ...AUDIO_EXTENSIONS].some((ext) => lower.endsWith(ext));
 }
+function isPlaylistMedia(url, fileType, name) {
+  if (fileType?.startsWith("video/") || fileType?.startsWith("audio/") || fileType === "video" || fileType === "audio") return true;
+  const haystack = `${url} ${name || ""}`.toLowerCase();
+  if (haystack.includes("stream.mux.com") || haystack.includes("externalvideos/download")) return true;
+  return [...VIDEO_EXTENSIONS, ...AUDIO_EXTENSIONS].some((ext) => haystack.includes(ext));
+}
 function createFolder(id, title, path, thumbnail, isLeaf) {
   return { type: "folder", id, title, path, thumbnail, isLeaf };
 }
@@ -1011,6 +1021,18 @@ var LessonsChurchProvider = class extends BaseProvider {
     const filtered = allAddOns.filter((a) => a.category === decodedCategory);
     return filtered.map((addOn) => createFolder(addOn.id, addOn.name, `${currentPath}/${addOn.id}`, addOn.image, true));
   }
+  /** Flatten feed download bundles into printable files, keeping playlist media (videos already in the run-of-show) out. */
+  convertFeedDownloads(bundles) {
+    const result = [];
+    for (const bundle of bundles || []) {
+      const files = (bundle.files || []).filter((f) => f.url && !isPlaylistMedia(f.url, f.fileType, f.name));
+      for (const file of files) {
+        const title = (files.length === 1 ? bundle.name || file.name : file.name || bundle.name) || "Download";
+        result.push({ id: file.id, title, url: file.url, fileType: file.fileType, bytes: file.bytes });
+      }
+    }
+    return result;
+  }
   async getInstructions(path, _auth) {
     const venueId = getSegment(path, 4);
     if (venueId) {
@@ -1022,7 +1044,8 @@ var LessonsChurchProvider = class extends BaseProvider {
       if (!planItemsResponse) return null;
       const lessonImage = feedResponse?.lessonImage;
       const sectionActionsMap = buildSectionActionsMap(actionsResponse, lessonImage, feedResponse);
-      return { name: planItemsResponse.venueName, items: (planItemsResponse.items || []).map((item) => processInstructionItem(item, sectionActionsMap, lessonImage)) };
+      const downloads = this.convertFeedDownloads(feedResponse?.downloads);
+      return { name: planItemsResponse.venueName, items: (planItemsResponse.items || []).map((item) => processInstructionItem(item, sectionActionsMap, lessonImage)), downloads: downloads.length > 0 ? downloads : void 0 };
     }
     const { segments } = parsePath(path);
     if (segments[0] === "addons" && segments.length === 3) {
@@ -12562,6 +12585,255 @@ var CbnProvider = class extends BaseProvider {
   }
 };
 
+// src/providers/freeShow/announcements.show.json
+var announcements_show_default = [
+  "2f357194dfc",
+  {
+    name: "Announcements",
+    private: false,
+    category: "presentation",
+    settings: {
+      activeLayout: "f2f357194df",
+      template: "default"
+    },
+    timestamps: {
+      created: 1769712923789,
+      modified: 1769713271120,
+      used: 1769713271120
+    },
+    quickAccess: {},
+    meta: {},
+    slides: {
+      da7b854ee5b: {
+        group: "Kids Theme Loop",
+        color: null,
+        settings: {},
+        notes: "",
+        items: []
+      },
+      "5a99fba3e52": {
+        group: "Preteen Theme",
+        color: null,
+        settings: {},
+        notes: "",
+        items: []
+      },
+      "52d2ca79bcd": {
+        group: "Kids Theme Transition to Virtue",
+        color: null,
+        settings: {},
+        notes: "",
+        items: []
+      },
+      cd55e66060b: {
+        group: "Theme",
+        color: null,
+        settings: {},
+        notes: "",
+        items: []
+      }
+    },
+    layouts: {
+      f2f357194df: {
+        name: "Default",
+        notes: "",
+        slides: [
+          {
+            id: "da7b854ee5b",
+            background: "a7b854ee5bf",
+            actions: { nextAfterMedia: true }
+          },
+          {
+            id: "5a99fba3e52",
+            background: "a99fba3e52d",
+            nextTimer: 7
+          },
+          {
+            id: "52d2ca79bcd",
+            background: "2d2ca79bcd5",
+            actions: { nextAfterMedia: true }
+          },
+          {
+            id: "cd55e66060b",
+            background: "d55e66060b8",
+            nextTimer: 7,
+            end: true
+          }
+        ]
+      }
+    },
+    media: {
+      a7b854ee5bf: {
+        name: "Kids Theme Loop",
+        path: "https://stream.mux.com/kDsWzEqyN7TDoMM3Aykfq1QhEo01JhCWO7t2sABictzk/capped-1080p.mp4",
+        type: "video",
+        contentProvider: "amazinglife",
+        muted: false,
+        loop: false
+      },
+      a99fba3e52d: {
+        name: "Preteen Theme",
+        path: "https://www.datocms-assets.com/75190/1746649082-2507_screen_preteen_theme.jpg",
+        type: "image",
+        contentProvider: "amazinglife"
+      },
+      "2d2ca79bcd5": {
+        name: "Kids Theme Transition to Virtue",
+        path: "https://stream.mux.com/101lB00Wj00AMUsjbuNYkNofkNHQXpZeThL3mFZNsSB5A00/capped-1080p.mp4",
+        type: "video",
+        contentProvider: "amazinglife",
+        muted: false,
+        loop: false
+      },
+      d55e66060b8: {
+        name: "Theme",
+        path: "https://www.datocms-assets.com/75190/1746648669-2507_screen_kids_theme.jpg",
+        type: "image",
+        contentProvider: "amazinglife"
+      }
+    }
+  }
+];
+
+// src/providers/freeShow/FreeShowInterfaces.ts
+var DEFAULT_SLIDE_SECONDS = 5;
+
+// src/providers/freeShow/FreeShowConverters.ts
+var MOCK_FREESHOW_INSTANCE = {
+  id: "mock-local",
+  name: "This PC",
+  host: "localhost",
+  ip: "127.0.0.1",
+  port: 5505
+};
+function parseShowExport(raw) {
+  if (Array.isArray(raw) && raw.length >= 2 && typeof raw[0] === "string" && raw[1] && typeof raw[1] === "object") {
+    return { id: raw[0], show: raw[1] };
+  }
+  if (raw && typeof raw === "object" && "layouts" in raw && "media" in raw) {
+    const show = raw;
+    return { id: show.id || "show", show };
+  }
+  return null;
+}
+function slideSeconds(ref, mediaType) {
+  if (typeof ref.nextTimer === "number" && ref.nextTimer > 0) return ref.nextTimer;
+  if (ref.actions?.nextAfterMedia && mediaType === "video") return void 0;
+  return DEFAULT_SLIDE_SECONDS;
+}
+function showToFiles(show) {
+  const layoutId = show.settings?.activeLayout || Object.keys(show.layouts || {})[0];
+  const layout = layoutId ? show.layouts?.[layoutId] : void 0;
+  const refs = layout?.slides || [];
+  const loops = refs.some((ref) => ref.end === true);
+  const files = [];
+  for (const ref of refs) {
+    if (ref.disabled || !ref.background) continue;
+    const media = show.media?.[ref.background];
+    const path = media?.path;
+    if (!path) continue;
+    const mediaType = detectMediaType(path, media?.type);
+    const slide = show.slides?.[ref.id];
+    const title = media?.name || slide?.group || "Slide";
+    files.push(createFile(ref.id, title, path, {
+      mediaType,
+      thumbnail: mediaType === "image" ? path : void 0,
+      seconds: slideSeconds(ref, mediaType),
+      loop: loops,
+      loopVideo: false
+    }));
+  }
+  return files;
+}
+function showToFolder(id, show) {
+  const files = showToFiles(show);
+  const thumbnail = files.find((file) => file.mediaType === "image")?.url || files[0]?.thumbnail;
+  return createFolder(id, show.name || "Show", `/${id}`, thumbnail, true);
+}
+function networkInstanceToAuth(instance) {
+  return {
+    access_token: instance.id,
+    refresh_token: JSON.stringify(instance),
+    token_type: "network",
+    created_at: Math.floor(Date.now() / 1e3),
+    expires_in: 10 * 365 * 24 * 3600,
+    scope: "freeshow"
+  };
+}
+function authToNetworkInstance(auth) {
+  if (!auth?.refresh_token) return null;
+  try {
+    const parsed = JSON.parse(auth.refresh_token);
+    if (parsed?.id && parsed?.name) return parsed;
+  } catch {
+    return null;
+  }
+  return null;
+}
+
+// src/providers/freeShow/FreeShowProvider.ts
+var parsedMock = parseShowExport(announcements_show_default);
+var MOCK_SHOW_ID = parsedMock?.id || "announcements";
+var MOCK_SHOW = parsedMock?.show || { name: "Announcements", layouts: {}, media: {}, slides: {} };
+var FreeShowProvider = class extends BaseProvider {
+  constructor() {
+    super(...arguments);
+    this.id = "freeshow";
+    this.name = "FreeShow";
+    this.logos = {
+      light: "https://freeshow.app/images/favicon.png",
+      dark: "https://freeshow.app/images/favicon.png"
+    };
+    this.config = {
+      id: "freeshow",
+      name: "FreeShow",
+      apiBase: "",
+      oauthBase: "",
+      clientId: "",
+      scopes: []
+    };
+    this.requiresAuth = true;
+    this.authTypes = ["network_discovery"];
+    this.capabilities = {
+      browse: true,
+      playlist: true,
+      instructions: true,
+      mediaLicensing: false
+    };
+    this.discoverer = null;
+  }
+  setDiscoverer(discoverer) {
+    this.discoverer = discoverer;
+  }
+  async discoverInstances() {
+    if (this.discoverer) return this.discoverer();
+    await new Promise((resolve) => setTimeout(resolve, 600));
+    return [MOCK_FREESHOW_INSTANCE];
+  }
+  toAuth(instance) {
+    return networkInstanceToAuth(instance);
+  }
+  selectedInstance(auth) {
+    return authToNetworkInstance(auth);
+  }
+  async browse(path, _auth) {
+    const { depth } = parsePath(path);
+    if (depth === 0) return [showToFolder(MOCK_SHOW_ID, MOCK_SHOW)];
+    return [];
+  }
+  async getPlaylist(path, _auth, _resolution) {
+    const { segments, depth } = parsePath(path);
+    if (depth < 1 || segments[0] !== MOCK_SHOW_ID) return null;
+    const files = showToFiles(MOCK_SHOW);
+    return files.length > 0 ? files : null;
+  }
+  async getInstructions(path, auth) {
+    const files = await this.getPlaylist(path, auth);
+    if (!files) return null;
+    return filesToInstructions(MOCK_SHOW.name || "Show", files);
+  }
+};
+
 // src/providers/lifeChurch/data.json
 var data_default3 = {
   generatedAt: "2026-05-09T20:14:53.089Z",
@@ -17792,7 +18064,10 @@ var GoCurriculumProvider = class extends BaseProvider {
     if (!files) return null;
     const collection = (await this.getData()).catalog.find((c) => c.id === segments[0]);
     const lesson = collection?.lessons.find((l) => l.id === segments[1]);
-    return filesToInstructions(lesson?.name || "Lesson", files);
+    const instructions = filesToInstructions(lesson?.name || "Lesson", files);
+    const downloads = (lesson?.resources || []).filter((r) => r.url && !isPlaylistMedia(r.url, void 0, r.file)).map((r) => ({ id: slugify(r.file || r.title), title: r.title || r.file, url: r.url }));
+    if (downloads.length > 0) instructions.downloads = downloads;
+    return instructions;
   }
   generateCodeVerifier() {
     return this.oauthHelper.generateCodeVerifier();
@@ -17963,14 +18238,6 @@ var unimplementedProviders = [
       dark: "https://www.awana.org/wp-content/uploads/2025/04/awana-logo-white.svg"
     }
   },
-  {
-    id: "freeshow",
-    name: "FreeShow",
-    logos: {
-      light: "https://freeshow.app/images/favicon.png",
-      dark: "https://freeshow.app/images/favicon.png"
-    }
-  },
   {
     id: "iteachchurch",
     name: "iTeachChurch",
@@ -18002,7 +18269,8 @@ function initializeProviders() {
     new LifeChurchProvider(),
     new PlanningCenterProvider(),
     new SignPresenterProvider(),
-    new CbnProvider()
+    new CbnProvider(),
+    new FreeShowProvider()
   ];
   for (const provider of providers) registerProvider(provider);
 }
@@ -18039,7 +18307,7 @@ function getAvailableProviders(ids) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.9.4" : "dev";
+var VERSION = true ? "0.11.0" : "dev";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   APlayProvider,
@@ -18049,16 +18317,19 @@ var VERSION = true ? "0.9.4" : "dev";
   CbnProvider,
   DeviceFlowHelper,
   DropboxProvider,
+  FreeShowProvider,
   HighVoltageKidsProvider,
   JesusFilmProvider,
   LessonsChurchProvider,
   LifeChurchProvider,
+  MOCK_FREESHOW_INSTANCE,
   OAuthHelper,
   PlanningCenterProvider,
   SignPresenterProvider,
   TokenHelper,
   VERSION,
   authIsExpired,
+  authToNetworkInstance,
   getAllProviders,
   getAvailableProviders,
   getProvider,
@@ -18066,6 +18337,7 @@ var VERSION = true ? "0.9.4" : "dev";
   isContentFile,
   isContentFolder,
   navigateToPath,
+  networkInstanceToAuth,
   registerProvider,
   setProviderSecret,
   toAuthData