ahmad-module 1.0.0

package/jsprim/package.json

@@ -0,0 +1,20 @@
+{
+	"name": "jsprim",
+	"version": "1.4.2",
+	"description": "utilities for primitive JavaScript types",
+	"main": "./lib/jsprim.js",
+	"repository": {
+		"type": "git",
+		"url": "git://github.com/joyent/node-jsprim.git"
+	},
+	"dependencies": {
+		"assert-plus": "1.0.0",
+		"extsprintf": "1.3.0",
+		"json-schema": "0.4.0",
+		"verror": "1.10.0"
+	},
+	"engines": {
+		"node": ">=0.6.0"
+	},
+	"license": "MIT"
+}

package/m3u8stream/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) 2017 by fent
+
+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/m3u8stream/README.md

@@ -0,0 +1,81 @@
+# node-m3u8stream
+
+Reads segments from a [m3u8 playlist][1] or [DASH MPD file][2] into a consumable stream.
+
+[1]: https://tools.ietf.org/html/draft-pantos-http-live-streaming-20
+[2]: https://dashif.org/docs/DASH-IF-IOP-v4.2-clean.pdf
+
+![Depfu](https://img.shields.io/depfu/fent/node-m3u8stream)
+[![codecov](https://codecov.io/gh/fent/node-m3u8stream/branch/master/graph/badge.svg)](https://codecov.io/gh/fent/node-m3u8stream)
+
+
+# Usage
+
+```js
+const fs = require('fs');
+const m3u8stream = require('m3u8stream')
+
+m3u8stream('http://somesite.com/link/to/the/playlist.m3u8')
+    .pipe(fs.createWriteStream('videofile.mp4'));
+```
+
+
+# API
+
+### m3u8stream(url, [options])
+
+Creates a readable stream of binary media data. `options` can have the following
+
+* `begin` - Where to begin playing the video. Accepts an absolute unix timestamp or date and a relative time in the formats `1:23:45.123` and `1m2s`.
+* `liveBuffer` - How much buffer in milliseconds to have for live streams. Default is `20000`.
+* `chunkReadahead` - How many chunks to preload ahead. Default is `3`.
+* `highWaterMark` - How much of the download to buffer into the stream. See [node's docs](https://nodejs.org/api/stream.html#stream_constructor_new_stream_writable_options) for more. Note that the actual amount buffered can be higher since each chunk request maintains its own buffer.
+* `requestOptions` - Any options you want to pass to [miniget](https://github.com/fent/node-miniget), such as `headers`.
+* `parser` - Either "m3u8" or "dash-mpd". Defaults to guessing based on the playlist url ending in `.m3u8` or `.mpd`.
+* `id` - For playlist containing multiple media options. If not given, the first representation will be picked.
+
+### Stream#end()
+
+If called, stops requesting segments, and refreshing the playlist.
+
+#### Event: progress
+* `Object` - Current segment with the following fields,
+  - `number` - num
+  - `number` - size
+  - `number` - duration
+  - `string` - url
+* `number` - Total number of segments.
+* `number` - Bytes downloaded up to this point.
+
+For static non-live playlists, emitted each time a segment has finished downloading. Since total download size is unknown until all segment endpoints are hit, progress is calculated based on how many segments are available.
+
+#### miniget events
+
+All [miniget events](https://github.com/fent/node-miniget#event-redirect) are forwarded and can be listened to from the returned stream.
+
+### m3u8stream.parseTimestamp(time)
+
+Converts human friendly time to milliseconds. Supports the format  
+00:00:00.000 for hours, minutes, seconds, and milliseconds respectively.  
+And 0ms, 0s, 0m, 0h, and together 1m1s.
+
+* `time` - A string (or number) giving the user-readable input data
+
+### Limitations
+
+Currently, it does not support [encrypted media segments](https://tools.ietf.org/html/draft-pantos-http-live-streaming-20#section-4.3.2.4). This is because the sites where this was tested on and intended for, YouTube and Twitch, don't use it.
+
+This does not parse master playlists, only media playlists. If you want to parse a master playlist to get links to media playlists, you can try the [m3u8 module](https://github.com/tedconf/node-m3u8).
+
+
+# Install
+
+    npm install m3u8stream
+
+
+# Tests
+Tests are written with [mocha](https://mochajs.org)
+
+```bash
+npm test
+```

package/m3u8stream/dist/dash-mpd-parser.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="node" />
+import { Writable } from 'stream';
+import { Parser } from './parser';
+/**
+ * A wrapper around sax that emits segments.
+ */
+export default class DashMPDParser extends Writable implements Parser {
+    private _parser;
+    constructor(targetID?: string);
+    _write(chunk: Buffer, encoding: string, callback: () => void): void;
+}

package/m3u8stream/dist/dash-mpd-parser.js

@@ -0,0 +1,183 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const stream_1 = require("stream");
+const sax_1 = __importDefault(require("sax"));
+const parse_time_1 = require("./parse-time");
+/**
+ * A wrapper around sax that emits segments.
+ */
+class DashMPDParser extends stream_1.Writable {
+    constructor(targetID) {
+        super();
+        this._parser = sax_1.default.createStream(false, { lowercase: true });
+        this._parser.on('error', this.destroy.bind(this));
+        let lastTag;
+        let currtime = 0;
+        let seq = 0;
+        let segmentTemplate;
+        let timescale, offset, duration, baseURL;
+        let timeline = [];
+        let getSegments = false;
+        let gotSegments = false;
+        let isStatic;
+        let treeLevel;
+        let periodStart;
+        const tmpl = (str) => {
+            const context = {
+                RepresentationID: targetID,
+                Number: seq,
+                Time: currtime,
+            };
+            return str.replace(/\$(\w+)\$/g, (m, p1) => `${context[p1]}`);
+        };
+        this._parser.on('opentag', node => {
+            switch (node.name) {
+                case 'mpd':
+                    currtime =
+                        node.attributes.availabilitystarttime ?
+                            new Date(node.attributes.availabilitystarttime).getTime() : 0;
+                    isStatic = node.attributes.type !== 'dynamic';
+                    break;
+                case 'period':
+                    // Reset everything on <Period> tag.
+                    seq = 0;
+                    timescale = 1000;
+                    duration = 0;
+                    offset = 0;
+                    baseURL = [];
+                    treeLevel = 0;
+                    periodStart = parse_time_1.durationStr(node.attributes.start) || 0;
+                    break;
+                case 'segmentlist':
+                    seq = parseInt(node.attributes.startnumber) || seq;
+                    timescale = parseInt(node.attributes.timescale) || timescale;
+                    duration = parseInt(node.attributes.duration) || duration;
+                    offset = parseInt(node.attributes.presentationtimeoffset) || offset;
+                    break;
+                case 'segmenttemplate':
+                    segmentTemplate = node.attributes;
+                    seq = parseInt(node.attributes.startnumber) || seq;
+                    timescale = parseInt(node.attributes.timescale) || timescale;
+                    break;
+                case 'segmenttimeline':
+                case 'baseurl':
+                    lastTag = node.name;
+                    break;
+                case 's':
+                    timeline.push({
+                        duration: parseInt(node.attributes.d),
+                        repeat: parseInt(node.attributes.r),
+                        time: parseInt(node.attributes.t),
+                    });
+                    break;
+                case 'adaptationset':
+                case 'representation':
+                    treeLevel++;
+                    if (!targetID) {
+                        targetID = node.attributes.id;
+                    }
+                    getSegments = node.attributes.id === `${targetID}`;
+                    if (getSegments) {
+                        if (periodStart) {
+                            currtime += periodStart;
+                        }
+                        if (offset) {
+                            currtime -= offset / timescale * 1000;
+                        }
+                        this.emit('starttime', currtime);
+                    }
+                    break;
+                case 'initialization':
+                    if (getSegments) {
+                        this.emit('item', {
+                            url: baseURL.filter(s => !!s).join('') + node.attributes.sourceurl,
+                            seq: seq,
+                            init: true,
+                            duration: 0,
+                        });
+                    }
+                    break;
+                case 'segmenturl':
+                    if (getSegments) {
+                        gotSegments = true;
+                        let tl = timeline.shift();
+                        let segmentDuration = ((tl === null || tl === void 0 ? void 0 : tl.duration) || duration) / timescale * 1000;
+                        this.emit('item', {
+                            url: baseURL.filter(s => !!s).join('') + node.attributes.media,
+                            seq: seq++,
+                            duration: segmentDuration,
+                        });
+                        currtime += segmentDuration;
+                    }
+                    break;
+            }
+        });
+        const onEnd = () => {
+            if (isStatic) {
+                this.emit('endlist');
+            }
+            if (!getSegments) {
+                this.destroy(Error(`Representation '${targetID}' not found`));
+            }
+            else {
+                this.emit('end');
+            }
+        };
+        this._parser.on('closetag', tagName => {
+            switch (tagName) {
+                case 'adaptationset':
+                case 'representation':
+                    treeLevel--;
+                    if (segmentTemplate && timeline.length) {
+                        gotSegments = true;
+                        if (segmentTemplate.initialization) {
+                            this.emit('item', {
+                                url: baseURL.filter(s => !!s).join('') +
+                                    tmpl(segmentTemplate.initialization),
+                                seq: seq,
+                                init: true,
+                                duration: 0,
+                            });
+                        }
+                        for (let { duration: itemDuration, repeat, time } of timeline) {
+                            itemDuration = itemDuration / timescale * 1000;
+                            repeat = repeat || 1;
+                            currtime = time || currtime;
+                            for (let i = 0; i < repeat; i++) {
+                                this.emit('item', {
+                                    url: baseURL.filter(s => !!s).join('') +
+                                        tmpl(segmentTemplate.media),
+                                    seq: seq++,
+                                    duration: itemDuration,
+                                });
+                                currtime += itemDuration;
+                            }
+                        }
+                    }
+                    if (gotSegments) {
+                        this.emit('endearly');
+                        onEnd();
+                        this._parser.removeAllListeners();
+                        this.removeAllListeners('finish');
+                    }
+                    break;
+            }
+        });
+        this._parser.on('text', text => {
+            if (lastTag === 'baseurl') {
+                baseURL[treeLevel] = text;
+                lastTag = null;
+            }
+        });
+        this.on('finish', onEnd);
+    }
+    _write(chunk, encoding, callback) {
+        this._parser.write(chunk);
+        callback();
+    }
+}
+exports.default = DashMPDParser;
+//# sourceMappingURL=dash-mpd-parser.js.map

package/m3u8stream/dist/dash-mpd-parser.js.map

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

package/m3u8stream/dist/index.d.ts

@@ -0,0 +1,31 @@
+/// <reference types="node" />
+import { PassThrough } from 'stream';
+import miniget from 'miniget';
+declare namespace m3u8stream {
+    interface Options {
+        begin?: number | string;
+        liveBuffer?: number;
+        chunkReadahead?: number;
+        highWaterMark?: number;
+        requestOptions?: miniget.Options;
+        parser?: 'm3u8' | 'dash-mpd';
+        id?: string;
+    }
+    interface Progress {
+        num: number;
+        size: number;
+        duration: number;
+        url: string;
+    }
+    interface Stream extends PassThrough {
+        end: () => this;
+        on(event: 'progress', listener: (progress: Progress, totalSegments: number, downloadedBytes: number) => void): this;
+        on(event: string | symbol, listener: (...args: any) => void): this;
+    }
+    interface m3u8streamFunc {
+        (playlistURL: string, options?: m3u8stream.Options): Stream;
+        parseTimestamp(time: number | string): number;
+    }
+}
+declare let m3u8stream: m3u8stream.m3u8streamFunc;
+export = m3u8stream;

package/m3u8stream/dist/index.js

@@ -0,0 +1,180 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const stream_1 = require("stream");
+const miniget_1 = __importDefault(require("miniget"));
+const m3u8_parser_1 = __importDefault(require("./m3u8-parser"));
+const dash_mpd_parser_1 = __importDefault(require("./dash-mpd-parser"));
+const queue_1 = require("./queue");
+const parse_time_1 = require("./parse-time");
+const supportedParsers = {
+    m3u8: m3u8_parser_1.default,
+    'dash-mpd': dash_mpd_parser_1.default,
+};
+let m3u8stream = ((playlistURL, options = {}) => {
+    const stream = new stream_1.PassThrough({ highWaterMark: options.highWaterMark });
+    const chunkReadahead = options.chunkReadahead || 3;
+    // 20 seconds.
+    const liveBuffer = options.liveBuffer || 20000;
+    const requestOptions = options.requestOptions;
+    const Parser = supportedParsers[options.parser || (/\.mpd$/.test(playlistURL) ? 'dash-mpd' : 'm3u8')];
+    if (!Parser) {
+        throw TypeError(`parser '${options.parser}' not supported`);
+    }
+    let begin = 0;
+    if (typeof options.begin !== 'undefined') {
+        begin = typeof options.begin === 'string' ?
+            parse_time_1.humanStr(options.begin) :
+            Math.max(options.begin - liveBuffer, 0);
+    }
+    const forwardEvents = (req) => {
+        for (let event of ['abort', 'request', 'response', 'redirect', 'retry', 'reconnect']) {
+            req.on(event, stream.emit.bind(stream, event));
+        }
+    };
+    let currSegment;
+    const streamQueue = new queue_1.Queue((req, callback) => {
+        currSegment = req;
+        // Count the size manually, since the `content-length` header is not
+        // always there.
+        let size = 0;
+        req.on('data', (chunk) => size += chunk.length);
+        req.pipe(stream, { end: false });
+        req.on('end', () => callback(null, size));
+    }, { concurrency: 1 });
+    let segmentNumber = 0;
+    let downloaded = 0;
+    const requestQueue = new queue_1.Queue((segment, callback) => {
+        let reqOptions = Object.assign({}, requestOptions);
+        if (segment.range) {
+            reqOptions.headers = Object.assign({}, reqOptions.headers, {
+                Range: `bytes=${segment.range.start}-${segment.range.end}`,
+            });
+        }
+        let req = miniget_1.default(new URL(segment.url, playlistURL).toString(), reqOptions);
+        req.on('error', callback);
+        forwardEvents(req);
+        streamQueue.push(req, (_, size) => {
+            downloaded += +size;
+            stream.emit('progress', {
+                num: ++segmentNumber,
+                size: size,
+                duration: segment.duration,
+                url: segment.url,
+            }, requestQueue.total, downloaded);
+            callback(null);
+        });
+    }, { concurrency: chunkReadahead });
+    const onError = (err) => {
+        stream.emit('error', err);
+        // Stop on any error.
+        stream.end();
+    };
+    // When to look for items again.
+    let refreshThreshold;
+    let minRefreshTime;
+    let refreshTimeout;
+    let fetchingPlaylist = true;
+    let ended = false;
+    let isStatic = false;
+    let lastRefresh;
+    const onQueuedEnd = (err) => {
+        currSegment = null;
+        if (err) {
+            onError(err);
+        }
+        else if (!fetchingPlaylist && !ended && !isStatic &&
+            requestQueue.tasks.length + requestQueue.active <= refreshThreshold) {
+            let ms = Math.max(0, minRefreshTime - (Date.now() - lastRefresh));
+            fetchingPlaylist = true;
+            refreshTimeout = setTimeout(refreshPlaylist, ms);
+        }
+        else if ((ended || isStatic) &&
+            !requestQueue.tasks.length && !requestQueue.active) {
+            stream.end();
+        }
+    };
+    let currPlaylist;
+    let lastSeq;
+    let starttime = 0;
+    const refreshPlaylist = () => {
+        lastRefresh = Date.now();
+        currPlaylist = miniget_1.default(playlistURL, requestOptions);
+        currPlaylist.on('error', onError);
+        forwardEvents(currPlaylist);
+        const parser = currPlaylist.pipe(new Parser(options.id));
+        parser.on('starttime', (a) => {
+            if (starttime) {
+                return;
+            }
+            starttime = a;
+            if (typeof options.begin === 'string' && begin >= 0) {
+                begin += starttime;
+            }
+        });
+        parser.on('endlist', () => { isStatic = true; });
+        parser.on('endearly', currPlaylist.unpipe.bind(currPlaylist, parser));
+        let addedItems = [];
+        const addItem = (item) => {
+            if (!item.init) {
+                if (item.seq <= lastSeq) {
+                    return;
+                }
+                lastSeq = item.seq;
+            }
+            begin = item.time;
+            requestQueue.push(item, onQueuedEnd);
+            addedItems.push(item);
+        };
+        let tailedItems = [], tailedItemsDuration = 0;
+        parser.on('item', (item) => {
+            let timedItem = Object.assign({ time: starttime }, item);
+            if (begin <= timedItem.time) {
+                addItem(timedItem);
+            }
+            else {
+                tailedItems.push(timedItem);
+                tailedItemsDuration += timedItem.duration;
+                // Only keep the last `liveBuffer` of items.
+                while (tailedItems.length > 1 &&
+                    tailedItemsDuration - tailedItems[0].duration > liveBuffer) {
+                    const lastItem = tailedItems.shift();
+                    tailedItemsDuration -= lastItem.duration;
+                }
+            }
+            starttime += timedItem.duration;
+        });
+        parser.on('end', () => {
+            currPlaylist = null;
+            // If we are too ahead of the stream, make sure to get the
+            // latest available items with a small buffer.
+            if (!addedItems.length && tailedItems.length) {
+                tailedItems.forEach(item => { addItem(item); });
+            }
+            // Refresh the playlist when remaining segments get low.
+            refreshThreshold = Math.max(1, Math.ceil(addedItems.length * 0.01));
+            // Throttle refreshing the playlist by looking at the duration
+            // of live items added on this refresh.
+            minRefreshTime =
+                addedItems.reduce((total, item) => item.duration + total, 0);
+            fetchingPlaylist = false;
+            onQueuedEnd(null);
+        });
+    };
+    refreshPlaylist();
+    stream.end = () => {
+        ended = true;
+        streamQueue.die();
+        requestQueue.die();
+        clearTimeout(refreshTimeout);
+        currPlaylist === null || currPlaylist === void 0 ? void 0 : currPlaylist.destroy();
+        currSegment === null || currSegment === void 0 ? void 0 : currSegment.destroy();
+        stream_1.PassThrough.prototype.end.call(stream, null);
+        return stream;
+    };
+    return stream;
+});
+m3u8stream.parseTimestamp = parse_time_1.humanStr;
+module.exports = m3u8stream;
+//# sourceMappingURL=index.js.map

package/m3u8stream/dist/index.js.map

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

package/m3u8stream/dist/m3u8-parser.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="node" />
+import { Writable } from 'stream';
+import { Parser } from './parser';
+/**
+ * A very simple m3u8 playlist file parser that detects tags and segments.
+ */
+export default class m3u8Parser extends Writable implements Parser {
+    private _lastLine;
+    private _seq;
+    private _nextItemDuration;
+    private _nextItemRange;
+    private _lastItemRangeEnd;
+    constructor();
+    private _parseAttrList;
+    private _parseRange;
+    _parseLine(line: string): void;
+    _write(chunk: Buffer, encoding: string, callback: () => void): void;
+}