hlsdownloader 5.0.1 → 6.0.0

package/README.md

@@ -39,15 +39,16 @@ Downloads HLS Playlist file and TS chunks. You can use it for content pre-fetchi
 
 ## Features
 
+- **Event Based:** Event based API
 - **Modern ESM**: Optimized for Node.js 20+ environments using native modules.
-- **Retryable**: Built-in resilience that automatically retries failed segment requests to ensure download completion.
+- **TypeScript Native:** Built with strong typing for mission-critical applications.
+- **Resilient Networking and Retryable**: Built-in resilience that automatically retries with exponential backoff of failed segment requests to ensure download completion.
 - **Promise Based**: Fully asynchronous API designed for seamless integration with `async/await` and modern control flows.
 - **Support for HTTP/2**: Leverages multiplexing to download multiple segments over a single connection for reduced overhead.
 - **Overwrite Protection**: Safeguards your local data by preventing accidental overwriting of existing files unless explicitly enabled.
 - **Support for Custom HTTP Headers**: Allows injection of custom headers for handling authentication, user-agents, or session tokens.
-- **Support for Custom HTTP Client**: Modular architecture that lets you swap the default engine for any custom client implementation.
-- **Bring Your Own Progress Bar**: Exposed event hooks and lifecycle data allow you to hook in any CLI or GUI progress visualization.
 - **Concurrent Downloads**: Maximizes bandwidth by fetching multiple HLS segments simultaneously through parallel HTTP connections.
+- **Proxy and NoProxy Support:** Proxy support and No Proxy support (undici integration).
 - **Professional Docs**: Integrated JSDoc-to-HTML pipeline using TypeDoc and the Fresh theme.
 
 ---
@@ -60,57 +61,109 @@ npm install hlsdownloader
 
 ## Examples
 
-### Basic Usage
+#### Example 1: Basic Download with Event Monitoring
+
+This is the standard implementation for saving a remote HLS stream to a local directory.
 
 ```ts
-import HLSDowloader from 'hlsdownloader';
+import { HLSDownloader } from 'hlsdownloader';
+
+async function downloadStream() {
+  const downloader = new HLSDownloader({
+    playlistURL: 'https://example.com/video/master.m3u8',
+    destination: './downloads/my-video',
+    overwrite: true,
+    concurrency: 5, // Process 5 segments simultaneously
+    retry: { limit: 3, delay: 1000 },
+    timeout: 15000,
+  });
+
+  downloader.on('start', ({ total }) => console.log(`start downloading assets...`));
+
+  // Listen to progress updates
+  downloader.on('progress', data => {
+    const percent = ((data.total / data.total) * 100).toFixed(2); // Simple logic for example
+    console.log(`[Progress] Downloaded: ${data.url}`);
+  });
+
+  // Handle errors for specific segments
+  downloader.on('error', err => {
+    console.error(`[Segment Error] Failed to fetch ${err.url}: ${err.message}`);
+  });
+
+  // Final summary
+  const summary = await downloader.startDownload();
+  console.log(`Finished! Total items: ${summary.total}. Errors: ${summary.errors.length}`);
+}
 
-const downloader = new HLSDownloader({
-  playlistURL: '[https://example.com/stream/master.m3u8](https://example.com/stream/master.m3u8)',
-  destination: './downloads/my-video',
-});
+downloadStream();
+```
 
-const summary = await downloader.startDownload();
-console.log(`Downloaded ${summary.total} segments to ${summary.path}`);
+#### Example 2: "Dry-Run" / CDN Priming (No File Writing)
+
+If the destination is omitted, the library fetches streams but doesn't write to disk. This is excellent for `CDN Priming` or `validating manifest health`.
+
+```ts
+import { HLSDownloader } from 'hlsdownloader';
+
+async function primeCDN() {
+  const downloader = new HLSDownloader({
+    playlistURL: 'https://cdn.provider.com/live/stream.m3u8',
+    // destination is omitted -> results in memory-only stream fetch
+    concurrency: 10,
+    headers: {
+      Authorization: 'Bearer internal-token-123',
+      'X-Custom-Source': 'Prewarm-Service',
+    },
+  });
+
+  downloader.on('start', ({ total }) => console.log(`Priming ${total} assets...`));
+
+  const result = await downloader.startDownload();
+
+  if (result.errors.length === 0) {
+    console.log('CDN Cache successfully warmed.');
+  } else {
+    console.error('Priming failed for some chunks', result.errors);
+  }
+}
+
+primeCDN();
 ```
 
