@churchapps/content-providers 0.10.0 → 0.11.0

package/dist/index.d.cts

@@ -38,7 +38,14 @@ interface DeviceFlowState {
     error?: string;
     pollCount?: number;
 }
-type AuthType = "none" | "oauth_pkce" | "device_flow" | "form_login";
+type AuthType = "none" | "oauth_pkce" | "device_flow" | "form_login" | "network_discovery";
+interface NetworkInstance {
+    id: string;
+    name: string;
+    host: string;
+    ip: string;
+    port: number;
+}
 interface ProviderLogos {
     light: string;
     dark: string;
@@ -248,6 +255,7 @@ interface IProvider {
     initiateDeviceFlow?(): Promise<DeviceAuthorizationResponse | null>;
     pollDeviceFlowToken?(deviceCode: string): Promise<DeviceFlowPollResult>;
     performLogin?(email: string, password: string): Promise<ContentProviderAuthData | null>;
+    discoverInstances?(): Promise<NetworkInstance[]>;
     getPlaylist?(path: string, auth?: ContentProviderAuthData | null, resolution?: number): Promise<ContentFile[] | null>;
     getInstructions?(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     getCurrentPlan?(auth?: ContentProviderAuthData | null): Promise<CurrentPlan | null>;
@@ -563,6 +571,30 @@ declare class CbnProvider extends BaseProvider {
     pollDeviceFlowToken(deviceCode: string): Promise<DeviceFlowPollResult>;
 }
 
+type FreeShowDiscoverer = () => Promise<NetworkInstance[]>;
+
+declare class FreeShowProvider extends BaseProvider {
+    readonly id = "freeshow";
+    readonly name = "FreeShow";
+    readonly logos: ProviderLogos;
+    readonly config: ContentProviderConfig;
+    readonly requiresAuth = true;
+    readonly authTypes: AuthType[];
+    readonly capabilities: ProviderCapabilities;
+    private discoverer;
+    setDiscoverer(discoverer: FreeShowDiscoverer | null): void;
+    discoverInstances(): Promise<NetworkInstance[]>;
+    toAuth(instance: NetworkInstance): ContentProviderAuthData;
+    selectedInstance(auth?: ContentProviderAuthData | null): NetworkInstance | null;
+    browse(path?: string | null, _auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
+    getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
+    getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
+}
+
+declare const MOCK_FREESHOW_INSTANCE: NetworkInstance;
+declare function networkInstanceToAuth(instance: NetworkInstance): ContentProviderAuthData;
+declare function authToNetworkInstance(auth?: ContentProviderAuthData | null): NetworkInstance | null;
+
 /** Browses Life.Church's kids curriculum from a static catalog (series → units → lessons), plus a weekly scheduled lesson index. */
 declare class LifeChurchProvider extends BaseProvider {
     readonly id = "lifechurch";
@@ -606,4 +638,4 @@ declare function getAvailableProviders(ids?: string[]): ProviderInfo[];
  */
 declare const VERSION: string;
 
-export { APlayProvider, type AuthType, B1ChurchProvider, BaseProvider, BibleProjectProvider, CbnProvider, type ContentDownload, type ContentFile, type ContentFolder, type ContentItem, type ContentProviderAuthData, type ContentProviderConfig, type CurrentPlan, type DeviceAuthorizationResponse, DeviceFlowHelper, type DeviceFlowPollResult, type DeviceFlowState, DropboxProvider, type EndpointValue, type EndpointsConfig, type FeedActionInterface, type FeedDownloadInterface, type FeedFileInterface, type FeedSectionInterface, type FeedVenueInterface, HighVoltageKidsProvider, type IProvider, type InstructionItem, type Instructions, JesusFilmProvider, LessonsChurchProvider, LifeChurchProvider, type MediaLicenseResult, type MediaLicenseStatus, type MessageFileInterface, OAuthHelper, type Plan, type PlanPresentation, type PlanSection, type PlanTimelineItem, PlanningCenterProvider, type ProviderCapabilities, type ProviderInfo, type ProviderLogos, SignPresenterProvider, TokenHelper, VERSION, type VenueActionInterface, type VenueActionsResponseInterface, type VenueSectionActionsInterface, authIsExpired, getAllProviders, getAvailableProviders, getProvider, getProviderConfig, isContentFile, isContentFolder, navigateToPath, registerProvider, setProviderSecret, toAuthData };
+export { APlayProvider, type AuthType, B1ChurchProvider, BaseProvider, BibleProjectProvider, CbnProvider, type ContentDownload, type ContentFile, type ContentFolder, type ContentItem, type ContentProviderAuthData, type ContentProviderConfig, type CurrentPlan, type DeviceAuthorizationResponse, DeviceFlowHelper, type DeviceFlowPollResult, type DeviceFlowState, DropboxProvider, type EndpointValue, type EndpointsConfig, type FeedActionInterface, type FeedDownloadInterface, type FeedFileInterface, type FeedSectionInterface, type FeedVenueInterface, type FreeShowDiscoverer, FreeShowProvider, HighVoltageKidsProvider, type IProvider, type InstructionItem, type Instructions, JesusFilmProvider, LessonsChurchProvider, LifeChurchProvider, MOCK_FREESHOW_INSTANCE, type MediaLicenseResult, type MediaLicenseStatus, type MessageFileInterface, type NetworkInstance, OAuthHelper, type Plan, type PlanPresentation, type PlanSection, type PlanTimelineItem, PlanningCenterProvider, type ProviderCapabilities, type ProviderInfo, type ProviderLogos, SignPresenterProvider, TokenHelper, VERSION, type VenueActionInterface, type VenueActionsResponseInterface, type VenueSectionActionsInterface, authIsExpired, authToNetworkInstance, getAllProviders, getAvailableProviders, getProvider, getProviderConfig, isContentFile, isContentFolder, navigateToPath, networkInstanceToAuth, registerProvider, setProviderSecret, toAuthData };

package/dist/index.d.ts

@@ -38,7 +38,14 @@ interface DeviceFlowState {
     error?: string;
     pollCount?: number;
 }
-type AuthType = "none" | "oauth_pkce" | "device_flow" | "form_login";
+type AuthType = "none" | "oauth_pkce" | "device_flow" | "form_login" | "network_discovery";
+interface NetworkInstance {
+    id: string;
+    name: string;
+    host: string;
+    ip: string;
+    port: number;
+}
 interface ProviderLogos {
     light: string;
     dark: string;
@@ -248,6 +255,7 @@ interface IProvider {
     initiateDeviceFlow?(): Promise<DeviceAuthorizationResponse | null>;
     pollDeviceFlowToken?(deviceCode: string): Promise<DeviceFlowPollResult>;
     performLogin?(email: string, password: string): Promise<ContentProviderAuthData | null>;
+    discoverInstances?(): Promise<NetworkInstance[]>;
     getPlaylist?(path: string, auth?: ContentProviderAuthData | null, resolution?: number): Promise<ContentFile[] | null>;
     getInstructions?(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     getCurrentPlan?(auth?: ContentProviderAuthData | null): Promise<CurrentPlan | null>;
@@ -563,6 +571,30 @@ declare class CbnProvider extends BaseProvider {
     pollDeviceFlowToken(deviceCode: string): Promise<DeviceFlowPollResult>;
 }
 
+type FreeShowDiscoverer = () => Promise<NetworkInstance[]>;
+
+declare class FreeShowProvider extends BaseProvider {
+    readonly id = "freeshow";
+    readonly name = "FreeShow";
+    readonly logos: ProviderLogos;
+    readonly config: ContentProviderConfig;
+    readonly requiresAuth = true;
+    readonly authTypes: AuthType[];
+    readonly capabilities: ProviderCapabilities;
+    private discoverer;
+    setDiscoverer(discoverer: FreeShowDiscoverer | null): void;
+    discoverInstances(): Promise<NetworkInstance[]>;
+    toAuth(instance: NetworkInstance): ContentProviderAuthData;
+    selectedInstance(auth?: ContentProviderAuthData | null): NetworkInstance | null;
+    browse(path?: string | null, _auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
+    getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
+    getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
+}
+
+declare const MOCK_FREESHOW_INSTANCE: NetworkInstance;
+declare function networkInstanceToAuth(instance: NetworkInstance): ContentProviderAuthData;
+declare function authToNetworkInstance(auth?: ContentProviderAuthData | null): NetworkInstance | null;
+
 /** Browses Life.Church's kids curriculum from a static catalog (series → units → lessons), plus a weekly scheduled lesson index. */
 declare class LifeChurchProvider extends BaseProvider {
     readonly id = "lifechurch";
@@ -606,4 +638,4 @@ declare function getAvailableProviders(ids?: string[]): ProviderInfo[];
  */
 declare const VERSION: string;
 
-export { APlayProvider, type AuthType, B1ChurchProvider, BaseProvider, BibleProjectProvider, CbnProvider, type ContentDownload, type ContentFile, type ContentFolder, type ContentItem, type ContentProviderAuthData, type ContentProviderConfig, type CurrentPlan, type DeviceAuthorizationResponse, DeviceFlowHelper, type DeviceFlowPollResult, type DeviceFlowState, DropboxProvider, type EndpointValue, type EndpointsConfig, type FeedActionInterface, type FeedDownloadInterface, type FeedFileInterface, type FeedSectionInterface, type FeedVenueInterface, HighVoltageKidsProvider, type IProvider, type InstructionItem, type Instructions, JesusFilmProvider, LessonsChurchProvider, LifeChurchProvider, type MediaLicenseResult, type MediaLicenseStatus, type MessageFileInterface, OAuthHelper, type Plan, type PlanPresentation, type PlanSection, type PlanTimelineItem, PlanningCenterProvider, type ProviderCapabilities, type ProviderInfo, type ProviderLogos, SignPresenterProvider, TokenHelper, VERSION, type VenueActionInterface, type VenueActionsResponseInterface, type VenueSectionActionsInterface, authIsExpired, getAllProviders, getAvailableProviders, getProvider, getProviderConfig, isContentFile, isContentFolder, navigateToPath, registerProvider, setProviderSecret, toAuthData };
+export { APlayProvider, type AuthType, B1ChurchProvider, BaseProvider, BibleProjectProvider, CbnProvider, type ContentDownload, type ContentFile, type ContentFolder, type ContentItem, type ContentProviderAuthData, type ContentProviderConfig, type CurrentPlan, type DeviceAuthorizationResponse, DeviceFlowHelper, type DeviceFlowPollResult, type DeviceFlowState, DropboxProvider, type EndpointValue, type EndpointsConfig, type FeedActionInterface, type FeedDownloadInterface, type FeedFileInterface, type FeedSectionInterface, type FeedVenueInterface, type FreeShowDiscoverer, FreeShowProvider, HighVoltageKidsProvider, type IProvider, type InstructionItem, type Instructions, JesusFilmProvider, LessonsChurchProvider, LifeChurchProvider, MOCK_FREESHOW_INSTANCE, type MediaLicenseResult, type MediaLicenseStatus, type MessageFileInterface, type NetworkInstance, OAuthHelper, type Plan, type PlanPresentation, type PlanSection, type PlanTimelineItem, PlanningCenterProvider, type ProviderCapabilities, type ProviderInfo, type ProviderLogos, SignPresenterProvider, TokenHelper, VERSION, type VenueActionInterface, type VenueActionsResponseInterface, type VenueSectionActionsInterface, authIsExpired, authToNetworkInstance, getAllProviders, getAvailableProviders, getProvider, getProviderConfig, isContentFile, isContentFolder, navigateToPath, networkInstanceToAuth, registerProvider, setProviderSecret, toAuthData };

package/dist/index.js

@@ -12529,6 +12529,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",
@@ -17933,14 +18182,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",
@@ -17972,7 +18213,8 @@ function initializeProviders() {
     new LifeChurchProvider(),
     new PlanningCenterProvider(),
     new SignPresenterProvider(),
-    new CbnProvider()
+    new CbnProvider(),
+    new FreeShowProvider()
   ];
   for (const provider of providers) registerProvider(provider);
 }
@@ -18009,7 +18251,7 @@ function getAvailableProviders(ids) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.10.0" : "dev";
+var VERSION = true ? "0.11.0" : "dev";
 export {
   APlayProvider,
   B1ChurchProvider,
@@ -18018,16 +18260,19 @@ export {
   CbnProvider,
   DeviceFlowHelper,
   DropboxProvider,
+  FreeShowProvider,
   HighVoltageKidsProvider,
   JesusFilmProvider,
   LessonsChurchProvider,
   LifeChurchProvider,
+  MOCK_FREESHOW_INSTANCE,
   OAuthHelper,
   PlanningCenterProvider,
   SignPresenterProvider,
   TokenHelper,
   VERSION,
   authIsExpired,
+  authToNetworkInstance,
   getAllProviders,
   getAvailableProviders,
   getProvider,
@@ -18035,6 +18280,7 @@ export {
   isContentFile,
   isContentFolder,
   navigateToPath,
+  networkInstanceToAuth,
   registerProvider,
   setProviderSecret,
   toAuthData