@broadcastingplatforms/player 0.0.0-dev.e67afbe → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,148 @@
1
+ /**
2
+ * Player event system with typed events.
3
+ * Inspired by THEOplayer's event architecture.
4
+ */
5
+ /**
6
+ * Base player event interface.
7
+ */
8
+ export interface PlayerEvent<TType extends string = string> {
9
+ /** The type of the event. */
10
+ readonly type: TType;
11
+ /** The creation date of the event. */
12
+ readonly date: Date;
13
+ }
14
+ /**
15
+ * Player event types as const for type safety.
16
+ */
17
+ export declare const PlayerEventType: {
18
+ readonly PLAY: "play";
19
+ readonly PAUSE: "pause";
20
+ readonly PLAYING: "playing";
21
+ readonly WAITING: "waiting";
22
+ readonly ENDED: "ended";
23
+ readonly SEEKING: "seeking";
24
+ readonly SEEKED: "seeked";
25
+ readonly TIME_UPDATE: "timeupdate";
26
+ readonly DURATION_CHANGE: "durationchange";
27
+ readonly LOAD_START: "loadstart";
28
+ readonly LOADED_METADATA: "loadedmetadata";
29
+ readonly LOADED_DATA: "loadeddata";
30
+ readonly CAN_PLAY: "canplay";
31
+ readonly CAN_PLAY_THROUGH: "canplaythrough";
32
+ readonly PROGRESS: "progress";
33
+ readonly EMPTIED: "emptied";
34
+ readonly VOLUME_CHANGE: "volumechange";
35
+ readonly RATE_CHANGE: "ratechange";
36
+ readonly RESIZE: "resize";
37
+ readonly QUALITIES_CHANGE: "qualitieschange";
38
+ readonly QUALITY_CHANGE: "qualitychange";
39
+ readonly TARGET_QUALITY_CHANGED: "targetqualitychanged";
40
+ readonly STATE_CHANGE: "statechange";
41
+ readonly READY: "ready";
42
+ readonly ERROR: "error";
43
+ readonly DESTROY: "destroy";
44
+ };
45
+ export type PlayerEventTypes = typeof PlayerEventType[keyof typeof PlayerEventType];
46
+ export interface PlayEvent extends PlayerEvent<'play'> {
47
+ }
48
+ export interface PauseEvent extends PlayerEvent<'pause'> {
49
+ }
50
+ export interface PlayingEvent extends PlayerEvent<'playing'> {
51
+ }
52
+ export interface WaitingEvent extends PlayerEvent<'waiting'> {
53
+ }
54
+ export interface EndedEvent extends PlayerEvent<'ended'> {
55
+ }
56
+ export interface SeekingEvent extends PlayerEvent<'seeking'> {
57
+ }
58
+ export interface SeekedEvent extends PlayerEvent<'seeked'> {
59
+ }
60
+ export interface TimeUpdateEvent extends PlayerEvent<'timeupdate'> {
61
+ readonly currentTime: number;
62
+ }
63
+ export interface DurationChangeEvent extends PlayerEvent<'durationchange'> {
64
+ readonly duration: number;
65
+ }
66
+ export interface LoadStartEvent extends PlayerEvent<'loadstart'> {
67
+ }
68
+ export interface LoadedMetadataEvent extends PlayerEvent<'loadedmetadata'> {
69
+ }
70
+ export interface LoadedDataEvent extends PlayerEvent<'loadeddata'> {
71
+ }
72
+ export interface CanPlayEvent extends PlayerEvent<'canplay'> {
73
+ }
74
+ export interface CanPlayThroughEvent extends PlayerEvent<'canplaythrough'> {
75
+ }
76
+ export interface ProgressEvent extends PlayerEvent<'progress'> {
77
+ }
78
+ export interface EmptiedEvent extends PlayerEvent<'emptied'> {
79
+ }
80
+ export interface VolumeChangeEvent extends PlayerEvent<'volumechange'> {
81
+ readonly volume: number;
82
+ readonly muted: boolean;
83
+ }
84
+ export interface RateChangeEvent extends PlayerEvent<'ratechange'> {
85
+ readonly playbackRate: number;
86
+ }
87
+ export interface ResizeEvent extends PlayerEvent<'resize'> {
88
+ readonly videoWidth: number;
89
+ readonly videoHeight: number;
90
+ }
91
+ export interface StateChangeEvent extends PlayerEvent<'statechange'> {
92
+ }
93
+ export interface ReadyEvent extends PlayerEvent<'ready'> {
94
+ }
95
+ export interface DestroyEvent extends PlayerEvent<'destroy'> {
96
+ }
97
+ export interface PlayerErrorEvent extends PlayerEvent<'error'> {
98
+ readonly error: Error;
99
+ readonly code?: number;
100
+ readonly message: string;
101
+ }
102
+ /**
103
+ * Maps player event types to their event interfaces.
104
+ */
105
+ export interface PlayerEventMap {
106
+ play: PlayEvent;
107
+ pause: PauseEvent;
108
+ playing: PlayingEvent;
109
+ waiting: WaitingEvent;
110
+ ended: EndedEvent;
111
+ seeking: SeekingEvent;
112
+ seeked: SeekedEvent;
113
+ timeupdate: TimeUpdateEvent;
114
+ durationchange: DurationChangeEvent;
115
+ loadstart: LoadStartEvent;
116
+ loadedmetadata: LoadedMetadataEvent;
117
+ loadeddata: LoadedDataEvent;
118
+ canplay: CanPlayEvent;
119
+ canplaythrough: CanPlayThroughEvent;
120
+ progress: ProgressEvent;
121
+ emptied: EmptiedEvent;
122
+ volumechange: VolumeChangeEvent;
123
+ ratechange: RateChangeEvent;
124
+ resize: ResizeEvent;
125
+ statechange: StateChangeEvent;
126
+ ready: ReadyEvent;
127
+ error: PlayerErrorEvent;
128
+ destroy: DestroyEvent;
129
+ }
130
+ /**
131
+ * Creates a player event with the given type and optional data.
132
+ */
133
+ export declare function createPlayerEvent<TType extends keyof PlayerEventMap>(type: TType, data?: Omit<PlayerEventMap[TType], 'type' | 'date'>): PlayerEventMap[TType];
134
+ /**
135
+ * Creates a DOM CustomEvent that wraps a PlayerEvent.
136
+ * Use this when dispatching events through DOM elements.
137
+ */
138
+ export declare function createCustomEvent<TType extends keyof PlayerEventMap>(type: TType, data?: Omit<PlayerEventMap[TType], 'type' | 'date'>): CustomEvent<PlayerEventMap[TType]>;
139
+ /**
140
+ * Creates a standard DOM Event with bubbles and composed.
141
+ * Use this for simple events that don't need extra data.
142
+ */
143
+ export declare function createEvent(type: string): Event;
144
+ /**
145
+ * Creates a DOM ErrorEvent with proper structure.
146
+ */
147
+ export declare function createErrorEvent(error: Error, code?: number): ErrorEvent;
148
+ //# sourceMappingURL=events.d.ts.map
@@ -1,3 +1,5 @@
1
+ import type { ProviderType } from '../providers/contract';
2
+ export type { ProviderType };
1
3
  export interface PlayerState {
2
4
  readonly paused: boolean;
3
5
  readonly playing: boolean;
@@ -36,7 +38,6 @@ export interface QualityLevel {
36
38
  export type PresentationMode = 'inline' | 'fullscreen' | 'pip';
37
39
  export type ConnectionState = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'disconnected' | 'failed';
38
40
  export type StreamType = 'vod' | 'live' | 'dvr';
39
- export type ProviderType = 'video' | 'nano' | 'livekit';
40
41
  export type ContentType = 'clip' | 'stream' | 'video';
41
42
  export type ErrorCategory = 'offline' | 'network' | 'security' | 'media' | 'autoplay' | 'setup' | 'unknown';
42
43
  export interface PlayerError {
package/dist/index.d.ts CHANGED
@@ -5,7 +5,7 @@ export { BPOverlay, type OverlayType } from './components/bp-overlay';
5
5
  export { addGlobalStyles, createTemplate, templateWithStyles } from './styles/index';
6
6
  export { Attribute, toggleAttribute } from './util/attribute';
7
7
  export { HlsVideoElement, HlsVideo, Hls, NanoVideoElement, NanoVideo, LiveKitVideoElement, LiveKitVideo, } from './elements/index';
8
- export { createPlayerCore, PlayerCoreImpl } from './core/player-core';
8
+ export { createPlayerCore } from './core/player-core';
9
9
  export type { PlayerCore, PlayerCoreEventMap, PlayerCoreEventType, CustomVideoElement } from './core/player-core';
10
10
  export { createInitialState, classifyNanoPlayerError, classifyLiveKitError, NANOPLAYER_NO_REPLAY_CODES } from './core/state';
11
11
  export type { PlayerState, QualityLevel, PresentationMode, ConnectionState, StreamType, ContentType, PlayerError, ErrorCategory, } from './core/state';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@broadcastingplatforms/player",
3
- "version": "0.0.0-dev.e67afbe",
3
+ "version": "1.1.0",
4
4
  "description": "Universal video player web component built with Lit",
5
5
  "type": "module",
6
6
  "main": "dist/bp-player.js",
@@ -9,8 +9,7 @@
9
9
  "exports": {
10
10
  ".": {
11
11
  "types": "./dist/index.d.ts",
12
- "import": "./dist/bp-player.mjs",
13
- "require": "./dist/bp-player.js"
12
+ "import": "./dist/bp-player.mjs"
14
13
  },
15
14
  "./standalone": {
16
15
  "types": "./dist/index.d.ts",
@@ -39,7 +38,7 @@
39
38
  "typescript": "^5.7.2",
40
39
  "vite": "^6.0.5"
41
40
  },
42
- "license": "UNLICENSED",
41
+ "license": "SEE LICENSE IN LICENSE",
43
42
  "publishConfig": {
44
43
  "access": "public"
45
44
  },