@editframe/elements 0.24.1-beta.0 → 0.25.1-beta.0

package/dist/transcoding/cache/RequestDeduplicator.js

@@ -1,7 +1,17 @@
+//#region src/transcoding/cache/RequestDeduplicator.ts
+/**
+* Request deduplication utility
+* Manages pending requests to prevent concurrent duplicate requests
+*/
 var RequestDeduplicator = class {
 	constructor() {
 		this.pendingRequests = /* @__PURE__ */ new Map();
 	}
+	/**
+	* Execute a request with deduplication
+	* If a request with the same key is already pending, return the existing promise
+	* Otherwise, execute the request factory and track the promise
+	*/
 	async executeRequest(key, requestFactory) {
 		const existingRequest = this.pendingRequests.get(key);
 		if (existingRequest) return existingRequest;
@@ -16,17 +26,32 @@ var RequestDeduplicator = class {
 			throw error;
 		}
 	}
+	/**
+	* Clear all pending requests (used in cache clearing)
+	*/
 	clear() {
 		this.pendingRequests.clear();
 	}
+	/**
+	* Get number of pending requests
+	*/
 	getPendingCount() {
 		return this.pendingRequests.size;
 	}
+	/**
+	* Check if a request is pending
+	*/
 	isPending(key) {
 		return this.pendingRequests.has(key);
 	}
+	/**
+	* Get all pending request keys
+	*/
 	getPendingKeys() {
 		return Array.from(this.pendingRequests.keys());
 	}
 };
+
+//#endregion
 export { RequestDeduplicator };
+//# sourceMappingURL=RequestDeduplicator.js.map

