Skip to content

Changelog

All three packages (nomercy-player-core, nomercy-video-player, nomercy-music-player) are versioned together. A single version number applies to all three at any given release. Breaking changes to any one package increment the major or pre-release version for all three.

For the migration guide from v1, see Migration Guide: v1 to v2.

2.0.0-beta (active)

The v2 beta line is the current development target. Breaking changes may appear in any beta bump. Pin to an exact beta version in your lockfile if you need stability during development.

Install:

Code
npm install @nomercy-entertainment/nomercy-player-core@beta
npm install @nomercy-entertainment/nomercy-video-player@beta
npm install @nomercy-entertainment/nomercy-music-player@beta

Architecture

  • Ground-up rewrite on a shared core (nomercy-player-core). All generic infrastructure, lifecycle, queue, auth, plugin system, event bus, i18n, and storage, moved into the core package and shared by both library packages.
  • Named adapter ports with typed interfaces and sensible defaults. Replace any port without touching the others.
  • 5-layer model: Backend / Core / Per-library / Built-in plugin / Consumer plugin.

New: Event system

  • All events carry typed payloads via BaseEventMap (shared) + VideoEventMap / MusicEventMap (per-library).
  • Cancellable before* events with preventDefault(), delay(promise), and stopImmediatePropagation().
  • Cross-plugin events via namespaced strings: player.on('plugin:equalizer:band:changed', ...); the class-form this.on(EqualizerPlugin, ...) is available inside plugin bodies only.

New: Plugin system

  • addPlugin(Class, opts) replaces registerPlugin(name, instance).
  • Plugins are tree-shaken, zero cost if you do not register them.
  • static requires, static replaces, static advisories, static onError declarative contracts.
  • this.on, this.timeout, this.interval, this.frame, this.mount: managed resources auto-dispose.
  • describePlugin and assertNoListenerLeak test utilities in /testing subpath.

New: Auth pipeline

  • bearerToken (string or factory), refreshOnUnauthenticated, signRequest, headers.
  • 401/403 separation: 401 triggers one refresh attempt; 403 propagates immediately.
  • auth:refreshed and auth:failed events.

New: Phase machine

  • player.phase() returns one of 13 typed phase strings.
  • player.setupState() returns SetupState enum value.
  • player.dispatching() returns the active event dispatch stack.

New: ABR and capability probing

  • player.bandwidth(): last-known throughput estimate.
  • player.bandwidthEstimator(fn): plug in a custom throughput estimator.
  • player.canPlay(profile): probe MediaCapabilities.decodingInfo() via the platform adapter.

New: Metrics

  • player.metrics(): PlaybackMetrics snapshot: ttfb, ttff, rebufferRatio, avgBitrate, droppedFrames, decoderStalls, joinTime, sessionDurationMs.
  • playback:metrics event on configurable interval (metricsIntervalMs).
  • player.recordMetric(key, value): plugins publish namespaced counters.

New: Preload and transition strategies

  • PreloadStrategy interface with DefaultPreloadStrategy.
  • TransitionStrategy interface with CrossfadeTransitionStrategy and GaplessTransitionStrategy.
  • Configurable via setup({ preloadStrategy, transitionStrategy }).

Changed: Queue API

All queue mutation methods renamed and extended:

v1v2
playlist()queue()
song eventcurrent event
playVideo(idx)seekToIndex(idx)
seek(t)time(t)
speed(v)playbackRate(v)
quality(idx)quality(idx)
subtitle(idx)subtitle(idx)
audioTrack(idx)audioTrack(idx)

New queue operations in v2: queueInsert, queueRemoveAt, queueMove, queueSort, queueShuffle, queueClear, queueLength, queueIndexOf, backlog*.

Changed: Playlist item fields

  • item.path to item.url (music)
  • item.file to item.url (video)
  • item.duration is now number (seconds) instead of a formatted string

Removed: Always-on features

EQ, Spectrum, MediaSession, and auto-advance were always-on in v1. In v2, register them explicitly:

TypeScript
player
  .addPlugin(AudioGraphPlugin)
  .addPlugin(EqualizerPlugin)
  .addPlugin(SpectrumPlugin)
  .addPlugin(MediaSessionPlugin)
  .addPlugin(AutoAdvancePlugin);

Not yet implemented (planned for 2.1)

FeatureStatus
GroupListeningPlugin (music)Stub, throws NotImplementedError
LiveTranscodingPlugin (music)Stub, throws NotImplementedError
DrmPlugin (music)Stub, throws NotImplementedError

1.x (frozen)

v1 packages are frozen. No new features. Critical security fixes only, on a best-effort basis.

  • @nomercy-entertainment/nomercy-video-player@^1.x
  • @nomercy-entertainment/nomercy-music-player@^1.x

Migrate to v2 using the Migration Guide.

See also