Changelog

All notable changes to the Dolby Ads SDK. Follows semver and Keep a Changelog.

v0.2.0 2026-06-08 Latest
Added
  • dolby-stage layout engine — SDK now manages a pixel-accurate 16:9 inner stage via ResizeObserver, ensuring correct aspect ratio for L-Shape and Double-Box formats in fullscreen, split-screen, and any container resize scenario.
  • THEOplayer adapter (@dolby-ads/adapter-theoplayer) — full PlayerAdapter implementation for THEOplayer ChromelessPlayer including programDateTime support.
  • GAM pod URL builder — constructs Google Ad Manager DAI pod manifest URLs with stream ID and pod duration parameters.
  • Shaka Player adapter (@dolby-ads/adapter-shaka).
  • Branch-first git workflow — mandatory feature branches and plan files before any implementation (see AGENTS.md).
  • Changelog page in demo sidebar with version display.
Fixed
  • THEOplayer ad playback deadlock — load() was waiting for loadedmetadata which THEOplayer only fires after play(), creating a circular dependency. load() now sets source and resolves immediately; play() triggers the manifest fetch.
  • Ad break toast repositioned to a subtle top-left indicator with reduced opacity and condensed text (countdown seconds only).
Changed
  • THEOplayerAdapter.load() now sets type: 'application/x-mpegurl' explicitly so THEOplayer recognises HLS regardless of URL shape (e.g. GAM pod URLs with query strings).
v0.1.0 2026-05-01 Initial release
Added
  • Initial project setup with monorepo structure.
  • @dolby-ads/core package with PlayerAdapter interface.
  • @dolby-ads/adapter-hlsjs package for HLS.js integration.
  • Break manifest polling and parsing.
  • Static HLS ad insertion (MVP Phase 1).