@churchapps/content-providers 0.5.1 → 0.6.0

package/dist/index.d.cts

@@ -223,6 +223,8 @@ interface IProvider {
         url: string;
         challengeMethod: string;
     }>;
+    /** For environments without Web Crypto (e.g. React Native): caller computes the S256 challenge. */
+    buildAuthUrlFromChallenge?(codeChallenge: string, redirectUri: string, state: string): string;
     exchangeCodeForTokens?(code: string, codeVerifier: string, redirectUri: string): Promise<ContentProviderAuthData | null>;
     initiateDeviceFlow?(): Promise<DeviceAuthorizationResponse | null>;
     pollDeviceFlowToken?(deviceCode: string): Promise<DeviceFlowPollResult>;
@@ -245,6 +247,7 @@ declare class OAuthHelper {
         url: string;
         challengeMethod: string;
     }>;
+    buildAuthUrlFromChallenge(config: ContentProviderConfig, codeChallenge: string, redirectUri: string, state: string): string;
     exchangeCodeForTokens(config: ContentProviderConfig, _providerId: string, code: string, codeVerifier: string, redirectUri: string): Promise<ContentProviderAuthData | null>;
 }
 
@@ -283,6 +286,7 @@ declare abstract class BaseProvider implements IProvider {
 
 /** APlay Provider: media curriculum library with OAuth 2.0 auth. */
 declare class APlayProvider extends BaseProvider {
+    private readonly oauthHelper;
     readonly id = "aplay";
     readonly name = "APlay";
     readonly logos: ProviderLogos;
@@ -298,6 +302,13 @@ declare class APlayProvider extends BaseProvider {
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     checkMediaLicense(mediaId: string, auth?: ContentProviderAuthData | null): Promise<MediaLicenseResult | null>;
+    generateCodeVerifier(): string;
+    buildAuthUrl(codeVerifier: string, redirectUri: string, state?: string): Promise<{
+        url: string;
+        challengeMethod: string;
+    }>;
+    buildAuthUrlFromChallenge(codeChallenge: string, redirectUri: string, state: string): string;
+    exchangeCodeForTokens(code: string, codeVerifier: string, redirectUri: string): Promise<ContentProviderAuthData | null>;
 }
 
 /** Browses SignPresenter playlists → messages (files). */
@@ -322,6 +333,7 @@ declare class SignPresenterProvider extends BaseProvider {
         url: string;
         challengeMethod: string;
     }>;
+    buildAuthUrlFromChallenge(codeChallenge: string, redirectUri: string, state: string): string;
     exchangeCodeForTokens(code: string, codeVerifier: string, redirectUri: string): Promise<ContentProviderAuthData | null>;
     initiateDeviceFlow(): Promise<DeviceAuthorizationResponse | null>;
     pollDeviceFlowToken(deviceCode: string): Promise<DeviceFlowPollResult>;
@@ -366,11 +378,13 @@ declare class B1ChurchProvider extends BaseProvider {
     readonly requiresAuth = true;
     readonly authTypes: AuthType[];
     readonly capabilities: ProviderCapabilities;
+    generateCodeVerifier(): string;
     buildAuthUrl(codeVerifier: string, redirectUri: string, state?: string): Promise<{
         url: string;
         challengeMethod: string;
     }>;
-    exchangeCodeForTokensWithPKCE(code: string, redirectUri: string, codeVerifier: string): Promise<ContentProviderAuthData | null>;
+    buildAuthUrlFromChallenge(codeChallenge: string, redirectUri: string, state: string): string;
+    exchangeCodeForTokens(code: string, codeVerifier: string, redirectUri: string): Promise<ContentProviderAuthData | null>;
     exchangeCodeForTokensWithSecret(code: string, redirectUri: string, clientSecret: string): Promise<ContentProviderAuthData | null>;
     refreshTokenWithSecret(authData: ContentProviderAuthData, clientSecret: string): Promise<ContentProviderAuthData | null>;
     initiateDeviceFlow(): Promise<DeviceAuthorizationResponse | null>;

package/dist/index.d.ts

@@ -223,6 +223,8 @@ interface IProvider {
         url: string;
         challengeMethod: string;
     }>;
+    /** For environments without Web Crypto (e.g. React Native): caller computes the S256 challenge. */
+    buildAuthUrlFromChallenge?(codeChallenge: string, redirectUri: string, state: string): string;
     exchangeCodeForTokens?(code: string, codeVerifier: string, redirectUri: string): Promise<ContentProviderAuthData | null>;
     initiateDeviceFlow?(): Promise<DeviceAuthorizationResponse | null>;
     pollDeviceFlowToken?(deviceCode: string): Promise<DeviceFlowPollResult>;
@@ -245,6 +247,7 @@ declare class OAuthHelper {
         url: string;
         challengeMethod: string;
     }>;
+    buildAuthUrlFromChallenge(config: ContentProviderConfig, codeChallenge: string, redirectUri: string, state: string): string;
     exchangeCodeForTokens(config: ContentProviderConfig, _providerId: string, code: string, codeVerifier: string, redirectUri: string): Promise<ContentProviderAuthData | null>;
 }
 
@@ -283,6 +286,7 @@ declare abstract class BaseProvider implements IProvider {
 
 /** APlay Provider: media curriculum library with OAuth 2.0 auth. */
 declare class APlayProvider extends BaseProvider {
+    private readonly oauthHelper;
     readonly id = "aplay";
     readonly name = "APlay";
     readonly logos: ProviderLogos;
@@ -298,6 +302,13 @@ declare class APlayProvider extends BaseProvider {
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     checkMediaLicense(mediaId: string, auth?: ContentProviderAuthData | null): Promise<MediaLicenseResult | null>;
+    generateCodeVerifier(): string;
+    buildAuthUrl(codeVerifier: string, redirectUri: string, state?: string): Promise<{
+        url: string;
+        challengeMethod: string;
+    }>;
+    buildAuthUrlFromChallenge(codeChallenge: string, redirectUri: string, state: string): string;
+    exchangeCodeForTokens(code: string, codeVerifier: string, redirectUri: string): Promise<ContentProviderAuthData | null>;
 }
 
 /** Browses SignPresenter playlists → messages (files). */
@@ -322,6 +333,7 @@ declare class SignPresenterProvider extends BaseProvider {
         url: string;
         challengeMethod: string;
     }>;
+    buildAuthUrlFromChallenge(codeChallenge: string, redirectUri: string, state: string): string;
     exchangeCodeForTokens(code: string, codeVerifier: string, redirectUri: string): Promise<ContentProviderAuthData | null>;
     initiateDeviceFlow(): Promise<DeviceAuthorizationResponse | null>;
     pollDeviceFlowToken(deviceCode: string): Promise<DeviceFlowPollResult>;
@@ -366,11 +378,13 @@ declare class B1ChurchProvider extends BaseProvider {
     readonly requiresAuth = true;
     readonly authTypes: AuthType[];
     readonly capabilities: ProviderCapabilities;
+    generateCodeVerifier(): string;
     buildAuthUrl(codeVerifier: string, redirectUri: string, state?: string): Promise<{
         url: string;
         challengeMethod: string;
     }>;
-    exchangeCodeForTokensWithPKCE(code: string, redirectUri: string, codeVerifier: string): Promise<ContentProviderAuthData | null>;
+    buildAuthUrlFromChallenge(codeChallenge: string, redirectUri: string, state: string): string;
+    exchangeCodeForTokens(code: string, codeVerifier: string, redirectUri: string): Promise<ContentProviderAuthData | null>;
     exchangeCodeForTokensWithSecret(code: string, redirectUri: string, clientSecret: string): Promise<ContentProviderAuthData | null>;
     refreshTokenWithSecret(authData: ContentProviderAuthData, clientSecret: string): Promise<ContentProviderAuthData | null>;
     initiateDeviceFlow(): Promise<DeviceAuthorizationResponse | null>;

package/dist/index.js

@@ -93,6 +93,9 @@ var OAuthHelper = class {
   }
   async buildAuthUrl(config, codeVerifier, redirectUri, state) {
     const codeChallenge = await generateCodeChallenge(codeVerifier);
+    return { url: this.buildAuthUrlFromChallenge(config, codeChallenge, redirectUri, state || ""), challengeMethod: "S256" };
+  }
+  buildAuthUrlFromChallenge(config, codeChallenge, redirectUri, state) {
     const params = new URLSearchParams({
       response_type: "code",
       client_id: config.clientId,
@@ -100,9 +103,9 @@ var OAuthHelper = class {
       scope: config.scopes.join(" "),
       code_challenge: codeChallenge,
       code_challenge_method: "S256",
-      state: state || ""
+      state
     });
-    return { url: `${config.oauthBase}/authorize?${params.toString()}`, challengeMethod: "S256" };
+    return `${config.oauthBase}/authorize?${params.toString()}`;
   }
   async exchangeCodeForTokens(config, _providerId, code, codeVerifier, redirectUri) {
     try {
@@ -284,12 +287,15 @@ function filesToInstructions(name, files, section) {
   const items = section ? [{ id: section.id, itemType: "section", label: section.label ?? name, children: actions }] : actions;
   return { name, items };
 }
+function instructionItemMediaType(item) {
+  return detectMediaType(`${item.downloadUrl || ""} ${item.label || ""}`, item.mediaType);
+}
 function instructionsToPlaylist(instructions) {
   const files = [];
   function extractFiles(items) {
     for (const item of items) {
       if (item.downloadUrl && (item.itemType === "file" || !item.children?.length)) {
-        files.push({ type: "file", id: item.id || item.relatedId || generateId(), title: item.label || "Untitled", mediaType: detectMediaType(item.downloadUrl), url: item.downloadUrl, downloadUrl: item.downloadUrl, seconds: item.seconds, thumbnail: item.thumbnail });
+        files.push({ type: "file", id: item.id || item.relatedId || generateId(), title: item.label || "Untitled", mediaType: instructionItemMediaType(item), url: item.downloadUrl, downloadUrl: item.downloadUrl, seconds: item.seconds, thumbnail: item.thumbnail });
       }
       if (item.children) extractFiles(item.children);
     }
@@ -399,6 +405,7 @@ function extractArray(response, ...keys) {
 var APlayProvider = class extends BaseProvider {
   constructor() {
     super(...arguments);
+    this.oauthHelper = new OAuthHelper();
     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" };
@@ -468,6 +475,18 @@ var APlayProvider = class extends BaseProvider {
   async checkMediaLicense(mediaId, auth) {
     return checkMediaLicense(mediaId, auth);
   }
+  generateCodeVerifier() {
+    return this.oauthHelper.generateCodeVerifier();
+  }
+  async buildAuthUrl(codeVerifier, redirectUri, state) {
+    return this.oauthHelper.buildAuthUrl(this.config, codeVerifier, redirectUri, state || this.id);
+  }
+  buildAuthUrlFromChallenge(codeChallenge, redirectUri, state) {
+    return this.oauthHelper.buildAuthUrlFromChallenge(this.config, codeChallenge, redirectUri, state);
+  }
+  async exchangeCodeForTokens(code, codeVerifier, redirectUri) {
+    return this.oauthHelper.exchangeCodeForTokens(this.config, this.id, code, codeVerifier, redirectUri);
+  }
 };
 
 // src/providers/signPresenter/SignPresenterProvider.ts
@@ -552,6 +571,9 @@ var SignPresenterProvider = class extends BaseProvider {
   async buildAuthUrl(codeVerifier, redirectUri, state) {
     return this.oauthHelper.buildAuthUrl(this.config, codeVerifier, redirectUri, state || this.id);
   }
+  buildAuthUrlFromChallenge(codeChallenge, redirectUri, state) {
+    return this.oauthHelper.buildAuthUrlFromChallenge(this.config, codeChallenge, redirectUri, state);
+  }
   async exchangeCodeForTokens(code, codeVerifier, redirectUri) {
     return this.oauthHelper.exchangeCodeForTokens(this.config, this.id, code, codeVerifier, redirectUri);
   }
@@ -924,8 +946,7 @@ function registerProvider(provider) {
 }
 
 // src/providers/b1Church/B1ChurchAuth.ts
-async function buildB1AuthUrl(config, appBase, redirectUri, codeVerifier, state) {
-  const codeChallenge = await generateCodeChallenge(codeVerifier);
+function buildB1AuthUrlFromChallenge(config, appBase, redirectUri, codeChallenge, state) {
   const oauthParams = new URLSearchParams({
     response_type: "code",
     client_id: config.clientId,
@@ -933,10 +954,13 @@ async function buildB1AuthUrl(config, appBase, redirectUri, codeVerifier, state)
     scope: config.scopes.join(" "),
     code_challenge: codeChallenge,
     code_challenge_method: "S256",
-    state: state || ""
+    state
   });
-  const url = `${appBase}/oauth?${oauthParams.toString()}`;
-  return { url, challengeMethod: "S256" };
+  return `${appBase}/oauth?${oauthParams.toString()}`;
+}
+async function buildB1AuthUrl(config, appBase, redirectUri, codeVerifier, state) {
+  const codeChallenge = await generateCodeChallenge(codeVerifier);
+  return { url: buildB1AuthUrlFromChallenge(config, appBase, redirectUri, codeChallenge, state || ""), challengeMethod: "S256" };
 }
 async function exchangeCodeForTokensWithPKCE(config, code, redirectUri, codeVerifier) {
   try {
@@ -1168,6 +1192,7 @@ function collectFilesFromNode(node) {
       id: node.id,
       name: node.label || "",
       url: node.downloadUrl,
+      fileType: instructionItemMediaType(node),
       seconds: node.seconds || 10
     });
   }
@@ -1233,6 +1258,9 @@ function findFirstThumbnail(items) {
   }
   return void 0;
 }
+function isLessonsChurchContent(plan) {
+  return !plan.providerId || plan.providerId === "lessonschurch";
+}
 function isExternalProviderItem(item) {
   if (!item.providerId || item.providerId === "b1church") return false;
   if (item.providerPath) return true;
@@ -1259,10 +1287,16 @@ var B1ChurchProvider = class extends BaseProvider {
     this.capabilities = { browse: true, playlist: true, instructions: true, mediaLicensing: false };
     this.planTypeId = null;
   }
+  generateCodeVerifier() {
+    return generateCodeVerifier();
+  }
   async buildAuthUrl(codeVerifier, redirectUri, state) {
     return buildB1AuthUrl(this.config, this.appBase, redirectUri, codeVerifier, state);
   }
-  async exchangeCodeForTokensWithPKCE(code, redirectUri, codeVerifier) {
+  buildAuthUrlFromChallenge(codeChallenge, redirectUri, state) {
+    return buildB1AuthUrlFromChallenge(this.config, this.appBase, redirectUri, codeChallenge, state);
+  }
+  async exchangeCodeForTokens(code, codeVerifier, redirectUri) {
     return exchangeCodeForTokensWithPKCE(this.config, code, redirectUri, codeVerifier);
   }
   async exchangeCodeForTokensWithSecret(code, redirectUri, clientSecret) {
@@ -1398,7 +1432,7 @@ var B1ChurchProvider = class extends BaseProvider {
     const planFolder = plans.find((p) => p.id === planId);
     if (!planFolder) return null;
     const churchId = planFolder.churchId;
-    const venueId = planFolder.contentId;
+    const venueId = isLessonsChurchContent(planFolder) ? planFolder.contentId : void 0;
     const planTitle = planFolder.name || "Plan";
     if (!churchId) {
       console.warn("[B1Church getInstructions] planFolder missing churchId:", planFolder.id);
@@ -1507,7 +1541,7 @@ var B1ChurchProvider = class extends BaseProvider {
       return null;
     }
     const churchId = planFolder.churchId;
-    const venueId = planFolder.contentId;
+    const venueId = isLessonsChurchContent(planFolder) ? planFolder.contentId : void 0;
     if (!churchId) {
       console.warn("[B1Church] getPlaylist: planFolder missing churchId:", planFolder.id);
       return null;
@@ -1531,7 +1565,7 @@ var B1ChurchProvider = class extends BaseProvider {
     const venueFeed = venueId ? await fetchVenueFeed(venueId) : null;
     const files = [];
     for (const sectionItem of planItems) {
-      for (const child of sectionItem.children || []) {
+      for (const child of sectionItem.children?.length ? sectionItem.children : [sectionItem]) {
         const childItemType = child.itemType;
         const isSectionType = childItemType === "section" || childItemType === "lessonSection" || childItemType === "providerSection";
         const canExpandLocally = isSectionType && venueFeed && child.relatedId;
@@ -1847,7 +1881,8 @@ var PlanningCenterProvider = class extends BaseProvider {
     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"] };
     this.requiresAuth = true;
-    this.authTypes = ["oauth_pkce"];
+    // No client-side auth flow: clientId is unset and no PKCE methods exist. Auth tokens must be supplied externally (server-side).
+    this.authTypes = [];
     // 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 };
   }
@@ -16310,7 +16345,7 @@ function getAvailableProviders(ids) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.5.1" : "dev";
+var VERSION = true ? "0.6.0" : "dev";
 export {
   APlayProvider,
   B1ChurchProvider,