package/dist/transcoding/cache/RequestDeduplicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestDeduplicator.js","names":[],"sources":["../../../src/transcoding/cache/RequestDeduplicator.ts"],"sourcesContent":["/**\n * Request deduplication utility\n * Manages pending requests to prevent concurrent duplicate requests\n */\n\nexport class RequestDeduplicator {\n  private pendingRequests = new Map<string, Promise<any>>();\n\n  /**\n   * Execute a request with deduplication\n   * If a request with the same key is already pending, return the existing promise\n   * Otherwise, execute the request factory and track the promise\n   */\n  async executeRequest<T>(\n    key: string,\n    requestFactory: () => Promise<T>,\n  ): Promise<T> {\n    // Check if there's already a pending request for this key\n    const existingRequest = this.pendingRequests.get(key);\n    if (existingRequest) {\n      return existingRequest;\n    }\n\n    // Create and track the new request\n    const requestPromise = requestFactory();\n    this.pendingRequests.set(key, requestPromise);\n\n    try {\n      const result = await requestPromise;\n      this.pendingRequests.delete(key);\n      return result;\n    } catch (error) {\n      this.pendingRequests.delete(key);\n      throw error;\n    }\n  }\n\n  /**\n   * Clear all pending requests (used in cache clearing)\n   */\n  clear(): void {\n    this.pendingRequests.clear();\n  }\n\n  /**\n   * Get number of pending requests\n   */\n  getPendingCount(): number {\n    return this.pendingRequests.size;\n  }\n\n  /**\n   * Check if a request is pending\n   */\n  isPending(key: string): boolean {\n    return this.pendingRequests.has(key);\n  }\n\n  /**\n   * Get all pending request keys\n   */\n  getPendingKeys(): string[] {\n    return Array.from(this.pendingRequests.keys());\n  }\n}\n"],"mappings":";;;;;AAKA,IAAa,sBAAb,MAAiC;;yCACL,IAAI,KAA2B;;;;;;;CAOzD,MAAM,eACJ,KACA,gBACY;EAEZ,MAAM,kBAAkB,KAAK,gBAAgB,IAAI,IAAI;AACrD,MAAI,gBACF,QAAO;EAIT,MAAM,iBAAiB,gBAAgB;AACvC,OAAK,gBAAgB,IAAI,KAAK,eAAe;AAE7C,MAAI;GACF,MAAM,SAAS,MAAM;AACrB,QAAK,gBAAgB,OAAO,IAAI;AAChC,UAAO;WACA,OAAO;AACd,QAAK,gBAAgB,OAAO,IAAI;AAChC,SAAM;;;;;;CAOV,QAAc;AACZ,OAAK,gBAAgB,OAAO;;;;;CAM9B,kBAA0B;AACxB,SAAO,KAAK,gBAAgB;;;;;CAM9B,UAAU,KAAsB;AAC9B,SAAO,KAAK,gBAAgB,IAAI,IAAI;;;;;CAMtC,iBAA2B;AACzB,SAAO,MAAM,KAAK,KAAK,gBAAgB,MAAM,CAAC"}

package/dist/transcoding/cache/URLTokenDeduplicator.js

@@ -1,7 +1,12 @@
+//#region src/transcoding/cache/URLTokenDeduplicator.ts
 var URLTokenDeduplicator = class {
 	constructor() {
 		this.tokenCache = /* @__PURE__ */ new Map();
 	}
+	/**
+	* Get or create a URL token with global deduplication
+	* Multiple requests for the same cache key will share the same token promise
+	*/
 	async getToken(cacheKey, tokenFactory, parseExpiration) {
 		const now = Date.now();
 		const cached = this.tokenCache.get(cacheKey);
@@ -23,24 +28,42 @@ var URLTokenDeduplicator = class {
 		});
 		return tokenPromise;
 	}
+	/**
+	* Clear all cached tokens (used in testing)
+	*/
 	clear() {
 		this.tokenCache.clear();
 	}
+	/**
+	* Get number of cached tokens
+	*/
 	getCachedCount() {
 		return this.tokenCache.size;
 	}
+	/**
+	* Check if a token is cached and valid
+	*/
 	hasValidToken(cacheKey) {
 		const cached = this.tokenCache.get(cacheKey);
 		if (!cached) return false;
 		return Date.now() < cached.expiration;
 	}
+	/**
+	* Get all cached token keys
+	*/
 	getCachedKeys() {
 		return Array.from(this.tokenCache.keys());
 	}
+	/**
+	* Remove expired tokens from cache
+	*/
 	cleanup() {
 		const now = Date.now();
 		for (const [key, entry] of this.tokenCache.entries()) if (now >= entry.expiration) this.tokenCache.delete(key);
 	}
 };
 const globalURLTokenDeduplicator = new URLTokenDeduplicator();
+
+//#endregion
 export { globalURLTokenDeduplicator };
+//# sourceMappingURL=URLTokenDeduplicator.js.map

package/dist/transcoding/cache/URLTokenDeduplicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"URLTokenDeduplicator.js","names":[],"sources":["../../../src/transcoding/cache/URLTokenDeduplicator.ts"],"sourcesContent":["/**\n * Global URL token deduplication utility\n * Ensures that multiple EFMedia elements requesting tokens for the same resource\n * share a single token request, preventing unnecessary duplicate token generation\n */\n\nexport interface TokenCacheEntry {\n  tokenPromise: Promise<string>;\n  expiration: number;\n}\n\nexport class URLTokenDeduplicator {\n  private tokenCache = new Map<string, TokenCacheEntry>();\n\n  /**\n   * Get or create a URL token with global deduplication\n   * Multiple requests for the same cache key will share the same token promise\n   */\n  async getToken(\n    cacheKey: string,\n    tokenFactory: () => Promise<string>,\n    parseExpiration: (token: string) => number,\n  ): Promise<string> {\n    const now = Date.now();\n    const cached = this.tokenCache.get(cacheKey);\n\n    // Check if we have a valid cached token\n    if (cached && now < cached.expiration) {\n      return cached.tokenPromise;\n    }\n\n    // Create new token request\n    const tokenPromise = tokenFactory()\n      .then(async (token) => {\n        // Update expiration after we get the token\n        const expiration = parseExpiration(token);\n        this.tokenCache.set(cacheKey, { tokenPromise, expiration });\n        return token;\n      })\n      .catch((error) => {\n        // Remove failed request from cache\n        this.tokenCache.delete(cacheKey);\n        throw error;\n      });\n\n    // Cache the promise immediately to deduplicate concurrent requests\n    this.tokenCache.set(cacheKey, {\n      tokenPromise,\n      expiration: now + 60000, // Temporary 1-minute expiration, will be updated when token is received\n    });\n\n    return tokenPromise;\n  }\n\n  /**\n   * Clear all cached tokens (used in testing)\n   */\n  clear(): void {\n    this.tokenCache.clear();\n  }\n\n  /**\n   * Get number of cached tokens\n   */\n  getCachedCount(): number {\n    return this.tokenCache.size;\n  }\n\n  /**\n   * Check if a token is cached and valid\n   */\n  hasValidToken(cacheKey: string): boolean {\n    const cached = this.tokenCache.get(cacheKey);\n    if (!cached) return false;\n\n    const now = Date.now();\n    return now < cached.expiration;\n  }\n\n  /**\n   * Get all cached token keys\n   */\n  getCachedKeys(): string[] {\n    return Array.from(this.tokenCache.keys());\n  }\n\n  /**\n   * Remove expired tokens from cache\n   */\n  cleanup(): void {\n    const now = Date.now();\n    for (const [key, entry] of this.tokenCache.entries()) {\n      if (now >= entry.expiration) {\n        this.tokenCache.delete(key);\n      }\n    }\n  }\n}\n\n// Global instance shared across all context providers\nexport const globalURLTokenDeduplicator = new URLTokenDeduplicator();\n"],"mappings":";AAWA,IAAa,uBAAb,MAAkC;;oCACX,IAAI,KAA8B;;;;;;CAMvD,MAAM,SACJ,UACA,cACA,iBACiB;EACjB,MAAM,MAAM,KAAK,KAAK;EACtB,MAAM,SAAS,KAAK,WAAW,IAAI,SAAS;AAG5C,MAAI,UAAU,MAAM,OAAO,WACzB,QAAO,OAAO;EAIhB,MAAM,eAAe,cAAc,CAChC,KAAK,OAAO,UAAU;GAErB,MAAM,aAAa,gBAAgB,MAAM;AACzC,QAAK,WAAW,IAAI,UAAU;IAAE;IAAc;IAAY,CAAC;AAC3D,UAAO;IACP,CACD,OAAO,UAAU;AAEhB,QAAK,WAAW,OAAO,SAAS;AAChC,SAAM;IACN;AAGJ,OAAK,WAAW,IAAI,UAAU;GAC5B;GACA,YAAY,MAAM;GACnB,CAAC;AAEF,SAAO;;;;;CAMT,QAAc;AACZ,OAAK,WAAW,OAAO;;;;;CAMzB,iBAAyB;AACvB,SAAO,KAAK,WAAW;;;;;CAMzB,cAAc,UAA2B;EACvC,MAAM,SAAS,KAAK,WAAW,IAAI,SAAS;AAC5C,MAAI,CAAC,OAAQ,QAAO;AAGpB,SADY,KAAK,KAAK,GACT,OAAO;;;;;CAMtB,gBAA0B;AACxB,SAAO,MAAM,KAAK,KAAK,WAAW,MAAM,CAAC;;;;;CAM3C,UAAgB;EACd,MAAM,MAAM,KAAK,KAAK;AACtB,OAAK,MAAM,CAAC,KAAK,UAAU,KAAK,WAAW,SAAS,CAClD,KAAI,OAAO,MAAM,WACf,MAAK,WAAW,OAAO,IAAI;;;AAOnC,MAAa,6BAA6B,IAAI,sBAAsB"}

