@churchapps/content-providers 0.10.0 → 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
@@ -12581,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",
@@ -17985,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",
@@ -18024,7 +18269,8 @@ function initializeProviders() {
     new LifeChurchProvider(),
     new PlanningCenterProvider(),
     new SignPresenterProvider(),
-    new CbnProvider()
+    new CbnProvider(),
+    new FreeShowProvider()
   ];
   for (const provider of providers) registerProvider(provider);
 }
@@ -18061,7 +18307,7 @@ function getAvailableProviders(ids) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.10.0" : "dev";
+var VERSION = true ? "0.11.0" : "dev";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   APlayProvider,
@@ -18071,16 +18317,19 @@ var VERSION = true ? "0.10.0" : "dev";
   CbnProvider,
   DeviceFlowHelper,
   DropboxProvider,
+  FreeShowProvider,
   HighVoltageKidsProvider,
   JesusFilmProvider,
   LessonsChurchProvider,
   LifeChurchProvider,
+  MOCK_FREESHOW_INSTANCE,
   OAuthHelper,
   PlanningCenterProvider,
   SignPresenterProvider,
   TokenHelper,
   VERSION,
   authIsExpired,
+  authToNetworkInstance,
   getAllProviders,
   getAvailableProviders,
   getProvider,
@@ -18088,6 +18337,7 @@ var VERSION = true ? "0.10.0" : "dev";
   isContentFile,
   isContentFolder,
   navigateToPath,
+  networkInstanceToAuth,
   registerProvider,
   setProviderSecret,
   toAuthData