-### Advanced Usage
+#### Example 3: Corporate Proxy & Advanced Networking
+
+If you are using behind corporate proxy, pass the proxy and no proxy configuration as follows
 
 ```ts
-import { HLSDownloader } from 'hlsdownloader-ts';
+import { HLSDownloader } from 'hlsdownloader';
 
 const downloader = new HLSDownloader({
-  playlistURL: 'https://example.com/video.m3u8',
-  destination: './output',
-  concurrency: 10, // 10 simultaneous downloads
-  overwrite: true, // Overwrite existing files
+  playlistURL: 'https://secure-stream.corp.internal/index.m3u8',
+  destination: '/mnt/storage/archive',
+  proxy: 'http://proxy.corporate.net:8080',
+  noProxy: '.internal.com,localhost', // Bypass proxy for internal domains
+  headers: {
+    Cookie: 'session_id=abc123',
+    'User-Agent': 'MediaArchiver/1.0',
+  },
 });
 
-const { total, errors } = await downloader.startDownload();
+downloader.on('start', ({ total }) => console.log(`Priming ${total} assets...`));
 
-if (errors.length > 0) {
-  console.error(`${errors.length} segments failed.`, errors);
-}
-```
+// Listen to progress updates
+downloader.on('progress', data => {
+  const percent = ((data.total / data.total) * 100).toFixed(2); // Simple logic for example
+  console.log(`[Progress] Downloaded: ${data.url}`);
+});
 
