@aelionsdk/media 0.1.0-beta.1

package/dist/resource-governor.js

@@ -0,0 +1,149 @@
+import { throwIfAborted } from '@aelionsdk/core';
+const PRIORITY = {
+    export: 0,
+    preview: 1,
+    background: 2,
+};
+function validateBudget(value, allowZero) {
+    for (const [name, amount] of [
+        ['decoderSlots', value.decoderSlots],
+        ['gpuBytes', value.gpuBytes],
+        ['cacheBytes', value.cacheBytes],
+    ]) {
+        if (!Number.isSafeInteger(amount) || amount < 0 || (!allowZero && amount === 0)) {
+            throw new RangeError(`MEDIA_RESOURCE_BUDGET_INVALID: ${name}`);
+        }
+    }
+}
+/** Shared page-level admission controller for decoder, GPU and cache allocations. */
+export class PageMediaResourceGovernor {
+    #budget;
+    #used = { decoderSlots: 0, gpuBytes: 0, cacheBytes: 0 };
+    #leases = new Set();
+    #pending = [];
+    #maxPending;
+    #sequence = 0;
+    #disposed = false;
+    constructor(budget, maxPending = 128) {
+        validateBudget(budget, false);
+        if (!Number.isSafeInteger(maxPending) || maxPending <= 0) {
+            throw new RangeError('MEDIA_RESOURCE_PENDING_LIMIT_INVALID');
+        }
+        this.#budget = { ...budget };
+        this.#maxPending = maxPending;
+    }
+    get disposed() {
+        return this.#disposed;
+    }
+    snapshot() {
+        return {
+            budget: { ...this.#budget },
+            used: { ...this.#used },
+            activeLeases: this.#leases.size,
+            pendingRequests: this.#pending.length,
+            disposed: this.#disposed,
+        };
+    }
+    acquire(request, signal) {
+        if (this.#disposed)
+            return Promise.reject(new ReferenceError('Media resource governor is disposed'));
+        validateBudget(request, true);
+        if (request.ownerId.length === 0)
+            return Promise.reject(new TypeError('MEDIA_RESOURCE_OWNER_INVALID'));
+        if (request.decoderSlots > this.#budget.decoderSlots ||
+            request.gpuBytes > this.#budget.gpuBytes ||
+            request.cacheBytes > this.#budget.cacheBytes) {
+            return Promise.reject(new RangeError('MEDIA_RESOURCE_REQUEST_EXCEEDS_PAGE_BUDGET'));
+        }
+        try {
+            throwIfAborted(signal, 'Media resource admission');
+        }
+        catch (error) {
+            return Promise.reject(error instanceof Error ? error : new Error('Media admission failed'));
+        }
+        if (this.#pending.length === 0 && this.#fits(request)) {
+            return Promise.resolve(this.#grant(request));
+        }
+        if (this.#pending.length >= this.#maxPending) {
+            return Promise.reject(new RangeError('MEDIA_RESOURCE_QUEUE_FULL'));
+        }
+        return new Promise((resolve, reject) => {
+            const sequence = ++this.#sequence;
+            const onAbort = () => {
+                const index = this.#pending.findIndex(value => value.sequence === sequence);
+                if (index < 0)
+                    return;
+                this.#pending.splice(index, 1);
+                reject(new DOMException('Media resource admission aborted', 'AbortError'));
+            };
+            this.#pending.push({ sequence, request, resolve, reject, signal, onAbort });
+            this.#sortPending();
+            signal?.addEventListener('abort', onAbort, { once: true });
+            this.#drain();
+        });
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        for (const pending of this.#pending.splice(0)) {
+            pending.signal?.removeEventListener('abort', pending.onAbort);
+            pending.reject(new ReferenceError('Media resource governor was disposed'));
+        }
+        for (const lease of [...this.#leases])
+            void lease.dispose();
+    }
+    #fits(request) {
+        return (this.#used.decoderSlots + request.decoderSlots <= this.#budget.decoderSlots &&
+            this.#used.gpuBytes + request.gpuBytes <= this.#budget.gpuBytes &&
+            this.#used.cacheBytes + request.cacheBytes <= this.#budget.cacheBytes);
+    }
+    #grant(request) {
+        this.#used.decoderSlots += request.decoderSlots;
+        this.#used.gpuBytes += request.gpuBytes;
+        this.#used.cacheBytes += request.cacheBytes;
+        let disposed = false;
+        const lease = {
+            ownerId: request.ownerId,
+            allocation: {
+                decoderSlots: request.decoderSlots,
+                gpuBytes: request.gpuBytes,
+                cacheBytes: request.cacheBytes,
+            },
+            get disposed() {
+                return disposed;
+            },
+            dispose: () => {
+                if (disposed)
+                    return;
+                disposed = true;
+                this.#leases.delete(lease);
+                this.#used.decoderSlots -= request.decoderSlots;
+                this.#used.gpuBytes -= request.gpuBytes;
+                this.#used.cacheBytes -= request.cacheBytes;
+                this.#drain();
+            },
+        };
+        this.#leases.add(lease);
+        return lease;
+    }
+    #sortPending() {
+        this.#pending.sort((left, right) => PRIORITY[left.request.priority] - PRIORITY[right.request.priority] ||
+            left.sequence - right.sequence);
+    }
+    #drain() {
+        if (this.#disposed)
+            return;
+        for (;;) {
+            const index = this.#pending.findIndex(value => this.#fits(value.request));
+            if (index < 0)
+                break;
+            const pending = this.#pending[index];
+            if (pending === undefined)
+                break;
+            this.#pending.splice(index, 1);
+            pending.signal?.removeEventListener('abort', pending.onAbort);
+            pending.resolve(this.#grant(pending.request));
+        }
+    }
+}

package/dist/seek.d.ts

@@ -0,0 +1,3 @@
+import type { SampleIndex, SeekPoint } from './types.js';
+export declare function resolveVideoSeek(index: SampleIndex, trackId: number, targetUs: number): SeekPoint;
+//# sourceMappingURL=seek.d.ts.map

package/dist/seek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seek.d.ts","sourceRoot":"","sources":["../src/seek.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAe,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAsBtE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAqCjG"}

package/dist/seek.js

@@ -0,0 +1,55 @@
+import { assertTimeUs } from '@aelionsdk/core';
+function upperBound(samples, presentationOrder, targetUs) {
+    let low = 0;
+    let high = samples.length;
+    while (low < high) {
+        const middle = low + Math.floor((high - low) / 2);
+        const sampleIndex = presentationOrder[middle];
+        const timestamp = sampleIndex === undefined
+            ? Number.POSITIVE_INFINITY
+            : (samples[sampleIndex]?.presentationTimestampUs ?? Number.POSITIVE_INFINITY);
+        if (timestamp <= targetUs)
+            low = middle + 1;
+        else
+            high = middle;
+    }
+    return low;
+}
+export function resolveVideoSeek(index, trackId, targetUs) {
+    assertTimeUs(targetUs, 'targetUs');
+    const samples = index.samples[trackId];
+    const presentationOrder = index.presentationOrder[trackId];
+    if (samples === undefined || samples.length === 0) {
+        throw new RangeError(`Track ${trackId} has no indexed samples`);
+    }
+    const track = index.tracks.find(candidate => candidate.id === trackId);
+    if (track?.kind !== 'video') {
+        throw new TypeError(`Track ${trackId} is not a video track`);
+    }
+    if (presentationOrder === undefined || presentationOrder.length !== samples.length) {
+        throw new RangeError(`Track ${trackId} has an invalid presentation-order index`);
+    }
+    const insertion = upperBound(samples, presentationOrder, targetUs);
+    const presentationPosition = Math.max(0, Math.min(presentationOrder.length - 1, insertion - 1));
+    const presentationSample = presentationOrder[presentationPosition];
+    if (presentationSample === undefined) {
+        throw new RangeError('Seek resolution produced an invalid presentation sample');
+    }
+    let decodeStartSample = presentationSample;
+    while (decodeStartSample > 0 && !samples[decodeStartSample]?.isSync)
+        decodeStartSample -= 1;
+    const decodeStart = samples[decodeStartSample];
+    const presentation = samples[presentationSample];
+    if (decodeStart === undefined || presentation === undefined) {
+        throw new RangeError('Seek resolution produced an invalid sample index');
+    }
+    return {
+        trackId,
+        targetUs,
+        decodeStartSample,
+        presentationSample,
+        decodeStartUs: decodeStart.presentationTimestampUs,
+        presentationUs: presentation.presentationTimestampUs,
+        samplesToDecode: presentationSample - decodeStartSample + 1,
+    };
+}

package/dist/types.d.ts

@@ -0,0 +1,93 @@
+import type { Diagnostic, Rational } from '@aelionsdk/core';
+export type TrackKind = 'video' | 'audio';
+export interface ByteRange {
+    readonly offset: number;
+    readonly length: number;
+}
+export interface RangeRead {
+    readonly bytes: Uint8Array;
+    readonly range: ByteRange;
+    readonly totalSize: number;
+    readonly source: 'memory' | 'blob' | 'network';
+}
+export interface RangeReader {
+    readonly id: string;
+    readonly kind: 'memory' | 'blob' | 'network';
+    size(signal?: AbortSignal): Promise<number>;
+    read(range: ByteRange, signal?: AbortSignal): Promise<RangeRead>;
+}
+export interface SampleEntry {
+    readonly trackId: number;
+    readonly sampleIndex: number;
+    readonly kind: TrackKind;
+    readonly decodeOrder: number;
+    readonly presentationOrder: number;
+    readonly sourceSequenceNumber: number;
+    /** Presentation timestamp (PTS) on the source timeline. */
+    readonly presentationTimestampUs: number;
+    readonly durationUs: number;
+    /** Zero-origin monotonic decode timeline; not the raw container DTS. */
+    readonly normalizedDecodeTimeUs: number;
+    readonly isSync: boolean;
+    readonly byteOffset?: number;
+    readonly byteLength?: number;
+}
+export interface VideoTrackInfo {
+    readonly kind: 'video';
+    readonly id: number;
+    readonly codec: string;
+    readonly codecFamily: string;
+    readonly codedWidth: number;
+    readonly codedHeight: number;
+    readonly rotation: number;
+    readonly timeBase?: Rational;
+    readonly description?: Uint8Array;
+}
+export interface AudioTrackInfo {
+    readonly kind: 'audio';
+    readonly id: number;
+    readonly codec: string;
+    readonly codecFamily: string;
+    readonly sampleRate: number;
+    readonly channelCount: number;
+    readonly timeBase?: Rational;
+    readonly description?: Uint8Array;
+}
+export type TrackInfo = VideoTrackInfo | AudioTrackInfo;
+export interface SampleIndex {
+    readonly schemaVersion: '1.0.0';
+    readonly container: 'mp4' | 'webm' | 'unknown';
+    readonly durationUs: number;
+    readonly tracks: readonly TrackInfo[];
+    readonly capabilities: {
+        /** PTS, duration, sync state, encoded size and decode order are exact. */
+        readonly timingAndSize: true;
+        /** Raw container DTS is adapter-dependent and is not exposed by Mediabunny 1.50.8. */
+        readonly rawDecodeTimestamps: boolean;
+        /** Physical sample offsets are adapter-dependent and are not exposed by Mediabunny 1.50.8. */
+        readonly byteOffsets: boolean;
+    };
+    /** Samples are stored in decode order for each track. */
+    readonly samples: Readonly<Record<number, readonly SampleEntry[]>>;
+    /** Decode-order sample indexes sorted into presentation order for exact lookup. */
+    readonly presentationOrder: Readonly<Record<number, readonly number[]>>;
+    readonly diagnostics: readonly Diagnostic[];
+}
+export interface SeekPoint {
+    readonly trackId: number;
+    readonly targetUs: number;
+    readonly decodeStartSample: number;
+    readonly presentationSample: number;
+    readonly decodeStartUs: number;
+    readonly presentationUs: number;
+    readonly samplesToDecode: number;
+}
+export interface MediaProbeOptions {
+    readonly signal?: AbortSignal;
+    readonly includeSamples?: boolean;
+}
+export interface VideoDecoderResourceSnapshot {
+    readonly activeDecoders: number;
+    readonly retainedFrames: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@aelionsdk/media",
+  "version": "0.1.0-beta.1",
+  "description": "Range I/O, media indexing, decoding and exact seek for AelionSDK",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FoyonaCZY/AelionSDK.git",
+    "directory": "packages/media"
+  },
+  "keywords": [
+    "aelion",
+    "video",
+    "webcodecs",
+    "seek"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/.tsbuildinfo"
+  ],
+  "engines": {
+    "node": ">=20.19"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@aelionsdk/core": "0.1.0-beta.1",
+    "mediabunny": "1.50.8"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b --pretty false"
+  }
+}