@churchapps/content-provider-helper 0.0.3 → 0.0.4

package/dist/index.d.cts

@@ -52,7 +52,6 @@ interface ContentFolder {
     image?: string;
     isLeaf?: boolean;
     path: string;
-    providerData?: Record<string, unknown>;
 }
 interface ContentFile {
     type: "file";
@@ -66,7 +65,10 @@ interface ContentFile {
     decryptionKey?: string;
     mediaId?: string;
     pingbackUrl?: string;
-    providerData?: Record<string, unknown>;
+    seconds?: number;
+    loop?: boolean;
+    loopVideo?: boolean;
+    streamUrl?: string;
 }
 type ContentItem = ContentFolder | ContentFile;
 declare function isContentFolder(item: ContentItem): item is ContentFolder;
@@ -156,7 +158,6 @@ interface ProviderCapabilities {
     presentations: boolean;
     playlist: boolean;
     instructions: boolean;
-    expandedInstructions: boolean;
     mediaLicensing: boolean;
 }
 type MediaLicenseStatus = "valid" | "expired" | "not_licensed" | "unknown";
@@ -181,7 +182,6 @@ interface IProvider {
     getPresentations(path: string, auth?: ContentProviderAuthData | null): Promise<Plan | null>;
     getPlaylist?(path: string, auth?: ContentProviderAuthData | null, resolution?: number): Promise<ContentFile[] | null>;
     getInstructions?(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    getExpandedInstructions?(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     checkMediaLicense?(mediaId: string, auth?: ContentProviderAuthData | null): Promise<MediaLicenseResult | null>;
 }
 /**
@@ -196,7 +196,6 @@ interface IContentProvider {
     getPresentations(path: string, auth?: ContentProviderAuthData | null): Promise<Plan | null>;
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    getExpandedInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     requiresAuth(): boolean;
     getCapabilities(): ProviderCapabilities;
     checkMediaLicense(mediaId: string, auth?: ContentProviderAuthData | null): Promise<MediaLicenseResult | null>;
@@ -224,12 +223,15 @@ interface IAuthProvider {
 }
 
 declare function detectMediaType(url: string, explicitType?: string): "video" | "image";
-declare function createFolder(id: string, title: string, path: string, image?: string, providerData?: Record<string, unknown>, isLeaf?: boolean): ContentFolder;
+declare function createFolder(id: string, title: string, path: string, image?: string, isLeaf?: boolean): ContentFolder;
 declare function createFile(id: string, title: string, url: string, options?: {
     mediaType?: "video" | "image";
     image?: string;
     muxPlaybackId?: string;
-    providerData?: Record<string, unknown>;
+    seconds?: number;
+    loop?: boolean;
+    loopVideo?: boolean;
+    streamUrl?: string;
 }): ContentFile;
 
 /**
@@ -268,19 +270,60 @@ declare function buildPath(segments: string[]): string;
  */
 declare function appendToPath(basePath: string | null | undefined, segment: string): string;
 
+/**
+ * Navigate to a specific item using a dot-notation path.
+ * Path format: "0.2.1" means items[0].children[2].children[1]
+ */
+declare function navigateToPath(instructions: Instructions, path: string): InstructionItem | null;
+/**
+ * Generate a path string for an item given its position in the tree.
+ * Used when selecting an item to store its path.
+ */
+declare function generatePath(indices: number[]): string;
+
+interface DurationEstimationConfig {
+    secondsPerImage: number;
+    wordsPerMinute: number;
+}
+declare const DEFAULT_DURATION_CONFIG: DurationEstimationConfig;
+/**
+ * Count words in text (splits on whitespace)
+ */
+declare function countWords(text: string): number;
+/**
+ * Estimate duration for image content
+ * @returns Duration in seconds (default: 15)
+ */
+declare function estimateImageDuration(config?: Partial<DurationEstimationConfig>): number;
+/**
+ * Estimate duration for text content based on word count
+ * @param text - The text content
+ * @param config - Optional configuration overrides
+ * @returns Duration in seconds
+ */
+declare function estimateTextDuration(text: string, config?: Partial<DurationEstimationConfig>): number;
+/**
+ * Estimate duration based on media type
+ * @param mediaType - "video" | "image" | "text"
+ * @param options - Text content or word count for text estimation
+ * @returns Duration in seconds (0 for video/unknown)
+ */
+declare function estimateDuration(mediaType: "video" | "image" | "text", options?: {
+    text?: string;
+    wordCount?: number;
+    config?: Partial<DurationEstimationConfig>;
+}): number;
+
 declare function presentationsToPlaylist(plan: Plan): ContentFile[];
-declare function presentationsToInstructions(plan: Plan): Instructions;
 declare function presentationsToExpandedInstructions(plan: Plan): Instructions;
 declare function instructionsToPlaylist(instructions: Instructions): ContentFile[];
 declare const expandedInstructionsToPlaylist: typeof instructionsToPlaylist;
 declare function instructionsToPresentations(instructions: Instructions, planId?: string): Plan;
 declare const expandedInstructionsToPresentations: typeof instructionsToPresentations;
-declare function collapseInstructions(instructions: Instructions, maxDepth?: number): Instructions;
 declare function playlistToPresentations(files: ContentFile[], planName?: string, sectionName?: string): Plan;
 declare function playlistToInstructions(files: ContentFile[], venueName?: string): Instructions;
 declare const playlistToExpandedInstructions: typeof playlistToInstructions;
 
-declare const FormatConverters_collapseInstructions: typeof collapseInstructions;
 declare const FormatConverters_expandedInstructionsToPlaylist: typeof expandedInstructionsToPlaylist;
 declare const FormatConverters_expandedInstructionsToPresentations: typeof expandedInstructionsToPresentations;
 declare const FormatConverters_instructionsToPlaylist: typeof instructionsToPlaylist;
@@ -289,10 +332,9 @@ declare const FormatConverters_playlistToExpandedInstructions: typeof playlistTo
 declare const FormatConverters_playlistToInstructions: typeof playlistToInstructions;
 declare const FormatConverters_playlistToPresentations: typeof playlistToPresentations;
 declare const FormatConverters_presentationsToExpandedInstructions: typeof presentationsToExpandedInstructions;
-declare const FormatConverters_presentationsToInstructions: typeof presentationsToInstructions;
 declare const FormatConverters_presentationsToPlaylist: typeof presentationsToPlaylist;
 declare namespace FormatConverters {
-  export { FormatConverters_collapseInstructions as collapseInstructions, FormatConverters_expandedInstructionsToPlaylist as expandedInstructionsToPlaylist, FormatConverters_expandedInstructionsToPresentations as expandedInstructionsToPresentations, FormatConverters_instructionsToPlaylist as instructionsToPlaylist, FormatConverters_instructionsToPresentations as instructionsToPresentations, FormatConverters_playlistToExpandedInstructions as playlistToExpandedInstructions, FormatConverters_playlistToInstructions as playlistToInstructions, FormatConverters_playlistToPresentations as playlistToPresentations, FormatConverters_presentationsToExpandedInstructions as presentationsToExpandedInstructions, FormatConverters_presentationsToInstructions as presentationsToInstructions, FormatConverters_presentationsToPlaylist as presentationsToPlaylist };
+  export { FormatConverters_expandedInstructionsToPlaylist as expandedInstructionsToPlaylist, FormatConverters_expandedInstructionsToPresentations as expandedInstructionsToPresentations, FormatConverters_instructionsToPlaylist as instructionsToPlaylist, FormatConverters_instructionsToPresentations as instructionsToPresentations, FormatConverters_playlistToExpandedInstructions as playlistToExpandedInstructions, FormatConverters_playlistToInstructions as playlistToInstructions, FormatConverters_playlistToPresentations as playlistToPresentations, FormatConverters_presentationsToExpandedInstructions as presentationsToExpandedInstructions, FormatConverters_presentationsToPlaylist as presentationsToPlaylist };
 }
 
 interface FormatResolverOptions {
@@ -300,7 +342,7 @@ interface FormatResolverOptions {
 }
 interface ResolvedFormatMeta {
     isNative: boolean;
-    sourceFormat?: "playlist" | "presentations" | "instructions" | "expandedInstructions";
+    sourceFormat?: "playlist" | "presentations" | "instructions";
     isLossy: boolean;
 }
 declare class FormatResolver {
@@ -325,11 +367,6 @@ declare class FormatResolver {
         data: Instructions | null;
         meta: ResolvedFormatMeta;
     }>;
-    getExpandedInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    getExpandedInstructionsWithMeta(path: string, auth?: ContentProviderAuthData | null): Promise<{
-        data: Instructions | null;
-        meta: ResolvedFormatMeta;
-    }>;
 }
 
 declare class OAuthHelper {
@@ -357,7 +394,7 @@ declare class DeviceFlowHelper {
 
 declare class ApiHelper {
     createAuthHeaders(auth: ContentProviderAuthData | null | undefined): Record<string, string> | null;
-    apiRequest<T>(config: ContentProviderConfig, providerId: string, path: string, auth?: ContentProviderAuthData | null, method?: "GET" | "POST", body?: unknown): Promise<T | null>;
+    apiRequest<T>(config: ContentProviderConfig, _providerId: string, path: string, auth?: ContentProviderAuthData | null, method?: "GET" | "POST", body?: unknown): Promise<T | null>;
 }
 
 /**
@@ -378,7 +415,6 @@ declare abstract class ContentProvider implements IContentProvider, IAuthProvide
     abstract getPresentations(path: string, auth?: ContentProviderAuthData | null): Promise<Plan | null>;
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    getExpandedInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     requiresAuth(): boolean;
     getCapabilities(): ProviderCapabilities;
     checkMediaLicense(_mediaId: string, _auth?: ContentProviderAuthData | null): Promise<MediaLicenseResult | null>;
@@ -399,12 +435,15 @@ declare abstract class ContentProvider implements IContentProvider, IAuthProvide
     calculatePollDelay(baseInterval?: number, slowDownCount?: number): number;
     protected createAuthHeaders(auth: ContentProviderAuthData | null | undefined): Record<string, string> | null;
     protected apiRequest<T>(path: string, auth?: ContentProviderAuthData | null, method?: "GET" | "POST", body?: unknown): Promise<T | null>;
-    protected createFolder(id: string, title: string, path: string, image?: string, providerData?: Record<string, unknown>, isLeaf?: boolean): ContentFolder;
+    protected createFolder(id: string, title: string, path: string, image?: string, isLeaf?: boolean): ContentFolder;
     protected createFile(id: string, title: string, url: string, options?: {
         mediaType?: "video" | "image";
         image?: string;
         muxPlaybackId?: string;
-        providerData?: Record<string, unknown>;
+        seconds?: number;
+        loop?: boolean;
+        loopVideo?: boolean;
+        streamUrl?: string;
     }): ContentFile;
 }
 
@@ -434,6 +473,8 @@ declare class APlayProvider implements IProvider {
     private getLibraryFolders;
     private getMediaFiles;
     getPresentations(path: string, auth?: ContentProviderAuthData | null): Promise<Plan | null>;
+    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>;
 }
 
@@ -458,6 +499,8 @@ declare class SignPresenterProvider implements IProvider {
     private getPlaylists;
     private getMessages;
     getPresentations(path: string, auth?: ContentProviderAuthData | null): Promise<Plan | null>;
+    getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
+    getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
 }
 
 /**
@@ -496,7 +539,6 @@ declare class LessonsChurchProvider implements IProvider {
     private convertAddOnToFile;
     getPresentations(path: string, _auth?: ContentProviderAuthData | null): Promise<Plan | null>;
     getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    getExpandedInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     private normalizeItemType;
     private getEmbedUrl;
     private convertVenueToPlan;
@@ -525,8 +567,9 @@ declare class B1ChurchProvider implements IProvider {
     browse(path?: string | null, authData?: ContentProviderAuthData | null): Promise<ContentItem[]>;
     getPresentations(path: string, authData?: ContentProviderAuthData | null): Promise<Plan | null>;
     getInstructions(path: string, authData?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    getExpandedInstructions(path: string, authData?: ContentProviderAuthData | null): Promise<Instructions | null>;
     private processInstructionItems;
+    private findItemByPath;
+    private findPresentationByPath;
     getPlaylist(path: string, authData?: ContentProviderAuthData | null, resolution?: number): Promise<ContentFile[] | null>;
 }
 
@@ -558,6 +601,8 @@ declare class PlanningCenterProvider implements IProvider {
     private convertSongToPresentation;
     private convertMediaToPresentation;
     private formatDate;
+    getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
+    getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
 }
 
 /**
@@ -583,6 +628,7 @@ declare class BibleProjectProvider implements IProvider {
     private getVideoFile;
     getPresentations(path: string, _auth?: ContentProviderAuthData | null): Promise<Plan | null>;
     getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
+    getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     private slugify;
 }
 
@@ -611,7 +657,7 @@ declare class HighVoltageKidsProvider implements IProvider {
     private getLessonFiles;
     getPresentations(path: string, _auth?: ContentProviderAuthData | null): Promise<Plan | null>;
     getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
-    getExpandedInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
+    getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     private slugify;
     private groupFilesIntoActions;
     private getBaseName;
@@ -644,6 +690,6 @@ declare function getAvailableProviders(ids?: string[]): ProviderInfo[];
  * @churchapps/content-provider-helper
  * Helper classes for interacting with third party content providers
  */
-declare const VERSION = "0.0.1";
+declare const VERSION = "0.0.4";
 
-export { APlayProvider, ApiHelper, type AuthType, B1ChurchProvider, BibleProjectProvider, type ContentFile, type ContentFolder, type ContentItem, ContentProvider, type ContentProviderAuthData, type ContentProviderConfig, type DeviceAuthorizationResponse, DeviceFlowHelper, type DeviceFlowPollResult, type DeviceFlowState, type FeedActionInterface, type FeedFileInterface, type FeedSectionInterface, type FeedVenueInterface, FormatConverters, FormatResolver, type FormatResolverOptions, HighVoltageKidsProvider, type IAuthProvider, type IContentProvider, type IProvider, type InstructionItem, type Instructions, LessonsChurchProvider, type MediaLicenseResult, type MediaLicenseStatus, OAuthHelper, type Plan, type PlanPresentation, type PlanSection, PlanningCenterProvider, type ProviderCapabilities, type ProviderInfo, type ProviderLogos, type ResolvedFormatMeta, SignPresenterProvider, TokenHelper, VERSION, type VenueActionInterface, type VenueActionsResponseInterface, type VenueSectionActionsInterface, appendToPath, buildPath, collapseInstructions, createFile, createFolder, detectMediaType, expandedInstructionsToPlaylist, expandedInstructionsToPresentations, getAllProviders, getAvailableProviders, getProvider, getProviderConfig, getSegment, instructionsToPlaylist, instructionsToPresentations, isContentFile, isContentFolder, parsePath, playlistToExpandedInstructions, playlistToInstructions, playlistToPresentations, presentationsToExpandedInstructions, presentationsToInstructions, presentationsToPlaylist, registerProvider };
+export { APlayProvider, ApiHelper, type AuthType, B1ChurchProvider, BibleProjectProvider, type ContentFile, type ContentFolder, type ContentItem, ContentProvider, type ContentProviderAuthData, type ContentProviderConfig, DEFAULT_DURATION_CONFIG, type DeviceAuthorizationResponse, DeviceFlowHelper, type DeviceFlowPollResult, type DeviceFlowState, type DurationEstimationConfig, type FeedActionInterface, type FeedFileInterface, type FeedSectionInterface, type FeedVenueInterface, FormatConverters, FormatResolver, type FormatResolverOptions, HighVoltageKidsProvider, type IAuthProvider, type IContentProvider, type IProvider, type InstructionItem, type Instructions, LessonsChurchProvider, type MediaLicenseResult, type MediaLicenseStatus, OAuthHelper, type Plan, type PlanPresentation, type PlanSection, PlanningCenterProvider, type ProviderCapabilities, type ProviderInfo, type ProviderLogos, type ResolvedFormatMeta, SignPresenterProvider, TokenHelper, VERSION, type VenueActionInterface, type VenueActionsResponseInterface, type VenueSectionActionsInterface, appendToPath, buildPath, countWords, createFile, createFolder, detectMediaType, estimateDuration, estimateImageDuration, estimateTextDuration, expandedInstructionsToPlaylist, expandedInstructionsToPresentations, generatePath, getAllProviders, getAvailableProviders, getProvider, getProviderConfig, getSegment, instructionsToPlaylist, instructionsToPresentations, isContentFile, isContentFolder, navigateToPath, parsePath, playlistToExpandedInstructions, playlistToInstructions, playlistToPresentations, presentationsToExpandedInstructions, presentationsToPlaylist, registerProvider };

package/dist/index.d.ts

@@ -52,7 +52,6 @@ interface ContentFolder {
     image?: string;
     isLeaf?: boolean;
     path: string;
-    providerData?: Record<string, unknown>;
 }
 interface ContentFile {
     type: "file";
@@ -66,7 +65,10 @@ interface ContentFile {
     decryptionKey?: string;
     mediaId?: string;
     pingbackUrl?: string;
-    providerData?: Record<string, unknown>;
+    seconds?: number;
+    loop?: boolean;
+    loopVideo?: boolean;
+    streamUrl?: string;
 }
 type ContentItem = ContentFolder | ContentFile;
 declare function isContentFolder(item: ContentItem): item is ContentFolder;
@@ -156,7 +158,6 @@ interface ProviderCapabilities {
     presentations: boolean;
     playlist: boolean;
     instructions: boolean;
-    expandedInstructions: boolean;
     mediaLicensing: boolean;
 }
 type MediaLicenseStatus = "valid" | "expired" | "not_licensed" | "unknown";
@@ -181,7 +182,6 @@ interface IProvider {
     getPresentations(path: string, auth?: ContentProviderAuthData | null): Promise<Plan | null>;
     getPlaylist?(path: string, auth?: ContentProviderAuthData | null, resolution?: number): Promise<ContentFile[] | null>;
     getInstructions?(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    getExpandedInstructions?(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     checkMediaLicense?(mediaId: string, auth?: ContentProviderAuthData | null): Promise<MediaLicenseResult | null>;
 }
 /**
@@ -196,7 +196,6 @@ interface IContentProvider {
     getPresentations(path: string, auth?: ContentProviderAuthData | null): Promise<Plan | null>;
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    getExpandedInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     requiresAuth(): boolean;
     getCapabilities(): ProviderCapabilities;
     checkMediaLicense(mediaId: string, auth?: ContentProviderAuthData | null): Promise<MediaLicenseResult | null>;
@@ -224,12 +223,15 @@ interface IAuthProvider {
 }
 
 declare function detectMediaType(url: string, explicitType?: string): "video" | "image";
-declare function createFolder(id: string, title: string, path: string, image?: string, providerData?: Record<string, unknown>, isLeaf?: boolean): ContentFolder;
+declare function createFolder(id: string, title: string, path: string, image?: string, isLeaf?: boolean): ContentFolder;
 declare function createFile(id: string, title: string, url: string, options?: {
     mediaType?: "video" | "image";
     image?: string;
     muxPlaybackId?: string;
-    providerData?: Record<string, unknown>;
+    seconds?: number;
+    loop?: boolean;
+    loopVideo?: boolean;
+    streamUrl?: string;
 }): ContentFile;
 
 /**
@@ -268,19 +270,60 @@ declare function buildPath(segments: string[]): string;
  */
 declare function appendToPath(basePath: string | null | undefined, segment: string): string;
 
+/**
+ * Navigate to a specific item using a dot-notation path.
+ * Path format: "0.2.1" means items[0].children[2].children[1]
+ */
+declare function navigateToPath(instructions: Instructions, path: string): InstructionItem | null;
+/**
+ * Generate a path string for an item given its position in the tree.
+ * Used when selecting an item to store its path.
+ */
+declare function generatePath(indices: number[]): string;
+
+interface DurationEstimationConfig {
+    secondsPerImage: number;
+    wordsPerMinute: number;
+}
+declare const DEFAULT_DURATION_CONFIG: DurationEstimationConfig;
+/**
+ * Count words in text (splits on whitespace)
+ */
+declare function countWords(text: string): number;
+/**
+ * Estimate duration for image content
+ * @returns Duration in seconds (default: 15)
+ */
+declare function estimateImageDuration(config?: Partial<DurationEstimationConfig>): number;
+/**
+ * Estimate duration for text content based on word count
+ * @param text - The text content
+ * @param config - Optional configuration overrides
+ * @returns Duration in seconds
+ */
+declare function estimateTextDuration(text: string, config?: Partial<DurationEstimationConfig>): number;
+/**
+ * Estimate duration based on media type
+ * @param mediaType - "video" | "image" | "text"
+ * @param options - Text content or word count for text estimation
+ * @returns Duration in seconds (0 for video/unknown)
+ */
+declare function estimateDuration(mediaType: "video" | "image" | "text", options?: {
+    text?: string;
+    wordCount?: number;
+    config?: Partial<DurationEstimationConfig>;
+}): number;
+
 declare function presentationsToPlaylist(plan: Plan): ContentFile[];
-declare function presentationsToInstructions(plan: Plan): Instructions;
 declare function presentationsToExpandedInstructions(plan: Plan): Instructions;
 declare function instructionsToPlaylist(instructions: Instructions): ContentFile[];
 declare const expandedInstructionsToPlaylist: typeof instructionsToPlaylist;
 declare function instructionsToPresentations(instructions: Instructions, planId?: string): Plan;
 declare const expandedInstructionsToPresentations: typeof instructionsToPresentations;
-declare function collapseInstructions(instructions: Instructions, maxDepth?: number): Instructions;
 declare function playlistToPresentations(files: ContentFile[], planName?: string, sectionName?: string): Plan;
 declare function playlistToInstructions(files: ContentFile[], venueName?: string): Instructions;
 declare const playlistToExpandedInstructions: typeof playlistToInstructions;
 
-declare const FormatConverters_collapseInstructions: typeof collapseInstructions;
 declare const FormatConverters_expandedInstructionsToPlaylist: typeof expandedInstructionsToPlaylist;
 declare const FormatConverters_expandedInstructionsToPresentations: typeof expandedInstructionsToPresentations;
 declare const FormatConverters_instructionsToPlaylist: typeof instructionsToPlaylist;
@@ -289,10 +332,9 @@ declare const FormatConverters_playlistToExpandedInstructions: typeof playlistTo
 declare const FormatConverters_playlistToInstructions: typeof playlistToInstructions;
 declare const FormatConverters_playlistToPresentations: typeof playlistToPresentations;
 declare const FormatConverters_presentationsToExpandedInstructions: typeof presentationsToExpandedInstructions;
-declare const FormatConverters_presentationsToInstructions: typeof presentationsToInstructions;
 declare const FormatConverters_presentationsToPlaylist: typeof presentationsToPlaylist;
 declare namespace FormatConverters {
-  export { FormatConverters_collapseInstructions as collapseInstructions, FormatConverters_expandedInstructionsToPlaylist as expandedInstructionsToPlaylist, FormatConverters_expandedInstructionsToPresentations as expandedInstructionsToPresentations, FormatConverters_instructionsToPlaylist as instructionsToPlaylist, FormatConverters_instructionsToPresentations as instructionsToPresentations, FormatConverters_playlistToExpandedInstructions as playlistToExpandedInstructions, FormatConverters_playlistToInstructions as playlistToInstructions, FormatConverters_playlistToPresentations as playlistToPresentations, FormatConverters_presentationsToExpandedInstructions as presentationsToExpandedInstructions, FormatConverters_presentationsToInstructions as presentationsToInstructions, FormatConverters_presentationsToPlaylist as presentationsToPlaylist };
+  export { FormatConverters_expandedInstructionsToPlaylist as expandedInstructionsToPlaylist, FormatConverters_expandedInstructionsToPresentations as expandedInstructionsToPresentations, FormatConverters_instructionsToPlaylist as instructionsToPlaylist, FormatConverters_instructionsToPresentations as instructionsToPresentations, FormatConverters_playlistToExpandedInstructions as playlistToExpandedInstructions, FormatConverters_playlistToInstructions as playlistToInstructions, FormatConverters_playlistToPresentations as playlistToPresentations, FormatConverters_presentationsToExpandedInstructions as presentationsToExpandedInstructions, FormatConverters_presentationsToPlaylist as presentationsToPlaylist };
 }
 
 interface FormatResolverOptions {
@@ -300,7 +342,7 @@ interface FormatResolverOptions {
 }
 interface ResolvedFormatMeta {
     isNative: boolean;
-    sourceFormat?: "playlist" | "presentations" | "instructions" | "expandedInstructions";
+    sourceFormat?: "playlist" | "presentations" | "instructions";
     isLossy: boolean;
 }
 declare class FormatResolver {
@@ -325,11 +367,6 @@ declare class FormatResolver {
         data: Instructions | null;
         meta: ResolvedFormatMeta;
     }>;
-    getExpandedInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    getExpandedInstructionsWithMeta(path: string, auth?: ContentProviderAuthData | null): Promise<{
-        data: Instructions | null;
-        meta: ResolvedFormatMeta;
-    }>;
 }
 
 declare class OAuthHelper {
@@ -357,7 +394,7 @@ declare class DeviceFlowHelper {
 
 declare class ApiHelper {
     createAuthHeaders(auth: ContentProviderAuthData | null | undefined): Record<string, string> | null;
-    apiRequest<T>(config: ContentProviderConfig, providerId: string, path: string, auth?: ContentProviderAuthData | null, method?: "GET" | "POST", body?: unknown): Promise<T | null>;
+    apiRequest<T>(config: ContentProviderConfig, _providerId: string, path: string, auth?: ContentProviderAuthData | null, method?: "GET" | "POST", body?: unknown): Promise<T | null>;
 }
 
 /**
@@ -378,7 +415,6 @@ declare abstract class ContentProvider implements IContentProvider, IAuthProvide
     abstract getPresentations(path: string, auth?: ContentProviderAuthData | null): Promise<Plan | null>;
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    getExpandedInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     requiresAuth(): boolean;
     getCapabilities(): ProviderCapabilities;
     checkMediaLicense(_mediaId: string, _auth?: ContentProviderAuthData | null): Promise<MediaLicenseResult | null>;
@@ -399,12 +435,15 @@ declare abstract class ContentProvider implements IContentProvider, IAuthProvide
     calculatePollDelay(baseInterval?: number, slowDownCount?: number): number;
     protected createAuthHeaders(auth: ContentProviderAuthData | null | undefined): Record<string, string> | null;
     protected apiRequest<T>(path: string, auth?: ContentProviderAuthData | null, method?: "GET" | "POST", body?: unknown): Promise<T | null>;
-    protected createFolder(id: string, title: string, path: string, image?: string, providerData?: Record<string, unknown>, isLeaf?: boolean): ContentFolder;
+    protected createFolder(id: string, title: string, path: string, image?: string, isLeaf?: boolean): ContentFolder;
     protected createFile(id: string, title: string, url: string, options?: {
         mediaType?: "video" | "image";
         image?: string;
         muxPlaybackId?: string;
-        providerData?: Record<string, unknown>;
+        seconds?: number;
+        loop?: boolean;
+        loopVideo?: boolean;
+        streamUrl?: string;
     }): ContentFile;
 }
 
@@ -434,6 +473,8 @@ declare class APlayProvider implements IProvider {
     private getLibraryFolders;
     private getMediaFiles;
     getPresentations(path: string, auth?: ContentProviderAuthData | null): Promise<Plan | null>;
+    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>;
 }
 
@@ -458,6 +499,8 @@ declare class SignPresenterProvider implements IProvider {
     private getPlaylists;
     private getMessages;
     getPresentations(path: string, auth?: ContentProviderAuthData | null): Promise<Plan | null>;
+    getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
+    getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
 }
 
 /**
@@ -496,7 +539,6 @@ declare class LessonsChurchProvider implements IProvider {
     private convertAddOnToFile;
     getPresentations(path: string, _auth?: ContentProviderAuthData | null): Promise<Plan | null>;
     getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    getExpandedInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     private normalizeItemType;
     private getEmbedUrl;
     private convertVenueToPlan;
@@ -525,8 +567,9 @@ declare class B1ChurchProvider implements IProvider {
     browse(path?: string | null, authData?: ContentProviderAuthData | null): Promise<ContentItem[]>;
     getPresentations(path: string, authData?: ContentProviderAuthData | null): Promise<Plan | null>;
     getInstructions(path: string, authData?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    getExpandedInstructions(path: string, authData?: ContentProviderAuthData | null): Promise<Instructions | null>;
     private processInstructionItems;
+    private findItemByPath;
+    private findPresentationByPath;
     getPlaylist(path: string, authData?: ContentProviderAuthData | null, resolution?: number): Promise<ContentFile[] | null>;
 }
 
@@ -558,6 +601,8 @@ declare class PlanningCenterProvider implements IProvider {
     private convertSongToPresentation;
     private convertMediaToPresentation;
     private formatDate;
+    getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
+    getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
 }
 
 /**
@@ -583,6 +628,7 @@ declare class BibleProjectProvider implements IProvider {
     private getVideoFile;
     getPresentations(path: string, _auth?: ContentProviderAuthData | null): Promise<Plan | null>;
     getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
+    getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     private slugify;
 }
 
@@ -611,7 +657,7 @@ declare class HighVoltageKidsProvider implements IProvider {
     private getLessonFiles;
     getPresentations(path: string, _auth?: ContentProviderAuthData | null): Promise<Plan | null>;
     getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
-    getExpandedInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
+    getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     private slugify;
     private groupFilesIntoActions;
     private getBaseName;
@@ -644,6 +690,6 @@ declare function getAvailableProviders(ids?: string[]): ProviderInfo[];
  * @churchapps/content-provider-helper
  * Helper classes for interacting with third party content providers
  */
-declare const VERSION = "0.0.1";
+declare const VERSION = "0.0.4";
 
-export { APlayProvider, ApiHelper, type AuthType, B1ChurchProvider, BibleProjectProvider, type ContentFile, type ContentFolder, type ContentItem, ContentProvider, type ContentProviderAuthData, type ContentProviderConfig, type DeviceAuthorizationResponse, DeviceFlowHelper, type DeviceFlowPollResult, type DeviceFlowState, type FeedActionInterface, type FeedFileInterface, type FeedSectionInterface, type FeedVenueInterface, FormatConverters, FormatResolver, type FormatResolverOptions, HighVoltageKidsProvider, type IAuthProvider, type IContentProvider, type IProvider, type InstructionItem, type Instructions, LessonsChurchProvider, type MediaLicenseResult, type MediaLicenseStatus, OAuthHelper, type Plan, type PlanPresentation, type PlanSection, PlanningCenterProvider, type ProviderCapabilities, type ProviderInfo, type ProviderLogos, type ResolvedFormatMeta, SignPresenterProvider, TokenHelper, VERSION, type VenueActionInterface, type VenueActionsResponseInterface, type VenueSectionActionsInterface, appendToPath, buildPath, collapseInstructions, createFile, createFolder, detectMediaType, expandedInstructionsToPlaylist, expandedInstructionsToPresentations, getAllProviders, getAvailableProviders, getProvider, getProviderConfig, getSegment, instructionsToPlaylist, instructionsToPresentations, isContentFile, isContentFolder, parsePath, playlistToExpandedInstructions, playlistToInstructions, playlistToPresentations, presentationsToExpandedInstructions, presentationsToInstructions, presentationsToPlaylist, registerProvider };
+export { APlayProvider, ApiHelper, type AuthType, B1ChurchProvider, BibleProjectProvider, type ContentFile, type ContentFolder, type ContentItem, ContentProvider, type ContentProviderAuthData, type ContentProviderConfig, DEFAULT_DURATION_CONFIG, type DeviceAuthorizationResponse, DeviceFlowHelper, type DeviceFlowPollResult, type DeviceFlowState, type DurationEstimationConfig, type FeedActionInterface, type FeedFileInterface, type FeedSectionInterface, type FeedVenueInterface, FormatConverters, FormatResolver, type FormatResolverOptions, HighVoltageKidsProvider, type IAuthProvider, type IContentProvider, type IProvider, type InstructionItem, type Instructions, LessonsChurchProvider, type MediaLicenseResult, type MediaLicenseStatus, OAuthHelper, type Plan, type PlanPresentation, type PlanSection, PlanningCenterProvider, type ProviderCapabilities, type ProviderInfo, type ProviderLogos, type ResolvedFormatMeta, SignPresenterProvider, TokenHelper, VERSION, type VenueActionInterface, type VenueActionsResponseInterface, type VenueSectionActionsInterface, appendToPath, buildPath, countWords, createFile, createFolder, detectMediaType, estimateDuration, estimateImageDuration, estimateTextDuration, expandedInstructionsToPlaylist, expandedInstructionsToPresentations, generatePath, getAllProviders, getAvailableProviders, getProvider, getProviderConfig, getSegment, instructionsToPlaylist, instructionsToPresentations, isContentFile, isContentFolder, navigateToPath, parsePath, playlistToExpandedInstructions, playlistToInstructions, playlistToPresentations, presentationsToExpandedInstructions, presentationsToPlaylist, registerProvider };