package/dist/transcoding/types/index.d.ts

@@ -1,276 +1,102 @@
-import { MediaRendition } from '../../elements/EFMedia/shared/MediaTaskUtils';
-export interface QualityPreset {
-    name: string;
-    width: number;
-    height: number;
-    videoBitrate: number;
-    audioBitrate: number;
-    audioChannels: number;
-    audioSampleRate: number;
-    audioCodec: "aac";
-}
-export type RenditionId = "high" | "medium" | "low" | "audio" | "scrub";
-export interface VideoMetadata {
-    url: string;
-    durationMs: number;
-    streams: Array<{
-        index: number;
-        type: "video" | "audio" | "subtitle" | "other";
-        codecName: string;
-        duration: number;
-        durationMs: number;
-        width?: number;
-        height?: number;
-        frameRate?: {
-            num: number;
-            den: number;
-        };
-        channels?: number;
-        sampleRate?: number;
-    }>;
-    presets: string[];
-    segmentDuration: number;
-    supportedFormats: string[];
-    extractedAt: string;
-}
-export interface JitTranscodingConfig {
-    baseUrl: string;
-    defaultQuality: keyof QualityPresets;
-    segmentCacheSize: number;
-    enableNetworkAdaptation: boolean;
-    enablePrefetch: boolean;
-    prefetchSegments: number;
-}
-export interface QualityPresets {
-    low: QualityPreset;
-    medium: QualityPreset;
-    high: QualityPreset;
-    scrub: QualityPreset;
-}
-export interface NetworkCondition {
-    bandwidth: number;
-    rtt: number;
-    connectionType: string;
-}
-export interface SegmentInfo {
-    url: string;
-    startTimeMs: number;
-    durationMs: number;
-    quality: string;
-    cached: boolean;
-}
-export interface ManifestVideoRendition {
-    /** Unique identifier for the video rendition */
-    id: string;
-    /** Duration of each segment in milliseconds */
-    segmentDuration: number;
-    /** Duration of each segment in milliseconds */
-    segmentDurationMs: number;
-    /** Actual segment durations array (overrides fixed segmentDurationMs if provided) */
-    segmentDurationsMs?: number[];
-    /** Video width in pixels */
-    width: number;
-    /** Video height in pixels */
-    height: number;
-    /** Target bitrate in bits per second */
-    bitrate: number;
-    /** Video codec string (e.g., "avc1.640029") */
-    codec: string;
-    /** Container format (e.g., "video/mp4") */
-    container: string;
-    /** Complete MIME type with codecs */
-    mimeType: string;
-    /** Optional frame rate */
-    frameRate?: number;
-    /** Optional profile indication */
-    profile?: string;
-    /** Optional level indication */
-    level?: string;
-}
-export interface ManifestAudioRendition {
-    /** Unique identifier for the audio rendition */
-    id: string;
-    /** Duration of each segment in milliseconds */
-    segmentDuration: number;
-    /** Duration of each segment in milliseconds */
-    segmentDurationMs: number;
-    /** Actual segment durations array (overrides fixed segmentDurationMs if provided) */
-    segmentDurationsMs?: number[];
-    /** Number of audio channels */
-    channels: number;
-    /** Sample rate in Hz */
-    sampleRate: number;
-    /** Target bitrate in bits per second */
-    bitrate: number;
-    /** Audio codec string (e.g., "mp4a.40.2") */
-    codec: string;
-    /** Container format (e.g., "audio/mp4") */
-    container: string;
-    /** Complete MIME type with codecs */
-    mimeType: string;
-    /** Optional language code */
-    language?: string;
-}
-/**
- * CMAF Manifest Response Structure
- * Matches the server response from /api/v1/transcode/manifest.json
- */
-export interface ManifestResponse {
-    /** Manifest version for compatibility tracking */
-    version: string;
-    /** Type of manifest (e.g., "cmaf", "dash", "hls") */
-    type: string;
-    /** Original source URL for the media */
-    sourceUrl: string;
-    /** Total duration of the content in milliseconds */
-    duration: number;
-    /** Total duration of the content in milliseconds */
-    durationMs: number;
-    /** Duration of each segment in milliseconds */
-    segmentDuration: number;
-    /** Base URL for all relative URLs */
-    baseUrl: string;
-    /** Video renditions available for adaptive streaming */
-    videoRenditions: ManifestVideoRendition[];
-    /** Audio renditions available for adaptive streaming */
-    audioRenditions: ManifestAudioRendition[];
-    /** URL templates for segment access */
-    endpoints: {
-        /** Initialization segment URL template with {rendition} placeholder */
-        initSegment: string;
-        /** Media segment URL template with {rendition} and {segmentId} placeholders */
-        mediaSegment: string;
-    };
-    /** JIT transcoding specific information */
-    jitInfo: {
-        /** Whether parallel transcoding is supported */
-        parallelTranscodingSupported: boolean;
-        /** Expected transcoding latency in milliseconds */
-        expectedTranscodeLatency: number;
-        /** Total number of segments */
-        segmentCount: number;
-    };
-    /** Optional timescale for the media timeline */
-    timescale?: number;
-    /** Optional start number for segments */
-    startNumber?: number;
-    /** Optional minimum buffer time in milliseconds */
-    minBufferTime?: number;
-    /** Optional suggested presentation delay in milliseconds */
-    suggestedPresentationDelay?: number;
-}
-/**
- * Cache statistics interface
- */
-export interface CacheStats {
-    size: number;
-    maxSize: number;
-    hitRate: number;
-    efficiency: number;
-    totalRequests: number;
-    recentKeys: string[];
-}
-export interface AudioRendition {
+import { MediaRendition } from "../../elements/EFMedia/shared/MediaTaskUtils.js";
+
+//#region src/transcoding/types/index.d.ts
+
+type RenditionId = "high" | "medium" | "low" | "audio" | "scrub";
+interface AudioRendition {
+  id?: RenditionId;
+  trackId: number | undefined;
+  src: string;
+  segmentDurationMs?: number;
+  segmentDurationsMs?: number[];
+  startTimeOffsetMs?: number;
+}
+interface VideoRendition {
+  id?: RenditionId;
+  trackId: number | undefined;
+  src: string;
+  segmentDurationMs?: number;
+  segmentDurationsMs?: number[];
+  startTimeOffsetMs?: number;
+}
+interface MediaEngine {
+  durationMs: number;
+  src: string;
+  audioRendition?: AudioRendition;
+  videoRendition?: VideoRendition;
+  templates: {
+    initSegment: string;
+    mediaSegment: string;
+  };
+  fetchInitSegment: (rendition: {
     id?: RenditionId;
     trackId: number | undefined;
     src: string;
-    segmentDurationMs?: number;
-    segmentDurationsMs?: number[];
-    startTimeOffsetMs?: number;
-}
-export interface VideoRendition {
+  }, signal: AbortSignal) => Promise<ArrayBuffer>;
+  fetchMediaSegment: (segmentId: number, rendition: {
     id?: RenditionId;
     trackId: number | undefined;
     src: string;
-    segmentDurationMs?: number;
-    segmentDurationsMs?: number[];
-    startTimeOffsetMs?: number;
-}
-export interface MediaEngine {
-    durationMs: number;
-    src: string;
-    audioRendition?: AudioRendition;
-    videoRendition?: VideoRendition;
-    templates: {
-        initSegment: string;
-        mediaSegment: string;
-    };
-    fetchInitSegment: (rendition: {
-        id?: RenditionId;
-        trackId: number | undefined;
-        src: string;
-    }, signal: AbortSignal) => Promise<ArrayBuffer>;
-    fetchMediaSegment: (segmentId: number, rendition: {
-        id?: RenditionId;
-        trackId: number | undefined;
-        src: string;
-    }, signal?: AbortSignal) => Promise<ArrayBuffer>;
-    computeSegmentId: (desiredSeekTimeMs: number, rendition: MediaRendition) => number | undefined;
-    /**
-     * Get the video rendition if available, otherwise return undefined.
-     * Callers should handle undefined appropriately.
-     */
-    getVideoRendition: () => VideoRendition | undefined;
-    /**
-     * Get the audio rendition if available, otherwise return undefined.
-     * Callers should handle undefined appropriately.
-     */
-    getAudioRendition: () => AudioRendition | undefined;
-    /**
-     * Check if a segment is cached for a given rendition
-     */
-    isSegmentCached: (segmentId: number, rendition: AudioRendition | VideoRendition) => boolean;
-    /**
-     * Get scrub video rendition if available, otherwise return undefined
-     * Each engine implements this based on their capabilities:
-     * - JitMediaEngine: looks for "scrub" rendition in manifest
-     * - AssetMediaEngine: returns regular video rendition (no separate scrub)
-     */
-    getScrubVideoRendition(): VideoRendition | undefined;
-    /**
-     * Calculate audio segments needed for a time range
-     * Each media engine implements this based on their segment structure
-     */
-    calculateAudioSegmentRange: (fromMs: number, toMs: number, rendition: AudioRendition, durationMs: number) => SegmentTimeRange[];
-    /**
-     * Get buffer configuration for this media engine
-     * Returns preferred buffer settings that may override host defaults
-     */
-    getBufferConfig: () => {
-        videoBufferDurationMs: number;
-        audioBufferDurationMs: number;
-        maxVideoBufferFetches: number;
-        maxAudioBufferFetches: number;
-    };
-    /**
-     * Extract thumbnail canvases at multiple timestamps efficiently
-     * Uses scrub rendition and batches by segment for optimal performance
-     * Returns thumbnail objects in same order as input timestamps
-     * Returns null for any timestamps that fail to extract
-     */
-    extractThumbnails(timestamps: number[]): Promise<(ThumbnailResult | null)[]>;
-}
-export interface ThumbnailResult {
-    timestamp: number;
-    thumbnail: HTMLCanvasElement | OffscreenCanvas;
-}
-interface InitSegmentPath {
-    path: string;
-    pos: number;
-    size: number;
-}
-export interface InitSegmentPaths {
-    audio?: InitSegmentPath;
-    video?: InitSegmentPath;
-}
-export interface AudioSpan {
-    startMs: number;
-    endMs: number;
-    blob: Blob;
-}
-export interface SegmentTimeRange {
-    segmentId: number;
-    startMs: number;
-    endMs: number;
-}
-export {};
+  }, signal?: AbortSignal) => Promise<ArrayBuffer>;
+  computeSegmentId: (desiredSeekTimeMs: number, rendition: MediaRendition) => number | undefined;
+  /**
+   * Get the video rendition if available, otherwise return undefined.
+   * Callers should handle undefined appropriately.
+   */
+  getVideoRendition: () => VideoRendition | undefined;
+  /**
+   * Get the audio rendition if available, otherwise return undefined.
+   * Callers should handle undefined appropriately.
+   */
+  getAudioRendition: () => AudioRendition | undefined;
+  /**
+   * Check if a segment is cached for a given rendition
+   */
+  isSegmentCached: (segmentId: number, rendition: AudioRendition | VideoRendition) => boolean;
+  /**
+   * Get scrub video rendition if available, otherwise return undefined
+   * Each engine implements this based on their capabilities:
+   * - JitMediaEngine: looks for "scrub" rendition in manifest
+   * - AssetMediaEngine: returns regular video rendition (no separate scrub)
+   */
+  getScrubVideoRendition(): VideoRendition | undefined;
+  /**
+   * Calculate audio segments needed for a time range
+   * Each media engine implements this based on their segment structure
+   */
+  calculateAudioSegmentRange: (fromMs: number, toMs: number, rendition: AudioRendition, durationMs: number) => SegmentTimeRange[];
+  /**
+   * Get buffer configuration for this media engine
+   * Returns preferred buffer settings that may override host defaults
+   */
+  getBufferConfig: () => {
+    videoBufferDurationMs: number;
+    audioBufferDurationMs: number;
+    maxVideoBufferFetches: number;
+    maxAudioBufferFetches: number;
+  };
+  /**
+   * Extract thumbnail canvases at multiple timestamps efficiently
+   * Uses scrub rendition and batches by segment for optimal performance
+   * Returns thumbnail objects in same order as input timestamps
+   * Returns null for any timestamps that fail to extract
+   */
+  extractThumbnails(timestamps: number[]): Promise<(ThumbnailResult | null)[]>;
+}
+interface ThumbnailResult {
+  timestamp: number;
+  thumbnail: HTMLCanvasElement | OffscreenCanvas;
+}
+interface AudioSpan {
+  startMs: number;
+  endMs: number;
+  blob: Blob;
+}
+interface SegmentTimeRange {
+  segmentId: number;
+  startMs: number;
+  endMs: number;
+}
+//#endregion
+export { AudioRendition, AudioSpan, MediaEngine, RenditionId, VideoRendition };
+//# sourceMappingURL=index.d.ts.map

