hls-streamer 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 LordVersA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,237 @@
+# HLS Streamer
+
+[![npm version](https://badge.fury.io/js/hls-streamer.svg)](https://badge.fury.io/js/hls-streamer)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
+
+**HLS Streamer** is a lightweight npm package that creates and streams HLS (HTTP Live Streaming) from MP3 files on demand, without storing temporary files or requiring ffmpeg.
+
+## ✨ Features
+
+- 🚀 **Zero Dependencies** - No ffmpeg required
+- 💾 **No Temporary Files** - Stream directly from source
+- ⚡ **Fast Startup** - Optional smaller initial segments for quick playback start
+- 🎯 **TypeScript Support** - Full type definitions included
+- 🔧 **Configurable** - Customizable segment sizes and naming
+- 📱 **Memory Efficient** - Byte-range streaming with minimal memory footprint
+
+## 📦 Installation
+
+```bash
+npm install hls-streamer
+```
+
+```bash
+yarn add hls-streamer
+```
+
+```bash
+pnpm add hls-streamer
+```
+
+## 🚀 Quick Start
+
+### Basic Usage
+
+```typescript
+import { HlsStreamer } from 'hls-streamer';
+
+const hls = new HlsStreamer({
+  filePath: 'path/to/audio.mp3',
+  segmentSizeKB: 512,
+  fileName: 'segment',
+  baseUrl: 'segments/session-123',
+  enableFastStart: true
+});
+
+// Generate M3U8 playlist
+const playlist = await hls.createM3U8();
+
+// Get file buffer for specific byte range
+const buffer = await hls.getFileBuffer(startByte, endByte);
+```
+
+### Express.js Integration
+
+```typescript
+import express from 'express';
+import { HlsStreamer } from 'hls-streamer';
+
+const app = express();
+
+// Serve M3U8 playlist
+app.get('/stream/:sessionId/playlist.m3u8', async (req, res) => {
+  const hls = new HlsStreamer({
+    filePath: getFilePath(req.params.sessionId),
+    baseUrl: `stream/${req.params.sessionId}`,
+    enableFastStart: true
+  });
+
+  res.setHeader('Content-Type', 'application/vnd.apple.mpegurl');
+  res.send(await hls.createM3U8());
+});
+
+// Serve segment files
+app.get('/stream/:sessionId/:start/:end/:filename', async (req, res) => {
+  const hls = new HlsStreamer({
+    filePath: getFilePath(req.params.sessionId),
+    baseUrl: `stream/${req.params.sessionId}`
+  });
+
+  const start = parseInt(req.params.start);
+  const end = parseInt(req.params.end);
+
+  res.setHeader('Content-Type', 'audio/mpeg');
+  res.setHeader('Accept-Ranges', 'bytes');
+  res.send(await hls.getFileBuffer(start, end));
+});
+```
+
+## 🛠️ API Reference
+
+### HlsStreamer
+
+#### Constructor Options
+
+```typescript
+interface HlsStreamerOptions {
+  /** Path to the MP3 file */
+  filePath: string;
+  /** Segment size in KB (default: 512) */
+  segmentSizeKB?: number;
+  /** Base filename for segments (default: "file") */
+  fileName?: string;
+  /** Base URL path for segment URLs */
+  baseUrl?: string;
+  /** Enable smaller initial segments for faster startup */
+  enableFastStart?: boolean;
+}
+```
+
+#### Methods
+
+##### `createM3U8(): Promise<string>`
+Generates an HLS M3U8 playlist file content.
+
+**Returns:** M3U8 playlist as a string
+
+##### `getFileBuffer(startByte: number, endByte: number): Promise<Buffer>`
+Retrieves a specific byte range from the MP3 file.
+
+**Parameters:**
+- `startByte` - Starting byte position (inclusive)
+- `endByte` - Ending byte position (exclusive)
+
+**Returns:** Buffer containing the requested byte range
+
+##### `getSegmentDuration(segmentIndex: number): Promise<number>`
+Gets the accurate duration of a specific segment.
+
+**Parameters:**
+- `segmentIndex` - Zero-based segment index
+
+**Returns:** Duration in seconds
+
+### Error Handling
+
+The package includes custom error types for better error handling:
+
+```typescript
+import {
+  FileNotFoundError,
+  InvalidFileError,
+  InvalidRangeError,
+  InvalidParameterError
+} from 'hls-streamer';
+
+try {
+  const hls = new HlsStreamer({ filePath: 'nonexistent.mp3' });
+} catch (error) {
+  if (error instanceof FileNotFoundError) {
+    console.error('File not found:', error.message);
+  }
+}
+```
+
+## 📋 Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `filePath` | `string` | **required** | Path to the MP3 file |
+| `segmentSizeKB` | `number` | `512` | Size of each segment in KB |
+| `fileName` | `string` | `"file"` | Base name for segment files |
+| `baseUrl` | `string` | `""` | Base URL path for segment URLs |
+| `enableFastStart` | `boolean` | `false` | Use smaller initial segments for faster startup |
+
+## 🎯 Use Cases
+
+- **Audio Streaming Services** - Stream music without pre-processing
+- **Podcast Platforms** - On-demand episode streaming
+- **Educational Platforms** - Stream lecture recordings
+- **Voice Message Systems** - Real-time audio message playback
+- **Audio Books** - Chapter-based streaming
+
+## 🔧 Advanced Examples
+
+### Custom Segment Sizing
+
+```typescript
+const hls = new HlsStreamer({
+  filePath: 'large-audio-file.mp3',
+  segmentSizeKB: 1024, // 1MB segments for better quality
+  enableFastStart: true // First segments will be 256KB and 512KB
+});
+```
+
+### Dynamic File Paths
+
+```typescript
+class AudioStreamer {
+  async streamAudio(userId: string, audioId: string) {
+    const filePath = await this.getAudioPath(userId, audioId);
+
+    const hls = new HlsStreamer({
+      filePath,
+      baseUrl: `audio/${userId}/${audioId}`,
+      fileName: `audio-${audioId}`,
+      segmentSizeKB: 256 // Smaller segments for mobile
+    });
+
+    return hls.createM3U8();
+  }
+}
+```
+
+## 🧪 Testing
+
+```bash
+npm test
+npm run test:watch
+npm run test:coverage
+```
+
+## 🏗️ Building
+
+```bash
+npm run build        # Build both ESM and CJS
+npm run build:esm    # Build ES modules
+npm run build:cjs    # Build CommonJS
+```
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
+
+## 📞 Support
+
+- 🐛 **Bug Reports:** [GitHub Issues](https://github.com/LordVersA/hls-streamer/issues)
+- 💬 **Questions:** [GitHub Discussions](https://github.com/LordVersA/hls-streamer/discussions)
+- 📦 **NPM:** [hls-streamer](https://www.npmjs.com/package/hls-streamer)
+
+---
+
+Made with ❤️ by [LordVersA](https://github.com/LordVersA)

package/dist/Interfaces/HlsStreamer.d.ts

@@ -0,0 +1,17 @@
+export interface HlsStreamerOptions {
+    filePath: string;
+    segmentSizeKB?: number;
+    fileName?: string;
+    baseUrl?: string;
+    enableFastStart?: boolean;
+}
+export interface SegmentInfo {
+    start: number;
+    end: number;
+    duration: number;
+}
+export interface Mp3FileInfo {
+    size: number;
+    duration: number;
+}
+//# sourceMappingURL=HlsStreamer.d.ts.map

package/dist/Interfaces/HlsStreamer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HlsStreamer.d.ts","sourceRoot":"","sources":["../../src/Interfaces/HlsStreamer.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IAEjC,QAAQ,EAAE,MAAM,CAAC;IAEjB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAKD,MAAM,WAAW,WAAW;IAE1B,KAAK,EAAE,MAAM,CAAC;IAEd,GAAG,EAAE,MAAM,CAAC;IAEZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAKD,MAAM,WAAW,WAAW;IAE1B,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/Interfaces/HlsStreamer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=HlsStreamer.js.map

package/dist/Interfaces/HlsStreamer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HlsStreamer.js","sourceRoot":"","sources":["../../src/Interfaces/HlsStreamer.ts"],"names":[],"mappings":""}

package/dist/Libs/FileLib.d.ts

@@ -0,0 +1,5 @@
+export declare class FileLib {
+    static getFileSizeInBytes(buffer: Buffer): number;
+    static getMP3DurationFromBuffer(mp3Buffer: Buffer): Promise<number>;
+}
+//# sourceMappingURL=FileLib.d.ts.map

package/dist/Libs/FileLib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileLib.d.ts","sourceRoot":"","sources":["../../src/Libs/FileLib.ts"],"names":[],"mappings":"AAKA,qBAAa,OAAO;IAIlB,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAWjD,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAWpE"}

package/dist/Libs/FileLib.js

@@ -0,0 +1,24 @@
+import mp3Duration from "mp3-duration";
+export class FileLib {
+    static getFileSizeInBytes(buffer) {
+        if (Buffer.isBuffer(buffer)) {
+            return buffer.length;
+        }
+        else {
+            throw new Error("Input is not a buffer");
+        }
+    }
+    static getMP3DurationFromBuffer(mp3Buffer) {
+        return new Promise((resolve, reject) => {
+            mp3Duration(mp3Buffer, (err, duration) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(duration);
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=FileLib.js.map

package/dist/Libs/FileLib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileLib.js","sourceRoot":"","sources":["../../src/Libs/FileLib.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,cAAc,CAAC;AAKvC,MAAM,OAAO,OAAO;IAIlB,MAAM,CAAC,kBAAkB,CAAC,MAAc;QACtC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,OAAO,MAAM,CAAC,MAAM,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAKD,MAAM,CAAC,wBAAwB,CAAC,SAAiB;QAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,WAAW,CAAC,SAAS,EAAE,CAAC,GAAiB,EAAE,QAAgB,EAAE,EAAE;gBAC7D,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/cjs/Interfaces/HlsStreamer.d.ts

@@ -0,0 +1,17 @@
+export interface HlsStreamerOptions {
+    filePath: string;
+    segmentSizeKB?: number;
+    fileName?: string;
+    baseUrl?: string;
+    enableFastStart?: boolean;
+}
+export interface SegmentInfo {
+    start: number;
+    end: number;
+    duration: number;
+}
+export interface Mp3FileInfo {
+    size: number;
+    duration: number;
+}
+//# sourceMappingURL=HlsStreamer.d.ts.map

package/dist/cjs/Interfaces/HlsStreamer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HlsStreamer.d.ts","sourceRoot":"","sources":["../../../src/Interfaces/HlsStreamer.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IAEjC,QAAQ,EAAE,MAAM,CAAC;IAEjB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAKD,MAAM,WAAW,WAAW;IAE1B,KAAK,EAAE,MAAM,CAAC;IAEd,GAAG,EAAE,MAAM,CAAC;IAEZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAKD,MAAM,WAAW,WAAW;IAE1B,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/cjs/Interfaces/HlsStreamer.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=HlsStreamer.js.map

package/dist/cjs/Interfaces/HlsStreamer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HlsStreamer.js","sourceRoot":"","sources":["../../../src/Interfaces/HlsStreamer.ts"],"names":[],"mappings":""}

package/dist/cjs/Libs/FileLib.d.ts

@@ -0,0 +1,5 @@
+export declare class FileLib {
+    static getFileSizeInBytes(buffer: Buffer): number;
+    static getMP3DurationFromBuffer(mp3Buffer: Buffer): Promise<number>;
+}
+//# sourceMappingURL=FileLib.d.ts.map

package/dist/cjs/Libs/FileLib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileLib.d.ts","sourceRoot":"","sources":["../../../src/Libs/FileLib.ts"],"names":[],"mappings":"AAKA,qBAAa,OAAO;IAIlB,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAWjD,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAWpE"}

package/dist/cjs/Libs/FileLib.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileLib = void 0;
+const mp3_duration_1 = __importDefault(require("mp3-duration"));
+class FileLib {
+    static getFileSizeInBytes(buffer) {
+        if (Buffer.isBuffer(buffer)) {
+            return buffer.length;
+        }
+        else {
+            throw new Error("Input is not a buffer");
+        }
+    }
+    static getMP3DurationFromBuffer(mp3Buffer) {
+        return new Promise((resolve, reject) => {
+            (0, mp3_duration_1.default)(mp3Buffer, (err, duration) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(duration);
+                }
+            });
+        });
+    }
+}
+exports.FileLib = FileLib;
+//# sourceMappingURL=FileLib.js.map

package/dist/cjs/Libs/FileLib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileLib.js","sourceRoot":"","sources":["../../../src/Libs/FileLib.ts"],"names":[],"mappings":";;;;;;AAAA,gEAAuC;AAKvC,MAAa,OAAO;IAIlB,MAAM,CAAC,kBAAkB,CAAC,MAAc;QACtC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,OAAO,MAAM,CAAC,MAAM,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAKD,MAAM,CAAC,wBAAwB,CAAC,SAAiB;QAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAA,sBAAW,EAAC,SAAS,EAAE,CAAC,GAAiB,EAAE,QAAgB,EAAE,EAAE;gBAC7D,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA1BD,0BA0BC"}

package/dist/cjs/errors/HlsStreamerErrors.d.ts

@@ -0,0 +1,16 @@
+export declare class HlsStreamerError extends Error {
+    constructor(message: string);
+}
+export declare class FileNotFoundError extends HlsStreamerError {
+    constructor(filePath: string);
+}
+export declare class InvalidFileError extends HlsStreamerError {
+    constructor(message: string);
+}
+export declare class InvalidRangeError extends HlsStreamerError {
+    constructor(startByte: number, endByte: number);
+}
+export declare class InvalidParameterError extends HlsStreamerError {
+    constructor(parameter: string, value: any);
+}
+//# sourceMappingURL=HlsStreamerErrors.d.ts.map

package/dist/cjs/errors/HlsStreamerErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HlsStreamerErrors.d.ts","sourceRoot":"","sources":["../../../src/errors/HlsStreamerErrors.ts"],"names":[],"mappings":"AAGA,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAKD,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,QAAQ,EAAE,MAAM;CAI7B;AAKD,qBAAa,gBAAiB,SAAQ,gBAAgB;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAKD,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI/C;AAKD,qBAAa,qBAAsB,SAAQ,gBAAgB;gBAC7C,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;CAI1C"}

package/dist/cjs/errors/HlsStreamerErrors.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidParameterError = exports.InvalidRangeError = exports.InvalidFileError = exports.FileNotFoundError = exports.HlsStreamerError = void 0;
+class HlsStreamerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'HlsStreamerError';
+    }
+}
+exports.HlsStreamerError = HlsStreamerError;
+class FileNotFoundError extends HlsStreamerError {
+    constructor(filePath) {
+        super(`File not found: ${filePath}`);
+        this.name = 'FileNotFoundError';
+    }
+}
+exports.FileNotFoundError = FileNotFoundError;
+class InvalidFileError extends HlsStreamerError {
+    constructor(message) {
+        super(`Invalid file: ${message}`);
+        this.name = 'InvalidFileError';
+    }
+}
+exports.InvalidFileError = InvalidFileError;
+class InvalidRangeError extends HlsStreamerError {
+    constructor(startByte, endByte) {
+        super(`Invalid range: start=${startByte}, end=${endByte}`);
+        this.name = 'InvalidRangeError';
+    }
+}
+exports.InvalidRangeError = InvalidRangeError;
+class InvalidParameterError extends HlsStreamerError {
+    constructor(parameter, value) {
+        super(`Invalid parameter '${parameter}': ${value}`);
+        this.name = 'InvalidParameterError';
+    }
+}
+exports.InvalidParameterError = InvalidParameterError;
+//# sourceMappingURL=HlsStreamerErrors.js.map

package/dist/cjs/errors/HlsStreamerErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HlsStreamerErrors.js","sourceRoot":"","sources":["../../../src/errors/HlsStreamerErrors.ts"],"names":[],"mappings":";;;AAGA,MAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AALD,4CAKC;AAKD,MAAa,iBAAkB,SAAQ,gBAAgB;IACrD,YAAY,QAAgB;QAC1B,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AALD,8CAKC;AAKD,MAAa,gBAAiB,SAAQ,gBAAgB;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AALD,4CAKC;AAKD,MAAa,iBAAkB,SAAQ,gBAAgB;IACrD,YAAY,SAAiB,EAAE,OAAe;QAC5C,KAAK,CAAC,wBAAwB,SAAS,SAAS,OAAO,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AALD,8CAKC;AAKD,MAAa,qBAAsB,SAAQ,gBAAgB;IACzD,YAAY,SAAiB,EAAE,KAAU;QACvC,KAAK,CAAC,sBAAsB,SAAS,MAAM,KAAK,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AALD,sDAKC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,27 @@
+import { HlsStreamerOptions } from "./Interfaces/HlsStreamer";
+export declare class HlsStreamer {
+    private readonly filePath;
+    private readonly segmentSize;
+    private readonly fileName;
+    private readonly baseUrl;
+    private readonly enableFastStart;
+    private fileInfo?;
+    private segmentCache;
+    constructor(options: HlsStreamerOptions);
+    private validateOptions;
+    private validateFile;
+    private getFileInfo;
+    getFileBuffer(startByte: number, endByte: number): Promise<Buffer>;
+    createM3U8(): Promise<string>;
+    private calculateSegmentCount;
+    private estimateSegmentDuration;
+    private buildSegmentUrl;
+    private calculateSegmentSize;
+    private calculateSegment;
+    private calculatefirst2SegmentSize;
+    private padNumber;
+    getSegmentDuration(segmentIndex: number): Promise<number>;
+}
+export * from './Interfaces/HlsStreamer';
+export * from './errors/HlsStreamerErrors';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAA4B,MAAM,0BAA0B,CAAC;AAYxF,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,CAAc;IAC/B,OAAO,CAAC,YAAY,CAAkC;gBAK1C,OAAO,EAAE,kBAAkB;IAWvC,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,YAAY;YAgBN,WAAW;IA2BnB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBlE,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IA6BnC,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,0BAA0B;IAIlC,OAAO,CAAC,SAAS;IAOX,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAoBhE;AAGD,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,228 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HlsStreamer = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const FileLib_1 = require("./Libs/FileLib");
+const HlsStreamerErrors_1 = require("./errors/HlsStreamerErrors");
+class HlsStreamer {
+    constructor(options) {
+        Object.defineProperty(this, "filePath", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "segmentSize", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "fileName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "baseUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "enableFastStart", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "fileInfo", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "segmentCache", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        this.validateOptions(options);
+        this.validateFile(options.filePath);
+        this.filePath = options.filePath;
+        this.segmentSize = (options.segmentSizeKB ?? 512) * 1024;
+        this.fileName = options.fileName ?? "file";
+        this.baseUrl = options.baseUrl ?? "";
+        this.enableFastStart = options.enableFastStart ?? false;
+    }
+    validateOptions(options) {
+        if (!options.filePath || typeof options.filePath !== 'string') {
+            throw new HlsStreamerErrors_1.InvalidParameterError('filePath', options.filePath);
+        }
+        if (options.segmentSizeKB !== undefined &&
+            (typeof options.segmentSizeKB !== 'number' || options.segmentSizeKB <= 0)) {
+            throw new HlsStreamerErrors_1.InvalidParameterError('segmentSizeKB', options.segmentSizeKB);
+        }
+        if (options.fileName !== undefined && typeof options.fileName !== 'string') {
+            throw new HlsStreamerErrors_1.InvalidParameterError('fileName', options.fileName);
+        }
+    }
+    validateFile(filePath) {
+        if (!node_fs_1.default.existsSync(filePath)) {
+            throw new HlsStreamerErrors_1.FileNotFoundError(filePath);
+        }
+        const stat = node_fs_1.default.statSync(filePath);
+        if (!stat.isFile()) {
+            throw new HlsStreamerErrors_1.InvalidFileError('Path is not a file');
+        }
+        const ext = node_path_1.default.extname(filePath).toLowerCase();
+        if (ext !== '.mp3') {
+            throw new HlsStreamerErrors_1.InvalidFileError('Only MP3 files are supported');
+        }
+    }
+    async getFileInfo() {
+        if (!this.fileInfo) {
+            const stat = await node_fs_1.default.promises.stat(this.filePath);
+            const size = stat.size;
+            if (size <= 0) {
+                throw new HlsStreamerErrors_1.InvalidFileError('File is empty');
+            }
+            if (this.segmentSize > size) {
+                throw new HlsStreamerErrors_1.InvalidFileError('Segment size is larger than file size');
+            }
+            this.fileInfo = {
+                size,
+                duration: 0
+            };
+        }
+        return this.fileInfo;
+    }
+    async getFileBuffer(startByte, endByte) {
+        if (isNaN(startByte) || isNaN(endByte) || startByte < 0 || endByte < startByte) {
+            throw new HlsStreamerErrors_1.InvalidRangeError(startByte, endByte);
+        }
+        const fileInfo = await this.getFileInfo();
+        if (endByte > fileInfo.size) {
+            throw new HlsStreamerErrors_1.InvalidRangeError(startByte, endByte);
+        }
+        const bufferLength = endByte - startByte;
+        const fd = node_fs_1.default.openSync(this.filePath, "r");
+        try {
+            const buffer = Buffer.alloc(bufferLength);
+            const bytesRead = node_fs_1.default.readSync(fd, buffer, 0, bufferLength, startByte);
+            return buffer.subarray(0, bytesRead);
+        }
+        finally {
+            node_fs_1.default.closeSync(fd);
+        }
+    }
+    async createM3U8() {
+        const fileInfo = await this.getFileInfo();
+        const segmentCount = this.calculateSegmentCount(fileInfo.size);
+        const m3u8 = [
+            '#EXTM3U',
+            '#EXT-X-VERSION:6',
+            '#EXT-X-PLAYLIST-TYPE:VOD',
+            '#EXT-X-TARGETDURATION:14',
+            '#EXT-X-MEDIA-SEQUENCE:0',
+        ];
+        for (let i = 0; i < segmentCount; i++) {
+            const { start, end } = this.calculateSegment(i, fileInfo.size);
+            const estimatedDuration = this.estimateSegmentDuration(end - start);
+            const segmentUrl = this.buildSegmentUrl(start, end, i);
+            m3u8.push(`#EXTINF:${estimatedDuration.toFixed(3)}`);
+            m3u8.push(segmentUrl);
+        }
+        m3u8.push('#EXT-X-ENDLIST');
+        return m3u8.join('\n');
+    }
+    calculateSegmentCount(fileSize) {
+        if (!this.enableFastStart) {
+            return Math.ceil(fileSize / this.segmentSize);
+        }
+        const firstTwoSegmentsSize = this.calculatefirst2SegmentSize();
+        const remainingSize = fileSize - firstTwoSegmentsSize;
+        return Math.ceil(remainingSize / this.segmentSize) + 2;
+    }
+    estimateSegmentDuration(segmentSize) {
+        const estimatedBytesPerSecond = 16000;
+        return segmentSize / estimatedBytesPerSecond;
+    }
+    buildSegmentUrl(start, end, index) {
+        const baseUrlPrefix = this.baseUrl ? `/${this.baseUrl}` : '';
+        return `${baseUrlPrefix}/${start}/${end}/${this.fileName}${this.padNumber(index, 3)}.mp3`;
+    }
+    calculateSegmentSize(segmentIndex) {
+        if (!this.enableFastStart) {
+            return this.segmentSize;
+        }
+        switch (segmentIndex) {
+            case 0:
+                return this.segmentSize / 4;
+            case 1:
+                return this.segmentSize / 2;
+            default:
+                return this.segmentSize;
+        }
+    }
+    calculateSegment(segmentIndex, fileSize) {
+        let start = 0;
+        if (this.enableFastStart && segmentIndex < 2) {
+            start = segmentIndex * (this.segmentSize / 4);
+        }
+        else if (this.enableFastStart) {
+            start = (3 * this.segmentSize) / 4 + (segmentIndex - 2) * this.segmentSize;
+        }
+        else {
+            start = segmentIndex * this.segmentSize;
+        }
+        const segmentSize = this.calculateSegmentSize(segmentIndex);
+        const end = Math.min(start + segmentSize, fileSize);
+        return { start: Math.floor(start), end: Math.floor(end) };
+    }
+    calculatefirst2SegmentSize() {
+        return (this.segmentSize / 4) * 3;
+    }
+    padNumber(value, padding) {
+        return value.toString().padStart(padding, '0');
+    }
+    async getSegmentDuration(segmentIndex) {
+        const cachedSegment = this.segmentCache.get(segmentIndex);
+        if (cachedSegment) {
+            return cachedSegment.duration;
+        }
+        const fileInfo = await this.getFileInfo();
+        const { start, end } = this.calculateSegment(segmentIndex, fileInfo.size);
+        const segmentBuffer = await this.getFileBuffer(start, end);
+        const duration = await FileLib_1.FileLib.getMP3DurationFromBuffer(segmentBuffer);
+        this.segmentCache.set(segmentIndex, {
+            start,
+            end,
+            duration
+        });
+        return duration;
+    }
+}
+exports.HlsStreamer = HlsStreamer;
+__exportStar(require("./Interfaces/HlsStreamer"), exports);
+__exportStar(require("./errors/HlsStreamerErrors"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAE7B,4CAAyC;AACzC,kEAKoC;AAKpC,MAAa,WAAW;IAYtB,YAAY,OAA2B;QAXtB;;;;;WAAiB;QACjB;;;;;WAAoB;QACpB;;;;;WAAiB;QACjB;;;;;WAAgB;QAChB;;;;;WAAyB;QAClC;;;;;WAAuB;QACvB;;;;mBAAe,IAAI,GAAG,EAAuB;WAAC;QAMpD,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAEpC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC;QACzD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC;QAC3C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,KAAK,CAAC;IAC1D,CAAC;IAEO,eAAe,CAAC,OAA2B;QACjD,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9D,MAAM,IAAI,yCAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS;YACnC,CAAC,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ,IAAI,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,yCAAqB,CAAC,eAAe,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC3E,MAAM,IAAI,yCAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,QAAgB;QACnC,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,qCAAiB,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,MAAM,IAAI,GAAG,iBAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnB,MAAM,IAAI,oCAAgB,CAAC,oBAAoB,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,GAAG,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACjD,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,oCAAgB,CAAC,8BAA8B,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,MAAM,iBAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YAEvB,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;gBACd,MAAM,IAAI,oCAAgB,CAAC,eAAe,CAAC,CAAC;YAC9C,CAAC;YAED,IAAI,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,CAAC;gBAC5B,MAAM,IAAI,oCAAgB,CAAC,uCAAuC,CAAC,CAAC;YACtE,CAAC;YAID,IAAI,CAAC,QAAQ,GAAG;gBACd,IAAI;gBACJ,QAAQ,EAAE,CAAC;aACZ,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAKD,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,OAAe;QACpD,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,OAAO,GAAG,SAAS,EAAE,CAAC;YAC/E,MAAM,IAAI,qCAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,qCAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;QACzC,MAAM,EAAE,GAAG,iBAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAE3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,iBAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAa,EAAE,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;YAC7E,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACvC,CAAC;gBAAS,CAAC;YACT,iBAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAKD,KAAK,CAAC,UAAU;QACd,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAE/D,MAAM,IAAI,GAAG;YACX,SAAS;YACT,kBAAkB;YAClB,0BAA0B;YAC1B,0BAA0B;YAC1B,yBAAyB;SAC1B,CAAC;QAGF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YAG/D,MAAM,iBAAiB,GAAG,IAAI,CAAC,uBAAuB,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;YAEpE,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAEvD,IAAI,CAAC,IAAI,CAAC,WAAW,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAEO,qBAAqB,CAAC,QAAgB;QAC5C,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;QAChD,CAAC;QAGD,MAAM,oBAAoB,GAAG,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAC/D,MAAM,aAAa,GAAG,QAAQ,GAAG,oBAAoB,CAAC;QACtD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IAEO,uBAAuB,CAAC,WAAmB;QAGjD,MAAM,uBAAuB,GAAG,KAAK,CAAC;QACtC,OAAO,WAAW,GAAG,uBAAuB,CAAC;IAC/C,CAAC;IAEO,eAAe,CAAC,KAAa,EAAE,GAAW,EAAE,KAAa;QAC/D,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,OAAO,GAAG,aAAa,IAAI,KAAK,IAAI,GAAG,IAAI,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;IAC5F,CAAC;IAEO,oBAAoB,CAAC,YAAoB;QAC/C,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAED,QAAQ,YAAY,EAAE,CAAC;YACrB,KAAK,CAAC;gBACJ,OAAO,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;YAC9B,KAAK,CAAC;gBACJ,OAAO,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;YAC9B;gBACE,OAAO,IAAI,CAAC,WAAW,CAAC;QAC5B,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,YAAoB,EAAE,QAAgB;QAC7D,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,IAAI,IAAI,CAAC,eAAe,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YAE7C,KAAK,GAAG,YAAY,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAChD,CAAC;aAAM,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAEhC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QAC7E,CAAC;aAAM,CAAC;YAEN,KAAK,GAAG,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC;QAC1C,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,WAAW,EAAE,QAAQ,CAAC,CAAC;QAEpD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5D,CAAC;IAEO,0BAA0B;QAChC,OAAO,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAEO,SAAS,CAAC,KAAa,EAAE,OAAe;QAC9C,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;IAKD,KAAK,CAAC,kBAAkB,CAAC,YAAoB;QAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1D,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC,QAAQ,CAAC;QAChC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1E,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,iBAAO,CAAC,wBAAwB,CAAC,aAAa,CAAC,CAAC;QAGvE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE;YAClC,KAAK;YACL,GAAG;YACH,QAAQ;SACT,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAhOD,kCAgOC;AAGD,2DAAyC;AACzC,6DAA2C"}

package/dist/errors/HlsStreamerErrors.d.ts

@@ -0,0 +1,16 @@
+export declare class HlsStreamerError extends Error {
+    constructor(message: string);
+}
+export declare class FileNotFoundError extends HlsStreamerError {
+    constructor(filePath: string);
+}
+export declare class InvalidFileError extends HlsStreamerError {
+    constructor(message: string);
+}
+export declare class InvalidRangeError extends HlsStreamerError {
+    constructor(startByte: number, endByte: number);
+}
+export declare class InvalidParameterError extends HlsStreamerError {
+    constructor(parameter: string, value: any);
+}
+//# sourceMappingURL=HlsStreamerErrors.d.ts.map

package/dist/errors/HlsStreamerErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HlsStreamerErrors.d.ts","sourceRoot":"","sources":["../../src/errors/HlsStreamerErrors.ts"],"names":[],"mappings":"AAGA,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAKD,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,QAAQ,EAAE,MAAM;CAI7B;AAKD,qBAAa,gBAAiB,SAAQ,gBAAgB;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAKD,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI/C;AAKD,qBAAa,qBAAsB,SAAQ,gBAAgB;gBAC7C,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;CAI1C"}

package/dist/errors/HlsStreamerErrors.js

@@ -0,0 +1,31 @@
+export class HlsStreamerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'HlsStreamerError';
+    }
+}
+export class FileNotFoundError extends HlsStreamerError {
+    constructor(filePath) {
+        super(`File not found: ${filePath}`);
+        this.name = 'FileNotFoundError';
+    }
+}
+export class InvalidFileError extends HlsStreamerError {
+    constructor(message) {
+        super(`Invalid file: ${message}`);
+        this.name = 'InvalidFileError';
+    }
+}
+export class InvalidRangeError extends HlsStreamerError {
+    constructor(startByte, endByte) {
+        super(`Invalid range: start=${startByte}, end=${endByte}`);
+        this.name = 'InvalidRangeError';
+    }
+}
+export class InvalidParameterError extends HlsStreamerError {
+    constructor(parameter, value) {
+        super(`Invalid parameter '${parameter}': ${value}`);
+        this.name = 'InvalidParameterError';
+    }
+}
+//# sourceMappingURL=HlsStreamerErrors.js.map

package/dist/errors/HlsStreamerErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HlsStreamerErrors.js","sourceRoot":"","sources":["../../src/errors/HlsStreamerErrors.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAKD,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IACrD,YAAY,QAAgB;QAC1B,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAKD,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAKD,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IACrD,YAAY,SAAiB,EAAE,OAAe;QAC5C,KAAK,CAAC,wBAAwB,SAAS,SAAS,OAAO,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAKD,MAAM,OAAO,qBAAsB,SAAQ,gBAAgB;IACzD,YAAY,SAAiB,EAAE,KAAU;QACvC,KAAK,CAAC,sBAAsB,SAAS,MAAM,KAAK,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { HlsStreamerOptions } from "./Interfaces/HlsStreamer";
+export declare class HlsStreamer {
+    private readonly filePath;
+    private readonly segmentSize;
+    private readonly fileName;
+    private readonly baseUrl;
+    private readonly enableFastStart;
+    private fileInfo?;
+    private segmentCache;
+    constructor(options: HlsStreamerOptions);
+    private validateOptions;
+    private validateFile;
+    private getFileInfo;
+    getFileBuffer(startByte: number, endByte: number): Promise<Buffer>;
+    createM3U8(): Promise<string>;
+    private calculateSegmentCount;
+    private estimateSegmentDuration;
+    private buildSegmentUrl;
+    private calculateSegmentSize;
+    private calculateSegment;
+    private calculatefirst2SegmentSize;
+    private padNumber;
+    getSegmentDuration(segmentIndex: number): Promise<number>;
+}
+export * from './Interfaces/HlsStreamer';
+export * from './errors/HlsStreamerErrors';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAA4B,MAAM,0BAA0B,CAAC;AAYxF,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,CAAc;IAC/B,OAAO,CAAC,YAAY,CAAkC;gBAK1C,OAAO,EAAE,kBAAkB;IAWvC,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,YAAY;YAgBN,WAAW;IA2BnB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBlE,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IA6BnC,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,0BAA0B;IAIlC,OAAO,CAAC,SAAS;IAOX,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAoBhE;AAGD,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,207 @@
+import fs from "node:fs";
+import path from "node:path";
+import { FileLib } from "./Libs/FileLib";
+import { FileNotFoundError, InvalidFileError, InvalidRangeError, InvalidParameterError } from "./errors/HlsStreamerErrors";
+export class HlsStreamer {
+    constructor(options) {
+        Object.defineProperty(this, "filePath", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "segmentSize", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "fileName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "baseUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "enableFastStart", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "fileInfo", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "segmentCache", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        this.validateOptions(options);
+        this.validateFile(options.filePath);
+        this.filePath = options.filePath;
+        this.segmentSize = (options.segmentSizeKB ?? 512) * 1024;
+        this.fileName = options.fileName ?? "file";
+        this.baseUrl = options.baseUrl ?? "";
+        this.enableFastStart = options.enableFastStart ?? false;
+    }
+    validateOptions(options) {
+        if (!options.filePath || typeof options.filePath !== 'string') {
+            throw new InvalidParameterError('filePath', options.filePath);
+        }
+        if (options.segmentSizeKB !== undefined &&
+            (typeof options.segmentSizeKB !== 'number' || options.segmentSizeKB <= 0)) {
+            throw new InvalidParameterError('segmentSizeKB', options.segmentSizeKB);
+        }
+        if (options.fileName !== undefined && typeof options.fileName !== 'string') {
+            throw new InvalidParameterError('fileName', options.fileName);
+        }
+    }
+    validateFile(filePath) {
+        if (!fs.existsSync(filePath)) {
+            throw new FileNotFoundError(filePath);
+        }
+        const stat = fs.statSync(filePath);
+        if (!stat.isFile()) {
+            throw new InvalidFileError('Path is not a file');
+        }
+        const ext = path.extname(filePath).toLowerCase();
+        if (ext !== '.mp3') {
+            throw new InvalidFileError('Only MP3 files are supported');
+        }
+    }
+    async getFileInfo() {
+        if (!this.fileInfo) {
+            const stat = await fs.promises.stat(this.filePath);
+            const size = stat.size;
+            if (size <= 0) {
+                throw new InvalidFileError('File is empty');
+            }
+            if (this.segmentSize > size) {
+                throw new InvalidFileError('Segment size is larger than file size');
+            }
+            this.fileInfo = {
+                size,
+                duration: 0
+            };
+        }
+        return this.fileInfo;
+    }
+    async getFileBuffer(startByte, endByte) {
+        if (isNaN(startByte) || isNaN(endByte) || startByte < 0 || endByte < startByte) {
+            throw new InvalidRangeError(startByte, endByte);
+        }
+        const fileInfo = await this.getFileInfo();
+        if (endByte > fileInfo.size) {
+            throw new InvalidRangeError(startByte, endByte);
+        }
+        const bufferLength = endByte - startByte;
+        const fd = fs.openSync(this.filePath, "r");
+        try {
+            const buffer = Buffer.alloc(bufferLength);
+            const bytesRead = fs.readSync(fd, buffer, 0, bufferLength, startByte);
+            return buffer.subarray(0, bytesRead);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    async createM3U8() {
+        const fileInfo = await this.getFileInfo();
+        const segmentCount = this.calculateSegmentCount(fileInfo.size);
+        const m3u8 = [
+            '#EXTM3U',
+            '#EXT-X-VERSION:6',
+            '#EXT-X-PLAYLIST-TYPE:VOD',
+            '#EXT-X-TARGETDURATION:14',
+            '#EXT-X-MEDIA-SEQUENCE:0',
+        ];
+        for (let i = 0; i < segmentCount; i++) {
+            const { start, end } = this.calculateSegment(i, fileInfo.size);
+            const estimatedDuration = this.estimateSegmentDuration(end - start);
+            const segmentUrl = this.buildSegmentUrl(start, end, i);
+            m3u8.push(`#EXTINF:${estimatedDuration.toFixed(3)}`);
+            m3u8.push(segmentUrl);
+        }
+        m3u8.push('#EXT-X-ENDLIST');
+        return m3u8.join('\n');
+    }
+    calculateSegmentCount(fileSize) {
+        if (!this.enableFastStart) {
+            return Math.ceil(fileSize / this.segmentSize);
+        }
+        const firstTwoSegmentsSize = this.calculatefirst2SegmentSize();
+        const remainingSize = fileSize - firstTwoSegmentsSize;
+        return Math.ceil(remainingSize / this.segmentSize) + 2;
+    }
+    estimateSegmentDuration(segmentSize) {
+        const estimatedBytesPerSecond = 16000;
+        return segmentSize / estimatedBytesPerSecond;
+    }
+    buildSegmentUrl(start, end, index) {
+        const baseUrlPrefix = this.baseUrl ? `/${this.baseUrl}` : '';
+        return `${baseUrlPrefix}/${start}/${end}/${this.fileName}${this.padNumber(index, 3)}.mp3`;
+    }
+    calculateSegmentSize(segmentIndex) {
+        if (!this.enableFastStart) {
+            return this.segmentSize;
+        }
+        switch (segmentIndex) {
+            case 0:
+                return this.segmentSize / 4;
+            case 1:
+                return this.segmentSize / 2;
+            default:
+                return this.segmentSize;
+        }
+    }
+    calculateSegment(segmentIndex, fileSize) {
+        let start = 0;
+        if (this.enableFastStart && segmentIndex < 2) {
+            start = segmentIndex * (this.segmentSize / 4);
+        }
+        else if (this.enableFastStart) {
+            start = (3 * this.segmentSize) / 4 + (segmentIndex - 2) * this.segmentSize;
+        }
+        else {
+            start = segmentIndex * this.segmentSize;
+        }
+        const segmentSize = this.calculateSegmentSize(segmentIndex);
+        const end = Math.min(start + segmentSize, fileSize);
+        return { start: Math.floor(start), end: Math.floor(end) };
+    }
+    calculatefirst2SegmentSize() {
+        return (this.segmentSize / 4) * 3;
+    }
+    padNumber(value, padding) {
+        return value.toString().padStart(padding, '0');
+    }
+    async getSegmentDuration(segmentIndex) {
+        const cachedSegment = this.segmentCache.get(segmentIndex);
+        if (cachedSegment) {
+            return cachedSegment.duration;
+        }
+        const fileInfo = await this.getFileInfo();
+        const { start, end } = this.calculateSegment(segmentIndex, fileInfo.size);
+        const segmentBuffer = await this.getFileBuffer(start, end);
+        const duration = await FileLib.getMP3DurationFromBuffer(segmentBuffer);
+        this.segmentCache.set(segmentIndex, {
+            start,
+            end,
+            duration
+        });
+        return duration;
+    }
+}
+export * from './Interfaces/HlsStreamer';
+export * from './errors/HlsStreamerErrors';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "hls-streamer",
+  "version": "2.0.0",
+  "description": "Lightweight HLS streaming from MP3 files on demand, without temporary files or ffmpeg dependency",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rm -rf dist/ && npm run build:esm && npm run build:cjs",
+    "build:esm": "tsc",
+    "build:cjs": "tsc --module CommonJS --outDir dist/cjs",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "prepublishOnly": "npm run build && npm test",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LordVersA/hls-streamer.git"
+  },
+  "keywords": [
+    "hls",
+    "streaming",
+    "mp3",
+    "audio",
+    "http-live-streaming",
+    "media",
+    "ffmpeg-free",
+    "on-demand",
+    "typescript",
+    "nodejs"
+  ],
+  "author": {
+    "name": "LordVersA",
+    "url": "https://github.com/LordVersA"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/LordVersA/hls-streamer/issues"
+  },
+  "homepage": "https://github.com/LordVersA/hls-streamer#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.8.3",
+    "jest": "^30.1.3",
+    "ts-jest": "^29.4.4",
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "mp3-duration": "^1.1.0"
+  }
+}