@openmoq/playback 0.0.0-stage → 0.6.0

package/dist/sync.js

@@ -0,0 +1,343 @@
+/**
+ * A/V sync controller with injectable clock.
+ *
+ * Audio-master model: the first audio sample establishes a sync reference
+ * mapping CaptureTimestamp (wall-clock microseconds) to local clock time.
+ * Video render times are computed relative to this reference.
+ *
+ * Drift detection: reportPresentationTiming measures VIDEO PRESENTATION SCHEDULE
+ * drift — actual presentation time minus the exact scheduled time carried with
+ * the frame. If it exceeds the adaptive threshold, presentationDriftExceeded
+ * signals and a sync_drift event is emitted — but no automatic re-anchor occurs.
+ * Actual audio/video skew is a separate metric (sync_skew).
+ * The reference is set once to avoid audio glitching from re-anchor jumps.
+ * In practice, gap recovery (skip_forward) and seek/pause naturally re-anchor.
+ *
+ * Live catch-up: measures end-to-end latency by comparing CaptureTimestamp
+ * (publisher wall-clock) to subscriber wall-clock. When latency exceeds
+ * targetLatency + threshold, activates catch-up (playback rate > 1.0).
+ * Hysteresis prevents oscillation near the threshold boundary.
+ *
+ * @see draft-ietf-moq-loc-01 §2.3.1.1 (CaptureTimestamp)
+ * @see draft-ietf-moq-msf-00 §5.1.16 (targetLatency)
+ * @module
+ */
+/** Default: frames more than 500ms late are dropped. */
+const DEFAULT_DROP_THRESHOLD_US = 500_000;
+/** Default wall clock — Date.now() converted to microseconds. */
+const DEFAULT_WALL_CLOCK = { now: () => Date.now() * 1000 };
+// ─── SyncController ─────────────────────────────────────────────────
+/**
+ * A/V sync controller with live catch-up.
+ *
+ * @see draft-ietf-moq-loc-01 §2.3.1.1
+ * @see draft-ietf-moq-msf-00 §5.1.16
+ */
+export class SyncController {
+    _driftThresholdUs;
+    dropThresholdUs;
+    clock;
+    /** Local clock time when audio reference was set. */
+    localBaselineUs;
+    /** CaptureTimestamp of the audio reference sample. */
+    captureBaselineUs;
+    /** Accumulated drift measurement. */
+    _currentDriftUs = 0;
+    /**
+     * Video join offset — shifts video render times forward during live join.
+     *
+     * When joining a live stream, video starts from the GOP boundary
+     * (which has an older CaptureTimestamp than the current audio).
+     * This offset shifts video render times forward so the first frames
+     * render in the future instead of the past, preventing startup stutter.
+     *
+     * Snaps to zero when the video timeline catches up to the audio live edge.
+     * Audio render times are unaffected.
+     */
+    _videoJoinOffsetUs = 0;
+    // ── Catch-up state ─────────────────────────────────────────
+    wallClock;
+    targetLatencyMs;
+    maxCatchUpRate;
+    catchUpThresholdMs;
+    catchUpRecoveryMs;
+    _catchUpActive = false;
+    _currentRate = 1.0;
+    _lastLatencyUs = 0;
+    constructor(config) {
+        this._driftThresholdUs = config.driftThresholdUs;
+        this.dropThresholdUs = config.dropThresholdUs ?? DEFAULT_DROP_THRESHOLD_US;
+        this.clock = config.clock;
+        // Catch-up config
+        this.wallClock = config.wallClock ?? DEFAULT_WALL_CLOCK;
+        this.targetLatencyMs = config.targetLatencyMs;
+        this.maxCatchUpRate = config.maxCatchUpRate ?? 1.0;
+        this.catchUpThresholdMs = config.catchUpThresholdMs ?? 500;
+        this.catchUpRecoveryMs = config.catchUpRecoveryMs ?? 50;
+    }
+    /** Whether a sync reference has been established. */
+    get hasReference() {
+        return this.localBaselineUs !== undefined;
+    }
+    /** Current drift magnitude in microseconds. */
+    get currentDriftUs() {
+        return this._currentDriftUs;
+    }
+    /** Current drift threshold in microseconds. Mutable for adaptive tolerance. */
+    get driftThresholdUs() { return this._driftThresholdUs; }
+    set driftThresholdUs(value) { this._driftThresholdUs = value; }
+    /**
+     * Whether PRESENTATION SCHEDULE drift exceeds the threshold.
+     *
+     * Deliberately has NO live-join suppression. The exact queued schedule
+     * already contains the join offset, so missing that schedule during a join
+     * is a real miss. (The legacy PTS-era metric needed the suppression because
+     * the offset itself showed up as drift; see {@link needsResync}.)
+     */
+    get presentationDriftExceeded() {
+        return Math.abs(this._currentDriftUs) >= this._driftThresholdUs;
+    }
+    /**
+     * @deprecated Threshold check for the legacy {@link reportActualRenderTime}
+     * metric, retaining its live-join suppression. Use
+     * {@link presentationDriftExceeded} with schedule-based measurement.
+     */
+    get needsResync() {
+        // Suppress during video join — under the LEGACY PTS-anchored metric the
+        // offset itself appeared as drift.
+        if (this._videoJoinOffsetUs > 0)
+            return false;
+        return Math.abs(this._currentDriftUs) >= this._driftThresholdUs;
+    }
+    /** Whether catch-up is currently active. */
+    get catchUpActive() {
+        return this._catchUpActive;
+    }
+    /** Current playback rate (1.0 when catch-up inactive). */
+    get currentRate() {
+        return this._currentRate;
+    }
+    /**
+     * Last measured latency in microseconds.
+     * 0 before first measurement.
+     * @see draft-ietf-moq-loc-01 §2.3.1.1
+     */
+    get latencyUs() {
+        return this._lastLatencyUs;
+    }
+    /**
+     * Establish sync reference from an audio sample.
+     * Maps captureTimestamp to the current local clock time.
+     * Resets drift measurement.
+     *
+     * @param captureTimestampUs CaptureTimestamp in microseconds
+     */
+    setAudioReference(captureTimestampUs) {
+        this.localBaselineUs = this.clock.now();
+        this.captureBaselineUs = captureTimestampUs;
+        this._currentDriftUs = 0;
+    }
+    /**
+     * Establish sync reference from a video frame (video-only mode).
+     * No-op if a reference already exists — audio has priority.
+     *
+     * @param captureTimestampUs CaptureTimestamp of the first video frame
+     */
+    setVideoReference(captureTimestampUs) {
+        if (this.hasReference)
+            return;
+        this.localBaselineUs = this.clock.now();
+        this.captureBaselineUs = captureTimestampUs;
+        this._currentDriftUs = 0;
+    }
+    /** Current video join offset in microseconds. 0 = no offset active. */
+    get videoJoinOffsetUs() {
+        return this._videoJoinOffsetUs;
+    }
+    /**
+     * Apply video join re-anchor for live stream join.
+     *
+     * Called when the first video keyframe is decoded after a live join.
+     * Computes an offset that shifts video render times forward so the
+     * first frame renders at `now + cushion` instead of in the past.
+     *
+     * The offset is a constant added to all video render times. It preserves
+     * inter-frame timing (33ms spacing) while shifting the whole timeline.
+     * Snaps to zero when video catches up to the live edge.
+     *
+     * @param firstKeyframeCaptureUs CaptureTimestamp of the first keyframe
+     * @param cushionUs Extra future cushion (default: 16ms ≈ 1 rAF tick)
+     */
+    onVideoJoin(firstKeyframeCaptureUs, cushionUs = 16_000) {
+        if (this.localBaselineUs === undefined || this.captureBaselineUs === undefined)
+            return;
+        const naiveRenderTimeUs = this.localBaselineUs +
+            Number(firstKeyframeCaptureUs - this.captureBaselineUs);
+        const nowUs = this.clock.now();
+        const gapUs = nowUs + cushionUs - naiveRenderTimeUs;
+        if (gapUs > 0) {
+            this._videoJoinOffsetUs = gapUs;
+        }
+    }
+    /**
+     * Compute render timing for a video frame.
+     *
+     * @param captureTimestampUs CaptureTimestamp in microseconds
+     */
+    computeVideoRenderTime(captureTimestampUs) {
+        const timing = this.computeRenderTime(captureTimestampUs);
+        if (timing === null)
+            return null;
+        if (this._videoJoinOffsetUs > 0) {
+            // Apply offset — shift render time forward
+            const adjustedRenderTimeUs = timing.renderTimeUs + this._videoJoinOffsetUs;
+            const nowUs = this.clock.now();
+            // Check if base render time (without offset) is now in the future
+            // → video has caught up to live edge, snap offset to zero
+            if (timing.renderTimeUs > nowUs) {
+                this._videoJoinOffsetUs = 0;
+                return timing; // use unmodified timing from here
+            }
+            const offsetUs = adjustedRenderTimeUs - nowUs;
+            return {
+                renderTimeUs: adjustedRenderTimeUs,
+                offsetUs,
+                shouldDrop: offsetUs < -this.dropThresholdUs,
+            };
+        }
+        return timing;
+    }
+    /**
+     * Compute render timing for an audio sample.
+     *
+     * @param captureTimestampUs CaptureTimestamp in microseconds
+     */
+    computeAudioRenderTime(captureTimestampUs) {
+        return this.computeRenderTime(captureTimestampUs);
+    }
+    /**
+     * Record PRESENTATION SCHEDULE drift: did the renderer present the frame
+     * when it was told to?
+     *
+     * `scheduledUs` must be the EXACT timestamp stored with the rendered frame.
+     * It already accounts for the playout cushion actually applied to that
+     * frame, the live-join offset, decode-output recomputation and late-frame
+     * handling — none of which may be recomputed or subtracted later, because an
+     * adaptive cushion can move between enqueue and presentation.
+     *
+     * The schedule is REQUIRED here. Optionality lives at
+     * `FrameRenderedFeedback`, where the pipeline suppresses the whole
+     * measurement/event transaction cleanly: missing evidence is not drift.
+     *
+     * Actual audio/video skew is measured separately as `sync_skew`.
+     */
+    reportPresentationTiming(scheduledUs, actualUs) {
+        this._currentDriftUs = actualUs - scheduledUs;
+    }
+    /**
+     * @deprecated Compares against the UNCUSHIONED PTS-anchored time, so a
+     * stream presenting exactly on its intended schedule reports the whole
+     * playout cushion as drift. Retained as a compatibility path only; use
+     * {@link reportPresentationTiming}.
+     */
+    reportActualRenderTime(captureTimestampUs, actualLocalUs) {
+        if (this.localBaselineUs === undefined || this.captureBaselineUs === undefined)
+            return;
+        const expectedRenderUs = this.localBaselineUs +
+            Number(captureTimestampUs - this.captureBaselineUs);
+        this._currentDriftUs = actualLocalUs - expectedRenderUs;
+    }
+    // ─── Live Catch-Up ──────────────────────────────────────────────
+    /**
+     * Measure end-to-end latency from a wall-clock timestamp.
+     *
+     * Compares the publisher's wall-clock timestamp to the subscriber's
+     * wall clock, both in Unix epoch microseconds. A media-time timestamp
+     * (LOC-04 with Timescale) has no wall-clock meaning, so latency is
+     * unmeasurable and this returns null.
+     *
+     * @param captureTimestampUs Timestamp in microseconds
+     * @param isWallClock False when the timestamp is media time. Undefined means wall clock.
+     * @returns Latency in microseconds, or null if unmeasurable
+     * @see draft-ietf-moq-loc-01 §2.3.1.1
+     * @see draft-ietf-moq-loc-04 §2.3.1.2
+     */
+    measureLatency(captureTimestampUs, isWallClock) {
+        if (captureTimestampUs === 0n || isWallClock === false)
+            return null;
+        return this.wallClock.now() - Number(captureTimestampUs);
+    }
+    /**
+     * Evaluate catch-up state based on current latency.
+     *
+     * Hysteresis: activates when latency > target + threshold,
+     * deactivates when latency <= target + recovery.
+     *
+     * Rate is proportional to overshoot, quantized to 0.05x increments.
+     *
+     * @param captureTimestampUs CaptureTimestamp in microseconds (Unix epoch)
+     * @returns CatchUpState if evaluated, null if catch-up is disabled or no timestamp
+     * @see draft-ietf-moq-msf-00 §5.1.16 (targetLatency)
+     */
+    evaluateCatchUp(captureTimestampUs, isWallClock) {
+        // Measure latency
+        const latencyUs = this.measureLatency(captureTimestampUs, isWallClock);
+        if (latencyUs === null)
+            return null;
+        this._lastLatencyUs = latencyUs;
+        // Catch-up disabled?
+        if (this.targetLatencyMs === undefined || this.maxCatchUpRate <= 1.0)
+            return null;
+        const latencyMs = latencyUs / 1000;
+        const targetMs = this.targetLatencyMs;
+        // Hysteresis: activate/deactivate
+        if (!this._catchUpActive && latencyMs > targetMs + this.catchUpThresholdMs) {
+            this._catchUpActive = true;
+        }
+        else if (this._catchUpActive && latencyMs <= targetMs + this.catchUpRecoveryMs) {
+            this._catchUpActive = false;
+            this._currentRate = 1.0;
+            return { active: false, currentRate: 1.0, latencyMs, targetMs };
+        }
+        if (this._catchUpActive) {
+            // Proportional rate: scale linearly with overshoot
+            const overshoot = latencyMs - targetMs;
+            const ratio = Math.min(Math.max(overshoot / this.catchUpThresholdMs, 0), 1);
+            const rawRate = 1.0 + (this.maxCatchUpRate - 1.0) * ratio;
+            // Quantize to 0.05x increments
+            const quantized = Math.round(rawRate * 20) / 20;
+            // Clamp to [1.0, maxCatchUpRate]
+            this._currentRate = Math.min(Math.max(quantized, 1.0), this.maxCatchUpRate);
+        }
+        return {
+            active: this._catchUpActive,
+            currentRate: this._currentRate,
+            latencyMs,
+            targetMs,
+        };
+    }
+    /**
+     * Reset the sync reference (e.g., after a skip-forward).
+     */
+    reset() {
+        this.localBaselineUs = undefined;
+        this.captureBaselineUs = undefined;
+        this._currentDriftUs = 0;
+        this._videoJoinOffsetUs = 0;
+        this._catchUpActive = false;
+        this._currentRate = 1.0;
+    }
+    // ─── Internal ───────────────────────────────────────────────────
+    computeRenderTime(captureTimestampUs) {
+        if (this.localBaselineUs === undefined || this.captureBaselineUs === undefined) {
+            return null;
+        }
+        const now = this.clock.now();
+        const renderTimeUs = this.localBaselineUs +
+            Number(captureTimestampUs - this.captureBaselineUs);
+        const offsetUs = renderTimeUs - now;
+        const shouldDrop = offsetUs < -this.dropThresholdUs;
+        return { renderTimeUs, offsetUs, shouldDrop };
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAkBH,wDAAwD;AACxD,MAAM,yBAAyB,GAAG,OAAO,CAAC;AAgB1C,iEAAiE;AACjE,MAAM,kBAAkB,GAAoB,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;AAsB7E,uEAAuE;AAEvE;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACf,iBAAiB,CAAS;IACjB,eAAe,CAAS;IACxB,KAAK,CAAc;IAEpC,qDAAqD;IAC7C,eAAe,CAAqB;IAC5C,sDAAsD;IAC9C,iBAAiB,CAAqB;IAE9C,qCAAqC;IAC7B,eAAe,GAAG,CAAC,CAAC;IAE5B;;;;;;;;;;OAUG;IACK,kBAAkB,GAAG,CAAC,CAAC;IAE/B,8DAA8D;IAC7C,SAAS,CAAkB;IAC3B,eAAe,CAAqB;IACpC,cAAc,CAAS;IACvB,kBAAkB,CAAS;IAC3B,iBAAiB,CAAS;IAEnC,cAAc,GAAG,KAAK,CAAC;IACvB,YAAY,GAAG,GAAG,CAAC;IACnB,cAAc,GAAG,CAAC,CAAC;IAE3B,YAAY,MAA4B;QACpC,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACjD,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,yBAAyB,CAAC;QAC3E,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE1B,kBAAkB;QAClB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,kBAAkB,CAAC;QACxD,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,GAAG,CAAC;QACnD,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,IAAI,GAAG,CAAC;QAC3D,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAC5D,CAAC;IAED,qDAAqD;IACrD,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,eAAe,KAAK,SAAS,CAAC;IAC9C,CAAC;IAED,+CAA+C;IAC/C,IAAI,cAAc;QACd,OAAO,IAAI,CAAC,eAAe,CAAC;IAChC,CAAC;IAED,+EAA+E;IAC/E,IAAI,gBAAgB,KAAa,OAAO,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACjE,IAAI,gBAAgB,CAAC,KAAa,IAAI,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC,CAAC,CAAC;IAEvE;;;;;;;OAOG;IACH,IAAI,yBAAyB;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,iBAAiB,CAAC;IACpE,CAAC;IAED;;;;OAIG;IACH,IAAI,WAAW;QACX,wEAAwE;QACxE,mCAAmC;QACnC,IAAI,IAAI,CAAC,kBAAkB,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,iBAAiB,CAAC;IACpE,CAAC;IAED,4CAA4C;IAC5C,IAAI,aAAa;QACb,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAED,0DAA0D;IAC1D,IAAI,WAAW;QACX,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB,CAAC,kBAA0B;QACxC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACxC,IAAI,CAAC,iBAAiB,GAAG,kBAAkB,CAAC;QAC5C,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,kBAA0B;QACxC,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACxC,IAAI,CAAC,iBAAiB,GAAG,kBAAkB,CAAC;QAC5C,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,uEAAuE;IACvE,IAAI,iBAAiB;QACjB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,sBAA8B,EAAE,YAAoB,MAAM;QAClE,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS;YAAE,OAAO;QAEvF,MAAM,iBAAiB,GAAG,IAAI,CAAC,eAAe;YAC1C,MAAM,CAAC,sBAAsB,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,KAAK,GAAG,SAAS,GAAG,iBAAiB,CAAC;QAEpD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACZ,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;QACpC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,sBAAsB,CAAC,kBAA0B;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;QAC1D,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAEjC,IAAI,IAAI,CAAC,kBAAkB,GAAG,CAAC,EAAE,CAAC;YAC9B,2CAA2C;YAC3C,MAAM,oBAAoB,GAAG,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC;YAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAE/B,kEAAkE;YAClE,0DAA0D;YAC1D,IAAI,MAAM,CAAC,YAAY,GAAG,KAAK,EAAE,CAAC;gBAC9B,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC;gBAC5B,OAAO,MAAM,CAAC,CAAC,kCAAkC;YACrD,CAAC;YAED,MAAM,QAAQ,GAAG,oBAAoB,GAAG,KAAK,CAAC;YAC9C,OAAO;gBACH,YAAY,EAAE,oBAAoB;gBAClC,QAAQ;gBACR,UAAU,EAAE,QAAQ,GAAG,CAAC,IAAI,CAAC,eAAe;aAC/C,CAAC;QACN,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,sBAAsB,CAAC,kBAA0B;QAC7C,OAAO,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,wBAAwB,CAAC,WAAmB,EAAE,QAAgB;QAC1D,IAAI,CAAC,eAAe,GAAG,QAAQ,GAAG,WAAW,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IACH,sBAAsB,CAAC,kBAA0B,EAAE,aAAqB;QACpE,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS;YAAE,OAAO;QAEvF,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe;YACzC,MAAM,CAAC,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAExD,IAAI,CAAC,eAAe,GAAG,aAAa,GAAG,gBAAgB,CAAC;IAC5D,CAAC;IAED,mEAAmE;IAEnE;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,kBAA0B,EAAE,WAAqB;QAC5D,IAAI,kBAAkB,KAAK,EAAE,IAAI,WAAW,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QACpE,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,kBAA0B,EAAE,WAAqB;QAC7D,kBAAkB;QAClB,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;QACvE,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAEpC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAEhC,qBAAqB;QACrB,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,IAAI,IAAI,CAAC,cAAc,IAAI,GAAG;YAAE,OAAO,IAAI,CAAC;QAElF,MAAM,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC;QAEtC,kCAAkC;QAClC,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACzE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC/B,CAAC;aAAM,IAAI,IAAI,CAAC,cAAc,IAAI,SAAS,IAAI,QAAQ,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC/E,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;YAC5B,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QACpE,CAAC;QAED,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,mDAAmD;YACnD,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5E,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;YAC1D,+BAA+B;YAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;YAChD,iCAAiC;YACjC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAChF,CAAC;QAED,OAAO;YACH,MAAM,EAAE,IAAI,CAAC,cAAc;YAC3B,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,SAAS;YACT,QAAQ;SACX,CAAC;IACN,CAAC;IAED;;OAEG;IACH,KAAK;QACD,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACjC,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACnC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;IAC5B,CAAC;IAED,mEAAmE;IAE3D,iBAAiB,CAAC,kBAA0B;QAChD,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YAC7E,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe;YACrC,MAAM,CAAC,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAExD,MAAM,QAAQ,GAAG,YAAY,GAAG,GAAG,CAAC;QACpC,MAAM,UAAU,GAAG,QAAQ,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC;QAEpD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAClD,CAAC;CACJ"}

package/dist/types.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Sans-I/O playback core type definitions.
+ *
+ * These types define the boundary between the playback core (testable in
+ * Node.js) and the browser adapter (WebCodecs, Canvas, AudioContext).
+ *
+ * @see draft-ietf-moq-loc-01 §4 (Application Mapping)
+ * @see draft-ietf-moq-transport-16 §10 (Objects)
+ * @module
+ */
+import type { VideoChunkInit, AudioChunkInit } from '@openmoq/loc';
+import type { RecoveryAction } from './recovery.js';
+/**
+ * Injectable clock source for testability.
+ *
+ * Browser adapter injects `performance.now() * 1000` (microseconds).
+ * Tests inject a manual clock with deterministic time.
+ *
+ * @see draft-ietf-moq-loc-01 §2.3.1.1 (CaptureTimestamp uses microseconds)
+ */
+export interface ClockSource {
+    /** Current time in microseconds (monotonic). */
+    now(): number;
+}
+/**
+ * Commands emitted by the playback core to the browser decoder adapter.
+ * The core never calls WebCodecs directly — it produces these commands.
+ */
+export type DecoderCommand = ConfigureCommand | DecodeVideoCommand | DecodeAudioCommand | FlushCommand | ResetCommand | SetPlaybackRateCommand;
+/** Configure the decoder with codec extradata. @see draft-ietf-moq-loc-01 §2.3.2.1 */
+export interface ConfigureCommand {
+    readonly type: 'configure';
+    readonly mediaType: 'video' | 'audio';
+    readonly config: Uint8Array;
+}
+/** Decode a video chunk at the specified render time. @see draft-ietf-moq-loc-01 §2.1 */
+export interface DecodeVideoCommand {
+    readonly type: 'decode_video';
+    readonly chunk: VideoChunkInit;
+    readonly renderTimeUs: number;
+    /**
+     * CaptureTimestamp in microseconds — for PTS-anchored render scheduling.
+     * The renderer should use this (via RenderScheduler) instead of renderTimeUs
+     * for correct frame pacing after async decode.
+     * @see draft-ietf-moq-loc-01 §2.3.1.1
+     */
+    readonly captureTimestampUs?: bigint;
+}
+/** Decode an audio chunk at the specified render time. @see draft-ietf-moq-loc-01 §2 */
+export interface DecodeAudioCommand {
+    readonly type: 'decode_audio';
+    readonly chunk: AudioChunkInit;
+    readonly renderTimeUs: number;
+}
+/** Flush the decoder (drain pending frames). */
+export interface FlushCommand {
+    readonly type: 'flush';
+    readonly mediaType: 'video' | 'audio';
+}
+/** Reset the decoder (e.g., after a gap). */
+export interface ResetCommand {
+    readonly type: 'reset';
+    readonly mediaType: 'video' | 'audio';
+    readonly reason: string;
+}
+/** Adjust audio playback rate for live catch-up. @see draft-ietf-moq-msf-00 §5.1.16 */
+export interface SetPlaybackRateCommand {
+    readonly type: 'set_playback_rate';
+    readonly rate: number;
+}
+/**
+ * Observability events emitted by the playback core.
+ */
+export type PlaybackEvent = GapDetectedEvent | SkipForwardEvent | SyncDriftEvent | KeyframeWaitingEvent | KeyframeValidationFailedEvent | TrackEndedEvent | RecoveryEvent | CatchUpChangedEvent | BacklogShedEvent | PartialGroupAbandonedEvent;
+/** A partial video GOP was abandoned before END_OF_GROUP was received. */
+export interface PartialGroupAbandonedEvent {
+    readonly type: 'partial_group_abandoned';
+    readonly fromGroupId: bigint;
+    readonly toGroupId: bigint;
+    readonly reason: string;
+}
+/** Old groups were dropped before decode to prevent backlog buildup. */
+export interface BacklogShedEvent {
+    readonly type: 'backlog_shed';
+    readonly droppedGroups: number;
+    readonly remainingGroups: number;
+    readonly reason: string;
+}
+/** A group gap was detected. @see draft-ietf-moq-transport-16 §10.2.1.1 */
+export interface GapDetectedEvent {
+    readonly type: 'gap_detected';
+    readonly groupId: bigint;
+}
+/** Skipped forward past a gap to a new group. */
+export interface SkipForwardEvent {
+    readonly type: 'skip_forward';
+    readonly fromGroupId: bigint;
+    readonly toGroupId: bigint;
+}
+/**
+ * Video PRESENTATION SCHEDULE drift: the renderer presented a frame later (or
+ * earlier) than the exact time it was queued to present. This is NOT audio/video
+ * skew — see `sync_skew` for that.
+ */
+export interface SyncDriftEvent {
+    readonly type: 'sync_drift';
+    readonly driftUs: number;
+}
+/** Waiting for a keyframe after a gap. @see draft-ietf-moq-loc-01 §2.3.2.2 */
+export interface KeyframeWaitingEvent {
+    readonly type: 'keyframe_waiting';
+    readonly groupId: bigint;
+}
+/** Keyframe payload validation failed — bitstream does not start with a keyframe. @see draft-ietf-moq-loc-01 §4.2 */
+export interface KeyframeValidationFailedEvent {
+    readonly type: 'keyframe_validation_failed';
+    readonly groupId: bigint;
+    readonly objectId: bigint;
+    readonly codec: string;
+}
+/** Track has ended (END_OF_TRACK received). @see draft-ietf-moq-transport-16 §10.2.1.1 */
+export interface TrackEndedEvent {
+    readonly type: 'track_ended';
+}
+/** Recovery controller recommends an action (local policy). */
+export interface RecoveryEvent {
+    readonly type: 'recovery';
+    readonly action: RecoveryAction;
+}
+/**
+ * Catch-up state — latency measurement and rate adjustment.
+ *
+ * @see draft-ietf-moq-msf-00 §5.1.16 (targetLatency)
+ * @see draft-ietf-moq-loc-01 §2.3.1.1 (CaptureTimestamp for latency measurement)
+ */
+export interface CatchUpState {
+    /** Whether catch-up is currently active. */
+    readonly active: boolean;
+    /** Current playback rate (1.0 = normal, >1.0 = catching up). */
+    readonly currentRate: number;
+    /** Current end-to-end latency in milliseconds. */
+    readonly latencyMs: number;
+    /** Target latency in milliseconds. */
+    readonly targetMs: number;
+}
+/** Catch-up state changed (activated, rate adjusted, or deactivated). @see draft-ietf-moq-msf-00 §5.1.16 */
+export interface CatchUpChangedEvent {
+    readonly type: 'catch_up_changed';
+    readonly state: CatchUpState;
+}
+/**
+ * Feedback from browser adapters back to the pipeline.
+ *
+ * Flow: adapter → CommandDispatcher → player → pipeline.handleFeedback()
+ *
+ * @see draft-ietf-moq-loc-01 §2.3.1.1 (CaptureTimestamp for drift detection)
+ */
+export type DecoderFeedback = QueuePressureFeedback | DecodeErrorFeedback | FrameRenderedFeedback | FlushCompleteFeedback;
+/** Decoder queue getting deep — signal to throttle draining. */
+export interface QueuePressureFeedback {
+    readonly type: 'queue_pressure';
+    readonly mediaType: 'video' | 'audio';
+    readonly depth: number;
+    readonly maxRecommended: number;
+}
+/** A decode() call failed. */
+export interface DecodeErrorFeedback {
+    readonly type: 'decode_error';
+    readonly mediaType: 'video' | 'audio';
+    readonly message: string;
+}
+/** Actual render time for drift detection — video only. @see draft-ietf-moq-loc-01 §2.3.1.1 */
+export interface FrameRenderedFeedback {
+    readonly type: 'frame_rendered';
+    readonly mediaType: 'video';
+    readonly captureTimestampUs: bigint;
+    readonly actualRenderUs: number;
+    /**
+     * The exact time this frame was scheduled to present. Absent when the
+     * renderer cannot report it, in which case presentation-schedule drift is
+     * suppressed rather than fabricated.
+     */
+    readonly scheduledRenderUs?: number;
+}
+/** Flush completed (forward compatibility — currently a no-op). */
+export interface FlushCompleteFeedback {
+    readonly type: 'flush_complete';
+    readonly mediaType: 'video' | 'audio';
+}
+/**
+ * Playback pipeline configuration.
+ */
+export interface PlaybackConfig {
+    /** Maximum wait time in microseconds for a missing group before skip-forward. */
+    readonly gapTimeoutUs: number;
+    /** Video presentation-schedule drift threshold in microseconds. */
+    readonly driftThresholdUs: number;
+    /** Maximum number of objects in the jitter buffer. */
+    readonly maxBufferDepth: number;
+    /** Target end-to-end latency in milliseconds. @see draft-ietf-moq-msf-00 §5.1.16 */
+    readonly targetLatencyMs?: number;
+    /** Maximum playback rate for catch-up (e.g., 1.1 = 10% faster). Default: 1.0 (disabled). */
+    readonly maxCatchUpRate?: number;
+    /** Latency above target before catch-up activates (ms). Default: 500. */
+    readonly catchUpThresholdMs?: number;
+    /** Latency above target before catch-up deactivates (ms, hysteresis). Default: 50. */
+    readonly catchUpRecoveryMs?: number;
+    /**
+     * Maximum objects to release from the jitter buffer per tick (video only).
+     * Prevents greedy drain from flooding the decoder with backlog.
+     * 0 = unlimited (greedy drain, legacy behavior). Default: 5.
+     */
+    readonly maxReleasePerTick?: number;
+    /**
+     * Maximum groups allowed in the jitter buffer before shedding old ones.
+     * When exceeded, oldest groups are dropped before decode.
+     * 0 = unlimited (no shedding). Default: 3.
+     */
+    readonly maxBacklogGroups?: number;
+    /** Enable adaptive jitter tolerance. Auto-calibrates gap timeout and drift threshold. */
+    readonly adaptiveTolerance?: boolean;
+    /**
+     * QUIC handshake RTT in milliseconds. Used to classify network conditions
+     * and determine startup buffer depth. If not provided, defaults to
+     * conservative WAN parameters (8 frames / 300ms).
+     */
+    readonly handshakeRttMs?: 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,12 @@
+/**
+ * Sans-I/O playback core type definitions.
+ *
+ * These types define the boundary between the playback core (testable in
+ * Node.js) and the browser adapter (WebCodecs, Canvas, AudioContext).
+ *
+ * @see draft-ietf-moq-loc-01 §4 (Application Mapping)
+ * @see draft-ietf-moq-transport-16 §10 (Objects)
+ * @module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@openmoq/playback",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.6.0",
+  "description": "Sans-I/O media playback core for Media over QUIC (MoQ): jitter buffer, A/V sync, gap detection, decoder state machine, and pipeline orchestration.",
+  "license": "Apache-2.0",
+  "author": "OpenMOQ (https://github.com/openmoq)",
+  "contributors": [
+    "Raymond Lucke <ray@raylucke.com>"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./browser": {
+      "import": "./dist/browser/index.js",
+      "default": "./dist/browser/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "moq",
+    "media-over-quic",
+    "moqt",
+    "quic",
+    "streaming",
+    "low-latency",
+    "live-video",
+    "playback",
+    "sans-io",
+    "jitter-buffer",
+    "av-sync"
+  ],
+  "homepage": "https://github.com/openmoq/moq-playa/tree/main/packages/playback#readme",
+  "bugs": {
+    "url": "https://github.com/openmoq/moq-playa/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/openmoq/moq-playa.git",
+    "directory": "packages/playback"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@openmoq/transport": "0.6.0",
+    "@openmoq/loc": "0.6.0"
+  },
+  "scripts": {
+    "build": "tsc && tsup",
+    "build:browser": "tsup"
+  }
 }