@remotion/media-parser 4.0.191

package/.eslintrc

@@ -0,0 +1,8 @@
+{
+	"extends": "@jonny/eslint-config",
+	"rules": {
+		"no-bitwise": "off",
+		"@typescript-eslint/no-use-before-define": "off",
+		"no-console": "error",
+	},
+}

package/LICENSE.md

@@ -0,0 +1,49 @@
+# Remotion License
+
+In Remotion 5.0, the license will slightly change. [View the changes here](https://github.com/remotion-dev/remotion/pull/3750).
+
+---
+
+Depending on the type of your legal entity, you are granted permission to use Remotion for your project. Individuals and small companies are allowed to use Remotion to create videos for free (even commercial), while a company license is required for for-profit organizations of a certain size. This two-tier system was designed to ensure funding for this project while still allowing the source code to be available and the program to be free for most. Read below for the exact terms of use.
+
+- [Free license](#free-license)
+- [Company license](#company-license)
+
+## Free license
+
+Copyright © 2024 [Remotion](https://www.remotion.dev)
+
+### Eligibility
+
+You are eligible to use Remotion for free if you are:
+
+- an individual
+- a for-profit organization with up to 3 employees
+- a non-profit or not-for-profit organization
+- evaluating whether Remotion is a good fit, and are not yet using it in a commercial way
+
+### Allowed use cases
+
+Permission is hereby granted, free of charge, to any person eligible for the "Free license", to use the software non-commercially or commercially for the purpose of creating videos and images and to modify the software to their own liking, for the purpose of fulfilling their custom use case or to contribute bug fixes or improvements back to Remotion.
+
+### Disallowed use cases
+
+It is not allowed to copy or modify Remotion code for the purpose of selling, renting, licensing, relicensing, or sublicensing your own derivate of Remotion.
+
+### Warranty notice
+
+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 non-infringement. In no event shall the author 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.
+
+### Support
+
+Support is provided on a best-we-can-do basis via GitHub Issues and Discord.
+
+## Company license
+
+You are required to obtain a company license to use Remotion if you are not within the group of entities eligible for a free license. This license will enable you to use Remotion for the allowed use cases specified in the free license, and give you access to prioritized support (read the [Support Policy](https://www.remotion.dev/docs/support)).
+
+Visit [remotion.pro](https://www.remotion.pro/license) for pricing and to buy a license.
+
+### FAQs
+
+Are you not sure whether you need a company license because of an edge case? Here are some [frequently asked questions](https://www.remotion.pro/faq).

package/README.md

@@ -0,0 +1,18 @@
+# @remotion/media-parser
+ 
+A pure JavaScript library for parsing video files
+ 
+[![NPM Downloads](https://img.shields.io/npm/dm/@remotion/media-parser.svg?style=flat&color=black&label=Downloads)](https://npmcharts.com/compare/@remotion/media-parser?minimal=true)
+ 
+## Installation
+ 
+```bash
+npm install @remotion/media-parser --save-exact
+```
+ 
+When installing a Remotion package, make sure to align the version of all `remotion` and `@remotion/*` packages to the same version.
+Remove the `^` character from the version number to use the exact version.
+ 
+## Usage
+ 
+See the [documentation](https://www.remotion.dev/docs/media-parser) for more information.

package/dist/boxes/iso-base-media/base-type.d.ts

@@ -0,0 +1,4 @@
+export interface BaseBox {
+    boxSize: number;
+    offset: number;
+}

package/dist/boxes/iso-base-media/base-type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/boxes/iso-base-media/ftyp.d.ts

@@ -0,0 +1,13 @@
+import type { BufferIterator } from '../../buffer-iterator';
+import type { BaseBox } from './base-type';
+export interface FtypBox extends BaseBox {
+    type: 'ftyp-box';
+    majorBrand: string;
+    minorVersion: number;
+    compatibleBrands: string[];
+}
+export declare const parseFtyp: ({ iterator, size, offset, }: {
+    iterator: BufferIterator;
+    size: number;
+    offset: number;
+}) => FtypBox;

package/dist/boxes/iso-base-media/ftyp.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFtyp = void 0;
+const parseFtyp = ({ iterator, size, offset, }) => {
+    const majorBrand = iterator.getByteString(4);
+    const minorVersion = iterator.getFourByteNumber();
+    const types = (size - iterator.counter.getOffset()) / 4;
+    const compatibleBrands = [];
+    for (let i = 0; i < types; i++) {
+        compatibleBrands.push(iterator.getByteString(4).trim());
+    }
+    const offsetAtEnd = iterator.counter.getOffset();
+    return {
+        type: 'ftyp-box',
+        majorBrand,
+        minorVersion,
+        compatibleBrands,
+        offset,
+        boxSize: offsetAtEnd - offset,
+    };
+};
+exports.parseFtyp = parseFtyp;

package/dist/boxes/iso-base-media/moov/moov.d.ts

@@ -0,0 +1,12 @@
+import type { BufferIterator } from '../../../buffer-iterator';
+import type { AnySegment } from '../../../parse-result';
+import type { BaseBox } from '../base-type';
+export interface MoovBox extends BaseBox {
+    type: 'moov-box';
+    children: AnySegment[];
+}
+export declare const parseMoov: ({ iterator, offset, size, }: {
+    iterator: BufferIterator;
+    offset: number;
+    size: number;
+}) => MoovBox;

package/dist/boxes/iso-base-media/moov/moov.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMoov = void 0;
+const process_box_1 = require("../process-box");
+const parseMoov = ({ iterator, offset, size, }) => {
+    const children = (0, process_box_1.parseBoxes)({
+        iterator,
+        maxBytes: size - (iterator.counter.getOffset() - offset),
+        allowIncompleteBoxes: false,
+        initialBoxes: [],
+    });
+    if (children.status === 'incomplete') {
+        throw new Error('Incomplete boxes are not allowed');
+    }
+    return {
+        offset,
+        boxSize: size,
+        type: 'moov-box',
+        children: children.segments,
+    };
+};
+exports.parseMoov = parseMoov;

package/dist/boxes/iso-base-media/mvhd.d.ts

@@ -0,0 +1,30 @@
+import type { BufferIterator } from '../../buffer-iterator';
+import type { BaseBox } from './base-type';
+export type ThreeDMatrix = [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+];
+export interface MvhdBox extends BaseBox {
+    durationInUnits: number;
+    durationInSeconds: number;
+    creationTime: number | null;
+    modificationTime: number | null;
+    timeScale: number;
+    rate: number;
+    volume: number;
+    matrix: ThreeDMatrix;
+    nextTrackId: number;
+    type: 'mvhd-box';
+}
+export declare const parseMvhd: ({ iterator, offset, size, }: {
+    iterator: BufferIterator;
+    offset: number;
+    size: number;
+}) => MvhdBox;

package/dist/boxes/iso-base-media/mvhd.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMvhd = void 0;
+const buffer_iterator_1 = require("../../buffer-iterator");
+const to_date_1 = require("./to-date");
+const parseMvhd = ({ iterator, offset, size, }) => {
+    const version = iterator.getUint8();
+    if (version !== 0) {
+        throw new Error(`Unsupported MVHD version ${version}`);
+    }
+    if (size !== 108) {
+        throw new Error(`Expected mvhd size of version 0 to be 108, got ${size}`);
+    }
+    // Flags, we discard them
+    iterator.discard(3);
+    const creationTime = iterator.getUint32();
+    const modificationTime = iterator.getUint32();
+    const timeScale = iterator.getUint32();
+    const durationInUnits = iterator.getUint32();
+    const durationInSeconds = durationInUnits / timeScale;
+    const rateArray = iterator.getSlice(4);
+    const rateView = (0, buffer_iterator_1.getArrayBufferIterator)(rateArray);
+    const rate = rateView.getInt8() * 10 +
+        rateView.getInt8() +
+        rateView.getInt8() * 0.1 +
+        rateView.getInt8() * 0.01;
+    const volumeArray = iterator.getSlice(2);
+    const volumeView = (0, buffer_iterator_1.getArrayBufferIterator)(volumeArray);
+    const volume = volumeView.getInt8() + volumeView.getInt8() * 0.1;
+    // reserved 16bit
+    iterator.discard(2);
+    // reserved 32bit x2
+    iterator.discard(4);
+    iterator.discard(4);
+    // matrix
+    const matrix = [];
+    for (let i = 0; i < 9; i++) {
+        matrix.push(iterator.getUint32());
+    }
+    // pre-defined
+    iterator.discard(4 * 6);
+    // next track id
+    const nextTrackId = iterator.getUint32();
+    return {
+        creationTime: (0, to_date_1.toUnixTimestamp)(creationTime),
+        modificationTime: (0, to_date_1.toUnixTimestamp)(modificationTime),
+        timeScale,
+        durationInUnits,
+        durationInSeconds,
+        rate,
+        volume,
+        matrix: matrix,
+        nextTrackId,
+        type: 'mvhd-box',
+        boxSize: size,
+        offset,
+    };
+};
+exports.parseMvhd = parseMvhd;

package/dist/boxes/iso-base-media/process-box.d.ts

@@ -0,0 +1,8 @@
+import type { BufferIterator } from '../../buffer-iterator';
+import type { IsoBaseMediaBox, ParseResult } from '../../parse-result';
+export declare const parseBoxes: ({ iterator, maxBytes, allowIncompleteBoxes, initialBoxes, }: {
+    iterator: BufferIterator;
+    maxBytes: number;
+    allowIncompleteBoxes: boolean;
+    initialBoxes: IsoBaseMediaBox[];
+}) => ParseResult;

package/dist/boxes/iso-base-media/process-box.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBoxes = void 0;
+const ftyp_1 = require("./ftyp");
+const moov_1 = require("./moov/moov");
+const mvhd_1 = require("./mvhd");
+const mebx_1 = require("./stsd/mebx");
+const stsd_1 = require("./stsd/stsd");
+const stts_1 = require("./stts/stts");
+const tkhd_1 = require("./tkhd");
+const trak_1 = require("./trak/trak");
+const getChildren = ({ boxType, iterator, bytesRemainingInBox, }) => {
+    const parseChildren = boxType === 'mdia' ||
+        boxType === 'minf' ||
+        boxType === 'stbl' ||
+        boxType === 'dims' ||
+        boxType === 'stsb';
+    if (parseChildren) {
+        const parsed = (0, exports.parseBoxes)({
+            iterator,
+            maxBytes: bytesRemainingInBox,
+            allowIncompleteBoxes: false,
+            initialBoxes: [],
+        });
+        if (parsed.status === 'incomplete') {
+            throw new Error('Incomplete boxes are not allowed');
+        }
+        return parsed.segments;
+    }
+    iterator.discard(bytesRemainingInBox);
+    return [];
+};
+const processBox = ({ iterator, allowIncompleteBoxes, }) => {
+    const fileOffset = iterator.counter.getOffset();
+    const bytesRemaining = iterator.bytesRemaining();
+    const boxSize = iterator.getFourByteNumber();
+    if (boxSize === 0) {
+        throw new Error(`Expected box size of not 0, got ${boxSize}`);
+    }
+    if (bytesRemaining < boxSize) {
+        iterator.counter.decrement(iterator.counter.getOffset() - fileOffset);
+        if (allowIncompleteBoxes) {
+            return {
+                type: 'incomplete',
+            };
+        }
+        throw new Error(`Expected box size of ${bytesRemaining}, got ${boxSize}. Incomplete boxes are not allowed.`);
+    }
+    const boxType = iterator.getByteString(4);
+    if (boxType === 'ftyp') {
+        const box = (0, ftyp_1.parseFtyp)({ iterator, size: boxSize, offset: fileOffset });
+        return {
+            type: 'complete',
+            box,
+            size: boxSize,
+        };
+    }
+    if (boxType === 'mvhd') {
+        const box = (0, mvhd_1.parseMvhd)({ iterator, offset: fileOffset, size: boxSize });
+        return {
+            type: 'complete',
+            box,
+            size: boxSize,
+        };
+    }
+    if (boxType === 'tkhd') {
+        const box = (0, tkhd_1.parseTkhd)({ iterator, offset: fileOffset, size: boxSize });
+        return {
+            type: 'complete',
+            box,
+            size: boxSize,
+        };
+    }
+    if (boxType === 'stsd') {
+        const box = (0, stsd_1.parseStsd)({ iterator, offset: fileOffset, size: boxSize });
+        return {
+            type: 'complete',
+            box,
+            size: boxSize,
+        };
+    }
+    if (boxType === 'mebx') {
+        const box = (0, mebx_1.parseMebx)({ iterator, offset: fileOffset, size: boxSize });
+        return {
+            type: 'complete',
+            box,
+            size: boxSize,
+        };
+    }
+    if (boxType === 'moov') {
+        const box = (0, moov_1.parseMoov)({ iterator, offset: fileOffset, size: boxSize });
+        return {
+            type: 'complete',
+            box,
+            size: boxSize,
+        };
+    }
+    if (boxType === 'trak') {
+        const box = (0, trak_1.parseTrak)({
+            data: iterator,
+            size: boxSize,
+            offsetAtStart: fileOffset,
+        });
+        return {
+            type: 'complete',
+            box,
+            size: boxSize,
+        };
+    }
+    if (boxType === 'stts') {
+        const box = (0, stts_1.parseStts)({
+            data: iterator,
+            size: boxSize,
+            fileOffset,
+        });
+        return {
+            type: 'complete',
+            box,
+            size: boxSize,
+        };
+    }
+    const bytesRemainingInBox = boxSize - (iterator.counter.getOffset() - fileOffset);
+    const children = getChildren({
+        boxType,
+        iterator,
+        bytesRemainingInBox,
+    });
+    return {
+        type: 'complete',
+        box: {
+            type: 'regular-box',
+            boxType,
+            boxSize,
+            children,
+            offset: fileOffset,
+        },
+        size: boxSize,
+    };
+};
+const parseBoxes = ({ iterator, maxBytes, allowIncompleteBoxes, initialBoxes, }) => {
+    const boxes = initialBoxes;
+    const initialOffset = iterator.counter.getOffset();
+    while (iterator.bytesRemaining() > 0 &&
+        iterator.counter.getOffset() - initialOffset < maxBytes) {
+        const result = processBox({
+            iterator,
+            allowIncompleteBoxes,
+        });
+        if (result.type === 'incomplete') {
+            if (Number.isFinite(maxBytes)) {
+                throw new Error('maxBytes must be Infinity for top-level boxes');
+            }
+            return {
+                status: 'incomplete',
+                segments: boxes,
+                continueParsing: () => {
+                    return (0, exports.parseBoxes)({
+                        iterator,
+                        maxBytes,
+                        allowIncompleteBoxes,
+                        initialBoxes: boxes,
+                    });
+                },
+            };
+        }
+        boxes.push(result.box);
+        iterator.discardFirstBytes();
+    }
+    return {
+        status: 'done',
+        segments: boxes,
+    };
+};
+exports.parseBoxes = parseBoxes;

package/dist/boxes/iso-base-media/stsd/keys.d.ts

@@ -0,0 +1,5 @@
+import type { BaseBox } from '../base-type';
+export interface KeysBox extends BaseBox {
+    type: 'keys-box';
+}
+export declare const parseKeys: (data: Uint8Array, offset: number) => KeysBox;

package/dist/boxes/iso-base-media/stsd/keys.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseKeys = void 0;
+const buffer_iterator_1 = require("../../../buffer-iterator");
+const parseKeys = (data, offset) => {
+    const iterator = (0, buffer_iterator_1.getArrayBufferIterator)(data);
+    const size = iterator.getUint32();
+    if (size !== data.byteLength) {
+        throw new Error(`Expected keys size of ${data.byteLength}, got ${size}`);
+    }
+    const atom = iterator.getAtom();
+    if (atom !== 'keys') {
+        throw new Error(`Expected keys type of keys, got ${atom}`);
+    }
+    return {
+        type: 'keys-box',
+        boxSize: data.byteLength,
+        offset,
+    };
+};
+exports.parseKeys = parseKeys;

package/dist/boxes/iso-base-media/stsd/mebx.d.ts

@@ -0,0 +1,14 @@
+import type { BufferIterator } from '../../../buffer-iterator';
+import type { AnySegment } from '../../../parse-result';
+import type { BaseBox } from '../base-type';
+export interface MebxBox extends BaseBox {
+    type: 'mebx-box';
+    dataReferenceIndex: number;
+    format: string;
+    children: AnySegment[];
+}
+export declare const parseMebx: ({ iterator, offset, size, }: {
+    iterator: BufferIterator;
+    offset: number;
+    size: number;
+}) => MebxBox;

package/dist/boxes/iso-base-media/stsd/mebx.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMebx = void 0;
+const process_box_1 = require("../process-box");
+const parseMebx = ({ iterator, offset, size, }) => {
+    // reserved, 6 bit
+    iterator.discard(6);
+    const dataReferenceIndex = iterator.getUint16();
+    const children = (0, process_box_1.parseBoxes)({
+        iterator,
+        maxBytes: iterator.counter.getOffset() - offset,
+        allowIncompleteBoxes: false,
+        initialBoxes: [],
+    });
+    if (children.status === 'incomplete') {
+        throw new Error('Incomplete boxes are not allowed');
+    }
+    return {
+        type: 'mebx-box',
+        boxSize: size,
+        offset,
+        dataReferenceIndex,
+        format: 'mebx',
+        children: children.segments,
+    };
+};
+exports.parseMebx = parseMebx;

package/dist/boxes/iso-base-media/stsd/samples.d.ts

@@ -0,0 +1,48 @@
+import type { BufferIterator } from '../../../buffer-iterator';
+type SampleBase = {
+    format: string;
+    offset: number;
+    dataReferenceIndex: number;
+    version: number;
+    revisionLevel: number;
+    vendor: number[];
+    size: number;
+};
+type AudioSample = SampleBase & {
+    type: 'audio';
+    numberOfChannels: number;
+    sampleSize: number;
+    compressionId: number;
+    packetSize: number;
+    sampleRate: number;
+    samplesPerPacket: number | null;
+    bytesPerPacket: number | null;
+    bytesPerFrame: number | null;
+    bitsPerSample: number | null;
+};
+type VideoSample = SampleBase & {
+    type: 'video';
+    temporalQuality: number;
+    spacialQuality: number;
+    width: number;
+    height: number;
+    compressorName: number[];
+    horizontalResolutionPpi: number;
+    verticalResolutionPpi: number;
+    dataSize: number;
+    frameCountPerSample: number;
+    depth: number;
+    colorTableId: number;
+};
+type UnknownSample = SampleBase & {
+    type: 'unknown';
+};
+export type Sample = AudioSample | VideoSample | UnknownSample;
+type SampleAndNext = {
+    sample: Sample | null;
+};
+export declare const processSample: ({ iterator, }: {
+    iterator: BufferIterator;
+}) => SampleAndNext;
+export declare const parseSamples: (iterator: BufferIterator, maxBytes: number) => Sample[];
+export {};