-HLSDownloader supports all [Ky API](https://github.com/sindresorhus/ky?tab=readme-ov-file#api) except these options given below
-
-- uri
-- url
-- json
-- form
-- body
-- method
-- setHost
-- isStream
-- parseJson
-- prefixUrl
-- cookieJar
-- playlistURL
-- concurrency
-- allowGetBody
-- stringifyJson
-- methodRewriting
+// Handle errors for specific segments
+downloader.on('error', err => {
+  console.error(`[Segment Error] Failed to fetch ${err.url}: ${err.message}`);
+});
+
+const summary = await downloader.startDownload();
+```
 
 ## API Documentation
 
@@ -120,28 +173,58 @@ The library is organized under the `HLSDownloader` module. For full interactive
 
 The main service orchestrator for fetching HLS content.
 
-| Method            | Returns                    | Description                           |
-| ----------------- | -------------------------- | ------------------------------------- |
-| `startDownload()` | `Promise<DownloadSummary>` | Begins parsing and fetching segments. |
+| Method          | Returns                    | Description                           |
+| --------------- | -------------------------- | ------------------------------------- |
+| startDownload() | `Promise<DownloadSummary>` | Begins parsing and fetching segments. |
 
 ### DownloaderOptions (Interface)
 
-| Property    | Type       | Default       | Description                                             |
-| ----------- | ---------- | ------------- | ------------------------------------------------------- |
-| playlistURL | `string`   | **Required**  | The absolute URL to the M3U8 file.                      |
-| destination | `string`   | `''`          | Local path to save files.                               |
-| concurrency | `number`   | `os.cpus - 1` | Max parallel network requests.                          |
-| overwrite   | `boolean`  | `false`       | Indicates whether existing files should be overwritten. |
-| onData      | `callback` | `null`        | The local directory where files will be saved.          |
-| onError     | `callback` | `null`        | The local directory where files will be saved.          |
+| Option      | Type      | Default                  | Description                                                                                |
+| ----------- | --------- | ------------------------ | ------------------------------------------------------------------------------------------ |
+| playlistURL | `string`  | Required                 | The source .m3u8 URL.                                                                      |
+| destination | `string`  | undefined                | Local path to save files. Omit for "dry-run" mode.                                         |
+| concurrency | `number`  | os.cpus().length         | Simultaneous segment downloads.                                                            |
+| overwrite   | `boolean` | false                    | Overwrite existing files in the destination.                                               |
+| headers     | `object`  | {}                       | Custom headers to pass                                                                     |
+| timeout     | `number`  | 10000                    | Network request timeout in ms.                                                             |
+| retry       | `object`  | { limit: 1, delay: 500 } | Exponential backoff settings.                                                              |
+| proxy       | `string`  | undefined                | Corporate proxy URL. Also reads URLs for `HTTP_PROXY`, `HTTPS_PROXY` environment variables |
+| noProxy     | `string`  | undefined                | Corporate No Proxy Urls. Also reads urls from `NO_PROXY` environment vriable               |
+
+### DownloaderEvents (Interface)
+
+| Event Name | Description                                  |
+| ---------- | -------------------------------------------- |
+| start      | emits when download started                  |
+| progress   | emits for each segement downloded            |
+| error      | emits when a segement downlod error occurred |
+| end        | emits when download ended                    |
 
 ### DownloadSummary (Interface)
 
-| Property | Type              | Description                           | Description                        |
-| -------- | ----------------- | ------------------------------------- | ---------------------------------- |
-| `total`  | `number`          | Count of successfully saved segments. | The absolute URL to the M3U8 file. |
-| `path`   | `string`          | The final output directory.           | Local path to save files.          |
-| `errors` | `DownloadError[]` | Array of detailed failure objects.    | Max parallel network requests.     |
+| Property | Type              | Description                           |
+| -------- | ----------------- | ------------------------------------- |
+| total    | `number`          | Count of successfully saved segments. |
+| message  | `string`          | User friendly message.                |
+| errors   | `DownloadError[]` | Array of detailed failure objects.    |
+
+### SegmentDownloadedData (Interface) - emits on `progress` events
+
+| Property | Type     | Description                                                                |
+| -------- | -------- | -------------------------------------------------------------------------- |
+| url      | `string` | Original segment URL as referenced in the HLS playlist (`.m3u8`).          |
+| path     | `string` | Local file system path where the segment was saved. Empty if not provided. |
+| total    | `number` | Total number of segments downloaded so far, including this one.            |
+
+---
+
+### SegmentDownloadErrorData (Interface) - emits on `error` events
+
+| Property | Type     | Description                                                |
+| -------- | -------- | ---------------------------------------------------------- |
+| url      | `string` | Original segment URL that failed to download.              |
+| name     | `string` | Error name or type (e.g., `NetworkError`, `TimeoutError`). |
+| message  | `string` | Human-readable error description.                          |
 
 ## Development & Contributing
 
@@ -149,18 +232,19 @@ Contributions are welcome! This project enforces strict quality standards to mai
 
 ### Prerequisites
 
-- Node.js >= 20.0.0
-- npm >= 10.0.0
+- [Node.js](https://nodejs.org/) >= 20.0.0
+- [npm](https://github.com/npm/cli) >= 10.0.0
 
 ### Workflow
 
 Fork & Clone: Get the repo locally.
 
-- Install: `npm install`
-- Lint: `npm run lint` (Must pass without warnings)
-- Test: `npm run test:cov` (Must maintain 100% coverage)
-- Build: `npm run build` (Generates `./dist` and bundled types)
-- Docs: `npm run docs` (Generates TypeDoc HTML)
+- `Install`: `npm install`
+- `Test`: `npm run test` (Must pass without warnings)
+- `Lint`: `npm run lint` (Must pass without warnings)
+- `Build`: `npm run build` (Generates `./dist` and bundled types)
+- `Docs`: `npm run docs` (Generates TypeDoc HTML)
+- `Test with Coverage Report`: `npm run test:coverage` (Must maintain 100% coverage)
 
 ### Guidelines
 
@@ -174,10 +258,6 @@ Contributions, issues and feature requests are welcome!<br />Feel free to check
 
 Give a ⭐️ if this project helped you!. I will be grateful if you all help me to improve this package by giving your suggestions, feature request and pull requests. I am all ears!!
 
-## Special Thanks to
-
-- [Ky Team](https://www.npmjs.com/package/ky)
-
 ## License
 
 Copyright © 2026 [Nur Rony](https://github.com/nurrony).<br />

package/dist/index.d.ts

@@ -1,25 +1,46 @@
 // Generated by dts-bundle-generator v9.5.1
 
+import { EventEmitter } from 'node:events';
+
+export interface HttpClientOptions {
+	timeout?: number;
+	retry?: {
+		limit: number;
+		delay: number;
+	};
+	proxy?: string;
+	noProxy?: string[];
+	headers?: Record<string, string>;
+}
+export interface DownloaderEvents {
+	start: (data: {
+		total: number;
+		destination: string;
+	}) => void;
+	progress: (data: SegmentDownloadedData) => void;
+	error: (error: DownloadError) => void;
+	end: (summary: DownloadSummary) => void;
+}
 export interface DownloadError {
 	url: string;
 	name: string;
 	message: string;
 }
-export interface DownloaderOptions {
+export interface SegmentDownloadedData {
+	url: string;
+	path?: string;
+	total: number;
+}
+export interface SegmentDownloadErrorData {
+	url: string;
+	name: string;
+	message: string;
+}
+export interface DownloaderOptions extends HttpClientOptions {
 	playlistURL: string;
 	destination?: string;
 	overwrite?: boolean;
 	concurrency?: number;
-	onData?: (data: {
-		url: string;
-		path?: string;
-		total: number;
-	}) => void;
-	onError?: (error: {
-		url: string;
-		name: string;
-		message: string;
-	}) => void;
 	[key: string]: any;
 }
 export interface DownloadSummary {
@@ -27,19 +48,18 @@ export interface DownloadSummary {
 	errors: DownloadError[];
 	message: string;
 }
-declare class Downloader {
+declare class Downloader extends EventEmitter {
 	private options;
+	private items;
 	private playlistURL;
-	private onData;
-	private onError;
 	private pool;
 	private http;
 	private fileService;
-	private items;
 	private errors;
 	private concurrency;
 	constructor(options: DownloaderOptions);
 	startDownload(): Promise<DownloadSummary>;
+	emit(event: string | symbol, ...args: any[]): boolean;
 	private processQueue;
 	private downloadFile;
 	private handleError;

package/dist/index.js

@@ -1 +1 @@
-import{cpus as k}from"node:os";import F from"p-limit";import{URL as w}from"node:url";var m=class s extends Error{constructor(t){super(t),this.name=this.constructor.name,Object.setPrototypeOf(this,s.prototype),Error.captureStackTrace&&Error.captureStackTrace(this,this.constructor)}},g=m;var o=class{static isValidUrl(t,r=["http:","https:","ftp:","sftp:"]){let{protocol:e}=new w(t);if(e&&!r.includes(e))throw new g(`${e} is not supported. Supported protocols are ${r.join(", ")}`);return!0}static stripFirstSlash(t){return t.startsWith("/")?t.substring(1):t}static isValidPlaylist(t){return/^#EXTM3U/im.test(t)}static parseUrl(t){return new w(t)}static omit(t,...r){let e=new Set(r.flat());return Object.fromEntries(Object.entries(t).filter(([a])=>!e.has(a)))}static isNotFunction(t){return typeof t!="function"}};import{constants as L,createWriteStream as U}from"node:fs";import*as n from"node:fs/promises";import S from"node:path";import{Readable as R}from"node:stream";import{pipeline as T}from"node:stream/promises";var h=class{destination;overwrite;constructor(t,r=!1){this.destination=t,this.overwrite=r}async getTargetPath(t){let{pathname:r}=o.parseUrl(t);return S.join(this.destination,o.stripFirstSlash(r))}async prepareDirectory(t){let r=await this.getTargetPath(t),e=S.dirname(r);return await n.mkdir(e,{recursive:!0}),r}async canWrite(t){try{let r=await this.getTargetPath(t);return await n.access(r,L.F_OK),this.overwrite}catch(r){if(r.code==="ENOENT")return!0;throw r}}async saveStream(t,r){let e=R.fromWeb(t),a=U(r);try{await T(e,a)}catch(i){throw await n.unlink(r).catch(()=>{}),i}}},v=h;import E from"ky";var u=class s extends Error{constructor(t){super(t),this.name=this.constructor.name,Object.setPrototypeOf(this,s.prototype),Error.captureStackTrace&&Error.captureStackTrace(this,this.constructor)}},D=u;var d=class s{options;static defaultKyOptions={retry:{limit:0}};static unSupportedOptions=["uri","url","json","form","body","method","setHost","isStream","parseJson","prefixUrl","cookieJar","playlistURL","concurrency","allowGetBody","stringifyJson","methodRewriting"];constructor(t={}){this.options=Object.assign({},s.defaultKyOptions,o.omit(t,...s.unSupportedOptions))}async fetchText(t){let r=await E.get(t,{...this.options}).text();if(!o.isValidPlaylist(r))throw new D("Invalid playlist");return r}async getStream(t){let r=await E.get(t,{...this.options});if(!r.body)throw new Error("Response body is null");return r.body}},P=d;import{URL as x}from"node:url";var y=class s{static HLS_PLAYLIST_EXT=".m3u8";parse(t,r){return r.replace(/^#[\s\S].*/gim,"").split(/\r?\n/).filter(e=>e.trim()!=="").map(e=>new x(e,t).href)}isPlaylist(t){return t.toLowerCase().endsWith(s.HLS_PLAYLIST_EXT)}},c=new y;var f=class{constructor(t){this.options=t;let{onData:r,onError:e,destination:a="",playlistURL:i="",overwrite:p=!1,concurrency:l=Math.max(1,k().length-1),...O}=t||{};this.onData=r,this.onError=e,this.playlistURL=i,this.pool=F(l),this.concurrency=l,this.http=new P(O),this.fileService=new v(a,p),this.items=[i]}playlistURL;onData;onError;pool;http;fileService;items;errors=[];concurrency=1;async startDownload(){try{o.isValidUrl(this.playlistURL);let t=await this.http.fetchText(this.playlistURL),r=c.parse(this.playlistURL,t);this.items.push(...r);let e=r.filter(i=>c.isPlaylist(i));return(await Promise.allSettled(e.map(i=>this.http.fetchText(i)))).forEach((i,p)=>{if(i.status==="fulfilled"){let l=c.parse(e[p],i.value);this.items.push(...l)}}),await this.processQueue(),this.generateSummary()}catch(t){return this.handleError(this.playlistURL,t),this.generateSummary()}}async processQueue(){if(this.fileService.destination){if(!await this.fileService.canWrite(this.playlistURL))throw new Error("Directory already exists and overwrite is disabled");let r=this.items.map(e=>this.pool(()=>this.downloadFile(e)));return Promise.allSettled(r)}let t=this.items.map(r=>this.pool(async()=>{try{let e=await this.http.getStream(r);return this.onData&&this.onData({url:r,total:this.items.length}),e}catch(e){this.handleError(r,e)}}));return Promise.allSettled(t)}async downloadFile(t){try{let r=await this.http.getStream(t),e=await this.fileService.prepareDirectory(t);await this.fileService.saveStream(r,e),this.onData&&this.onData({url:t,path:e,total:this.items.length})}catch(r){this.handleError(t,r)}}handleError(t,r){let e={url:t,name:r.name,message:r.message};this.errors.push(e),this.onError&&this.onError(e)}generateSummary(){return{errors:this.errors,total:this.items.length,message:this.errors.length>0?"Download ended with errors":"Downloaded successfully"}}},b=f;var ct=b;export{b as HLSDownloader,ct as default};
+import{EventEmitter as k}from"node:events";import{cpus as A}from"node:os";import C from"p-limit";import{URL as v}from"node:url";var h=class l extends Error{constructor(r){super(r),this.name=this.constructor.name,Object.setPrototypeOf(this,l.prototype),Error.captureStackTrace&&Error.captureStackTrace(this,this.constructor)}},f=h;var n=class{static isValidUrl(r,t=["http:","https:","ftp:","sftp:"]){let{protocol:e}=new v(r);if(e&&!t.includes(e))throw new f(`${e} is not supported. Supported protocols are ${t.join(", ")}`);return!0}static stripFirstSlash(r){return r.startsWith("/")?r.substring(1):r}static isValidPlaylist(r){return/^#EXTM3U/im.test(r)}static parseUrl(r){return new v(r)}static omit(r,...t){let e=new Set(t.flat());return Object.fromEntries(Object.entries(r).filter(([s])=>!e.has(s)))}static isNotFunction(r){return typeof r!="function"}static async sleep(r){return new Promise(t=>setTimeout(t,r))}};import{constants as x,createWriteStream as O}from"node:fs";import*as m from"node:fs/promises";import S from"node:path";import{Readable as L}from"node:stream";import{pipeline as T}from"node:stream/promises";var d=class{destination;overwrite;constructor(r,t=!1){this.destination=r,this.overwrite=t}async getTargetPath(r){let{pathname:t}=n.parseUrl(r);return S.join(this.destination,n.stripFirstSlash(t))}async prepareDirectory(r){let t=await this.getTargetPath(r),e=S.dirname(t);return await m.mkdir(e,{recursive:!0}),t}async canWrite(r){try{let t=await this.getTargetPath(r);return await m.access(t,x.F_OK),this.overwrite}catch(t){if(t.code==="ENOENT")return!0;throw t}}async saveStream(r,t){let e=L.fromWeb(r),s=O(t);try{await T(e,s)}catch(i){throw await m.unlink(t).catch(()=>{}),i}}},D=d;import{ProxyAgent as U}from"undici";var u=class l extends Error{constructor(r){super(r),this.name=this.constructor.name,Object.setPrototypeOf(this,l.prototype),Error.captureStackTrace&&Error.captureStackTrace(this,this.constructor)}},P=u;var y=class{options;primaryOrigin=null;sensitiveHeaders=["authorization","cookie","x-auth-token"];timeout;retryOptions;dispatcher;noProxy=[];constructor(r={}){if(this.options={method:"GET",headers:{"User-Agent":"HLSDownloader"}},r.headers){let s={};for(let[i,o]of Object.entries(r.headers))s[i.toLowerCase()]=o;this.options.headers={"User-Agent":"HLSDownloader",...this.options.headers,...s}}this.timeout=r.timeout??5e3,this.retryOptions=r.retry??{limit:1,delay:500};let t=process.env.NO_PROXY||process.env.no_proxy||"";this.noProxy=r.noProxy??t.split(",").map(s=>s.trim()).filter(Boolean);let e=r.proxy||process.env.HTTPS_PROXY||process.env.HTTP_PROXY;e&&(this.dispatcher=new U({uri:e}))}setPrimaryOrigin(r){try{this.primaryOrigin=new URL(r).origin}catch{this.primaryOrigin=null}}getRequestHeaders(r){let t={...this.options.headers};try{let e=new URL(r).origin;this.primaryOrigin&&e!==this.primaryOrigin&&this.sensitiveHeaders.forEach(s=>{delete t[s]})}catch{}return t}shouldBypassProxy(r){if(!this.dispatcher)return!0;let t=new URL(r).hostname;return this.noProxy.some(e=>t===e||e.startsWith(".")&&t.endsWith(e))}async requestWithRetry(r,t=0){let e=new AbortController,s=setTimeout(()=>e.abort(),this.timeout);try{let i=await fetch(r,{...this.options,headers:this.getRequestHeaders(r),signal:e.signal,dispatcher:this.shouldBypassProxy(r)?void 0:this.dispatcher});return clearTimeout(s),!i.ok&&(i.status>=500||i.status===429)&&t<this.retryOptions.limit?this.handleRetry(r,t):i}catch(i){if(clearTimeout(s),(i.name==="AbortError"||i.name==="TypeError"||i.status&&i.status>=500)&&t<this.retryOptions.limit)return this.handleRetry(r,t);throw i}}async handleRetry(r,t){let e=this.retryOptions.delay*Math.pow(2,t);return await n.sleep(e),this.requestWithRetry(r,t+1)}async fetchText(r){let e=await(await this.requestWithRetry(r)).text();if(!n.isValidPlaylist(e))throw new P("Invalid playlist");return e}async getStream(r){let t=await this.requestWithRetry(r);if(!t.body)throw new Error("Response body is null");return t.body}},b=y;import{URL as H}from"node:url";var g=class l{static HLS_PLAYLIST_EXT=".m3u8";parse(r,t){return t.replace(/^#[\s\S].*/gim,"").split(/\r?\n/).filter(e=>e.trim()!=="").map(e=>new H(e,r).href)}isPlaylist(r){return r.toLowerCase().endsWith(l.HLS_PLAYLIST_EXT)}},p=new g;var w=class extends k{constructor(t){super();this.options=t;let{destination:e="",playlistURL:s="",overwrite:i=!1,concurrency:o=Math.max(1,A().length-1),headers:a={},...c}=t||{};this.playlistURL=s,this.pool=C(o),this.concurrency=o,this.http=new b({headers:a,...c}),this.http.setPrimaryOrigin(this.playlistURL),this.fileService=new D(e,i),this.items.add(this.playlistURL)}items=new Set;playlistURL;pool;http;fileService;errors=[];concurrency=1;async startDownload(){try{n.isValidUrl(this.playlistURL);let t=await this.http.fetchText(this.playlistURL),e=p.parse(this.playlistURL,t);e.forEach(a=>this.items.add(a));let s=e.filter(a=>p.isPlaylist(a));(await Promise.allSettled(s.map(a=>this.http.fetchText(a)))).forEach((a,c)=>{a.status==="fulfilled"&&p.parse(s[c],a.value).forEach(E=>this.items.add(E))}),this.emit("start",{total:this.items.size,destination:this.options.destination}),await this.processQueue();let o=this.generateSummary();return this.emit("end",o),o}catch(t){return this.handleError(this.playlistURL,t),this.generateSummary()}}emit(t,...e){return super.emit(t,...e)}async processQueue(){let t=this.items.size,e=Array.from(this.items);if(this.fileService.destination){if(!await this.fileService.canWrite(this.playlistURL))throw new Error("Directory already exists and overwrite is disabled");let i=e.map(o=>this.pool(()=>this.downloadFile(o)));return Promise.allSettled(i)}let s=e.map(i=>this.pool(async()=>{try{let o=await this.http.getStream(i);return this.emit("progress",{url:i,total:t}),o}catch(o){this.handleError(i,o)}}));return Promise.allSettled(s)}async downloadFile(t){try{let e=await this.http.getStream(t),s=await this.fileService.prepareDirectory(t);await this.fileService.saveStream(e,s),this.emit("progress",{url:t,path:s,total:this.items.size})}catch(e){this.handleError(t,e)}}handleError(t,e){let s={url:t,name:e.name,message:e.message};this.errors.push(s),this.emit("error",s)}generateSummary(){return{errors:this.errors,total:this.items.size,message:this.errors.length>0?"Download ended with errors":"Downloaded successfully"}}},R=w;var gt=R;export{R as HLSDownloader,gt as default};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hlsdownloader",
-  "version": "5.0.1",
+  "version": "6.0.0",
   "description": "Downloads HLS Playlist file and TS chunks",
   "snyk": true,
   "main": "./dist/index.js",
@@ -25,36 +25,36 @@
     "prepublishOnly": "echo '🚀 Release: Final automated validation gate before NPM publishing.' && npm run build",
     "build:types": "echo '🏷️ Generating Types' && dts-bundle-generator -o dist/index.d.ts src/index.ts --no-check --silent",
     "docs": "rimraf -fr ./docs && echo '🧹 All documentation has been cleaned.' && echo '📝 Generating documentation...' && jsdoc -c jsdoc.json",
-    "build:bundle": "esbuild src/index.ts --bundle --packages=external --platform=node --format=esm --target=node20 --minify --tree-shaking=true --outfile=dist/index.js",
-    "build": "echo '🏗️ Compile: Bundles ESM source and generates minified distribution files.' && npm run typecheck && rimraf -fr ./dist && npm run build:types && npm run build:bundle",
+    "build:bundle": "esbuild src/index.ts --bundle --packages=external --external:undici --platform=node --format=esm --target=node20 --minify --tree-shaking=true --outfile=dist/index.js",
+    "build": "echo '📦 Bundles ESM source and generates minified distribution files.' && npm run typecheck && rimraf -fr ./dist && npm run build:types && npm run build:bundle",
     "test:coverage": "rimraf -fr ./coverage && echo '🧹 All test coverage reports has been cleaned.' && c8 npm test && echo '📊 Coverage: Validates 100% code coverage across all source files successfully.'"
   },
   "dependencies": {
-    "ky": "^1.14.3",
     "p-limit": "^7.3.0"
   },
   "devDependencies": {
     "@babel/core": "^7.29.0",
     "@babel/preset-typescript": "^7.28.5",
-    "@commitlint/cli": "^20.4.1",
-    "@commitlint/config-conventional": "^20.4.1",
-    "@eslint/js": "^9.39.2",
-    "@types/node": "^25.2.3",
-    "@types/web": "^0.0.331",
-    "c8": "^10.1.3",
+    "@commitlint/cli": "^20.4.2",
+    "@commitlint/config-conventional": "^20.4.2",
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.3.2",
+    "@types/web": "^0.0.338",
+    "c8": "^11.0.0",
     "clean-jsdoc-theme": "^4.3.0",
     "cz-conventional-changelog": "^3.3.0",
     "dts-bundle-generator": "^9.5.1",
-    "eslint": "^9.39.2",
-    "eslint-plugin-jsdoc": "^62.5.4",
+    "eslint": "^10.0.2",
+    "eslint-plugin-jsdoc": "^62.7.1",
     "jsdoc": "^4.0.5",
     "jsdoc-babel": "^0.5.0",
-    "lefthook": "^2.1.0",
-    "rimraf": "^6.1.2",
+    "lefthook": "^2.1.1",
+    "rimraf": "^6.1.3",
     "semantic-release": "^25.0.3",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.55.0"
+    "typescript-eslint": "^8.56.1",
+    "undici": "^7.22.0"
   },
   "engines": {
     "node": ">=20.0.0",