package/dist/transcoding/utils/UrlGenerator.d.ts

@@ -1,26 +1,31 @@
-import { RenditionId } from '../types/index.js';
-import { MediaEngine } from '../types/index.ts';
-export declare class UrlGenerator {
-    private baseUrl;
-    constructor(baseUrl: () => string);
-    /**
-     * Generate video segment URL
-     */
-    generateSegmentUrl(segmentId: "init" | number, renditionId: RenditionId, metadata: MediaEngine): string;
-    /**
-     * Generate init segment URL
-     */
-    generateInitSegmentUrl(mediaUrl: string, rendition: string): string;
-    /**
-     * Generate manifest URL
-     */
-    generateManifestUrl(mediaUrl: string): string;
-    /**
-     * Generate track fragment index URL
-     */
-    generateTrackFragmentIndexUrl(mediaUrl: string): string;
-    /**
-     * Generate quality presets URL
-     */
-    generatePresetsUrl(): string;
+import { MediaEngine, RenditionId } from "../types/index.js";
+
+//#region src/transcoding/utils/UrlGenerator.d.ts
+
+declare class UrlGenerator {
+  private baseUrl;
+  constructor(baseUrl: () => string);
+  /**
+   * Generate video segment URL
+   */
+  generateSegmentUrl(segmentId: "init" | number, renditionId: RenditionId, metadata: MediaEngine): string;
+  /**
+   * Generate init segment URL
+   */
+  generateInitSegmentUrl(mediaUrl: string, rendition: string): string;
+  /**
+   * Generate manifest URL
+   */
+  generateManifestUrl(mediaUrl: string): string;
+  /**
+   * Generate track fragment index URL
+   */
+  generateTrackFragmentIndexUrl(mediaUrl: string): string;
+  /**
+   * Generate quality presets URL
+   */
+  generatePresetsUrl(): string;
 }
+//#endregion
+export { UrlGenerator };
+//# sourceMappingURL=UrlGenerator.d.ts.map

package/dist/transcoding/utils/UrlGenerator.js

@@ -1,7 +1,11 @@
+//#region src/transcoding/utils/UrlGenerator.ts
 var UrlGenerator = class {
 	constructor(baseUrl) {
 		this.baseUrl = baseUrl;
 	}
+	/**
+	* Generate video segment URL
+	*/
 	generateSegmentUrl(segmentId, renditionId, metadata) {
 		const audioRendition = metadata.audioRendition;
 		const videoRendition = metadata.videoRendition;
@@ -12,17 +16,32 @@ var UrlGenerator = class {
 		}
 		return (segmentId === "init" ? metadata.templates.initSegment : metadata.templates.mediaSegment).replace("{rendition}", renditionId).replace("{segmentId}", segmentId.toString()).replace("{src}", metadata.src).replace("{trackId}", rendition.trackId?.toString() ?? "");
 	}
+	/**
+	* Generate init segment URL
+	*/
 	generateInitSegmentUrl(mediaUrl, rendition) {
 		return `${this.baseUrl()}/api/v1/transcode/${rendition}/init.m4s?url=${encodeURIComponent(mediaUrl)}`;
 	}
+	/**
+	* Generate manifest URL
+	*/
 	generateManifestUrl(mediaUrl) {
 		return `${this.baseUrl()}/api/v1/transcode/manifest.json?url=${encodeURIComponent(mediaUrl)}`;
 	}
+	/**
+	* Generate track fragment index URL
+	*/
 	generateTrackFragmentIndexUrl(mediaUrl) {
 		return `/@ef-track-fragment-index/${mediaUrl.startsWith("/") ? mediaUrl.slice(1) : mediaUrl}`;
 	}
+	/**
+	* Generate quality presets URL
+	*/
 	generatePresetsUrl() {
 		return `${this.baseUrl()}/api/v1/transcode/presets`;
 	}
 };
+
+//#endregion
 export { UrlGenerator };
+//# sourceMappingURL=UrlGenerator.js.map

package/dist/transcoding/utils/UrlGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrlGenerator.js","names":["baseUrl: () => string"],"sources":["../../../src/transcoding/utils/UrlGenerator.ts"],"sourcesContent":["/**\n * URL generation utilities for transcoding endpoints\n */\n\nimport type { RenditionId } from \"../types/index.js\";\nimport type { MediaEngine } from \"../types/index.ts\";\n\nexport class UrlGenerator {\n  constructor(private baseUrl: () => string) {}\n\n  /**\n   * Generate video segment URL\n   */\n  generateSegmentUrl(\n    segmentId: \"init\" | number,\n    renditionId: RenditionId,\n    metadata: MediaEngine,\n  ): string {\n    const audioRendition = metadata.audioRendition;\n    const videoRendition = metadata.videoRendition;\n    const rendition = audioRendition ?? videoRendition;\n    if (!rendition) {\n      console.error(\"Rendition not found\", metadata);\n      throw new Error(`Rendition ${renditionId} not found`);\n    }\n\n    const template =\n      segmentId === \"init\"\n        ? metadata.templates.initSegment\n        : metadata.templates.mediaSegment;\n    return template\n      .replace(\"{rendition}\", renditionId)\n      .replace(\"{segmentId}\", segmentId.toString())\n      .replace(\"{src}\", metadata.src)\n      .replace(\"{trackId}\", rendition.trackId?.toString() ?? \"\");\n  }\n\n  /**\n   * Generate init segment URL\n   */\n  generateInitSegmentUrl(mediaUrl: string, rendition: string): string {\n    return `${this.baseUrl()}/api/v1/transcode/${rendition}/init.m4s?url=${encodeURIComponent(mediaUrl)}`;\n  }\n\n  /**\n   * Generate manifest URL\n   */\n  generateManifestUrl(mediaUrl: string): string {\n    return `${this.baseUrl()}/api/v1/transcode/manifest.json?url=${encodeURIComponent(mediaUrl)}`;\n  }\n\n  /**\n   * Generate track fragment index URL\n   */\n  generateTrackFragmentIndexUrl(mediaUrl: string): string {\n    const normalizedSrc = mediaUrl.startsWith(\"/\")\n      ? mediaUrl.slice(1)\n      : mediaUrl;\n    return `/@ef-track-fragment-index/${normalizedSrc}`;\n  }\n\n  /**\n   * Generate quality presets URL\n   */\n  generatePresetsUrl(): string {\n    return `${this.baseUrl()}/api/v1/transcode/presets`;\n  }\n}\n"],"mappings":";AAOA,IAAa,eAAb,MAA0B;CACxB,YAAY,AAAQA,SAAuB;EAAvB;;;;;CAKpB,mBACE,WACA,aACA,UACQ;EACR,MAAM,iBAAiB,SAAS;EAChC,MAAM,iBAAiB,SAAS;EAChC,MAAM,YAAY,kBAAkB;AACpC,MAAI,CAAC,WAAW;AACd,WAAQ,MAAM,uBAAuB,SAAS;AAC9C,SAAM,IAAI,MAAM,aAAa,YAAY,YAAY;;AAOvD,UAHE,cAAc,SACV,SAAS,UAAU,cACnB,SAAS,UAAU,cAEtB,QAAQ,eAAe,YAAY,CACnC,QAAQ,eAAe,UAAU,UAAU,CAAC,CAC5C,QAAQ,SAAS,SAAS,IAAI,CAC9B,QAAQ,aAAa,UAAU,SAAS,UAAU,IAAI,GAAG;;;;;CAM9D,uBAAuB,UAAkB,WAA2B;AAClE,SAAO,GAAG,KAAK,SAAS,CAAC,oBAAoB,UAAU,gBAAgB,mBAAmB,SAAS;;;;;CAMrG,oBAAoB,UAA0B;AAC5C,SAAO,GAAG,KAAK,SAAS,CAAC,sCAAsC,mBAAmB,SAAS;;;;;CAM7F,8BAA8B,UAA0B;AAItD,SAAO,6BAHe,SAAS,WAAW,IAAI,GAC1C,SAAS,MAAM,EAAE,GACjB;;;;;CAON,qBAA6B;AAC3B,SAAO,GAAG,KAAK,SAAS,CAAC"}