@codenkay/video-nsgplayer-react 0.1.0 → 1.0.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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,27 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.0.0
4
+
5
+ ### Major Changes
6
+
7
+ - Fix minor errors
8
+
9
+ ### Minor Changes
10
+
11
+ - 1a4dc9b: Initial public SDK packages: core createVideoPlayer API with dual auth/playback lifecycles, React and Angular adapters, full PlayerConfig parity with demo settings.
12
+
13
+ ### Patch Changes
14
+
15
+ - Updated dependencies
16
+ - Updated dependencies [1a4dc9b]
17
+ - @codenkay/video-nsgplayer-core@1.0.0
18
+
19
+ ## 0.1.8
20
+
21
+ - `useVideoPlayer` / `VideoPlayer` use `useLayoutEffect` so the `<video>` node is ready before player bootstrap.
22
+ - Align React peer/dev tooling with React 18+ (avoid dual-React when linked via `file:` into Next apps).
23
+ - Document host webpack alias requirement for local `file:` installs (see README).
24
+
3
25
  ## 0.1.0
4
26
 
5
- - Initial release
27
+ - Initial React adapter (`VideoPlayer`, `useVideoPlayer`).
package/README.md CHANGED
@@ -22,3 +22,30 @@ import { VideoPlayer } from "@codenkay/video-nsgplayer-react";
22
22
  ```
23
23
 
24
24
  Works in Next.js App Router as a Client Component (`"use client"`).
25
+
26
+ ## Local `file:` installs (Next.js / webpack)
27
+
28
+ When linking this package with `"@codenkay/video-nsgplayer-react": "file:../nsg-player/packages/react"`, webpack resolves `react` from the **monorepo** `node_modules` (via the symlink realpath). That can load a second React copy and crash with:
29
+
30
+ `TypeError: can't access property "useState", resolveDispatcher() is null`
31
+
32
+ Force a single React in the host app `next.config.js`:
33
+
34
+ ```js
35
+ const path = require("path");
36
+
37
+ webpack: (config) => {
38
+ const reactDir = path.dirname(require.resolve("react/package.json"));
39
+ const reactDomDir = path.dirname(require.resolve("react-dom/package.json"));
40
+ config.resolve.alias = {
41
+ ...(config.resolve.alias || {}),
42
+ react: reactDir,
43
+ "react-dom": reactDomDir,
44
+ "react/jsx-runtime": require.resolve("react/jsx-runtime"),
45
+ "react/jsx-dev-runtime": require.resolve("react/jsx-dev-runtime"),
46
+ };
47
+ return config;
48
+ };
49
+ ```
50
+
51
+ Published npm installs do not need this alias (peers resolve from the host app only).
package/dist/index.cjs CHANGED
@@ -40,7 +40,7 @@ var VideoPlayer = (0, import_react.forwardRef)(
40
40
  () => (0, import_video_nsgplayer_core.mergePlayerConfig)(props.config)
41
41
  );
42
42
  (0, import_react.useImperativeHandle)(ref, () => playerRef.current, [state]);
43
- (0, import_react.useEffect)(() => {
43
+ (0, import_react.useLayoutEffect)(() => {
44
44
  const el = videoRef.current;
45
45
  if (!el) return;
46
46
  const generation = ++generationRef.current;
@@ -137,7 +137,7 @@ function useVideoPlayer(options) {
137
137
  const [state, setState] = (0, import_react.useState)("idle");
138
138
  const [error, setError] = (0, import_react.useState)(null);
139
139
  const videoRef = (0, import_react.useRef)(null);
140
- (0, import_react.useEffect)(() => {
140
+ (0, import_react.useLayoutEffect)(() => {
141
141
  const el = videoRef.current;
142
142
  if (!el) return;
143
143
  const config = (0, import_video_nsgplayer_core.mergePlayerConfig)(options.config);
@@ -157,6 +157,7 @@ function useVideoPlayer(options) {
157
157
  accessibility: config.accessibility
158
158
  });
159
159
  setPlayer(instance);
160
+ setError(null);
160
161
  const offs = [
161
162
  instance.on("statechange", ({ state: s }) => setState(s)),
162
163
  instance.on("error", (err) => setError(err)),
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/VideoPlayer.tsx"],"sourcesContent":["export {\n VideoPlayer,\n useVideoPlayer,\n type VideoPlayerProps,\n type VideoPlayerHandle,\n type UseVideoPlayerOptions,\n} from \"./VideoPlayer\";\n","\"use client\";\n\nimport {\n createVideoPlayer,\n mergePlayerConfig,\n themeToCssVars,\n type AuthConfig,\n type CreateVideoPlayerOptions,\n type PlaybackCredentialConfig,\n type PlayerConfig,\n type PlayerState,\n type VideoPlayer as CorePlayer,\n} from \"@codenkay/video-nsgplayer-core\";\nimport {\n useEffect,\n useImperativeHandle,\n useRef,\n useState,\n forwardRef,\n type CSSProperties,\n type ReactNode,\n} from \"react\";\n\nexport type VideoPlayerHandle = CorePlayer;\n\nexport type VideoPlayerProps = {\n videoId?: string;\n auth?: AuthConfig;\n playback?: PlaybackCredentialConfig;\n sourceUrl?: string;\n config?: Parameters<typeof mergePlayerConfig>[0];\n className?: string;\n style?: CSSProperties;\n children?: ReactNode;\n onReady?: () => void;\n onError?: (error: { code: string; message: string; fatal: boolean }) => void;\n onPlay?: () => void;\n onPause?: () => void;\n onAuthError?: (error: { message: string; retryable: boolean }) => void;\n};\n\nexport const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(\n function VideoPlayer(props, ref) {\n const videoRef = useRef<HTMLVideoElement | null>(null);\n const containerRef = useRef<HTMLDivElement | null>(null);\n const playerRef = useRef<CorePlayer | null>(null);\n const generationRef = useRef(0);\n const [state, setState] = useState<PlayerState>(\"idle\");\n const [resolvedConfig, setResolvedConfig] = useState<PlayerConfig>(() =>\n mergePlayerConfig(props.config),\n );\n\n useImperativeHandle(ref, () => playerRef.current as CorePlayer, [state]);\n\n useEffect(() => {\n const el = videoRef.current;\n if (!el) return;\n\n const generation = ++generationRef.current;\n const nextConfig = mergePlayerConfig(props.config);\n setResolvedConfig(nextConfig);\n\n const options: CreateVideoPlayerOptions = {\n videoId: props.videoId,\n mount: el,\n auth: props.auth,\n playback: props.playback,\n sourceUrl: props.sourceUrl,\n player: nextConfig.player,\n controls: nextConfig.controls,\n theme: nextConfig.theme,\n watermark: nextConfig.watermark,\n streaming: nextConfig.streaming,\n logging: nextConfig.logging,\n debug: nextConfig.debug,\n accessibility: nextConfig.accessibility,\n };\n\n const player = createVideoPlayer(options);\n playerRef.current = player;\n\n const unsubs = [\n player.on(\"statechange\", ({ state: s }) => {\n if (generation !== generationRef.current) return;\n setState(s);\n }),\n player.on(\"ready\", () => props.onReady?.()),\n player.on(\"error\", (err) => props.onError?.(err)),\n player.on(\"play\", () => props.onPlay?.()),\n player.on(\"pause\", () => props.onPause?.()),\n player.on(\"autherror\", (err) => props.onAuthError?.(err)),\n ];\n\n return () => {\n for (const off of unsubs) off();\n player.destroy();\n if (playerRef.current === player) playerRef.current = null;\n };\n // Recreate when identity of source/auth changes\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [props.videoId, props.sourceUrl]);\n\n useEffect(() => {\n const next = mergePlayerConfig(props.config);\n setResolvedConfig(next);\n playerRef.current?.updateConfig(props.config);\n }, [props.config]);\n\n const cssVars = themeToCssVars(resolvedConfig.theme) as CSSProperties;\n const headless = !resolvedConfig.controls.enabled;\n\n return (\n <div\n ref={containerRef}\n data-player-theme\n data-player-state={state}\n className={props.className}\n style={{\n position: \"relative\",\n width: \"100%\",\n background: \"#000\",\n ...cssVars,\n ...props.style,\n }}\n >\n <video\n ref={videoRef}\n playsInline\n style={{ width: \"100%\", height: \"100%\", display: \"block\" }}\n />\n {!headless && props.children}\n {!headless &&\n resolvedConfig.watermark.enabled &&\n resolvedConfig.watermark.text && (\n <div\n aria-hidden\n style={{\n position: \"absolute\",\n top: \"12%\",\n left: \"8%\",\n color: \"rgba(255,255,255,0.55)\",\n fontSize: 12,\n pointerEvents: \"none\",\n userSelect: \"none\",\n }}\n >\n {resolvedConfig.watermark.text}\n </div>\n )}\n </div>\n );\n },\n);\n\nexport type UseVideoPlayerOptions = Omit<VideoPlayerProps, \"className\" | \"style\" | \"children\">;\n\nexport function useVideoPlayer(options: UseVideoPlayerOptions) {\n const [player, setPlayer] = useState<CorePlayer | null>(null);\n const [state, setState] = useState<PlayerState>(\"idle\");\n const [error, setError] = useState<{\n code: string;\n message: string;\n } | null>(null);\n const videoRef = useRef<HTMLVideoElement | null>(null);\n\n useEffect(() => {\n const el = videoRef.current;\n if (!el) return;\n const config = mergePlayerConfig(options.config);\n const instance = createVideoPlayer({\n videoId: options.videoId,\n mount: el,\n auth: options.auth,\n playback: options.playback,\n sourceUrl: options.sourceUrl,\n player: config.player,\n controls: config.controls,\n theme: config.theme,\n watermark: config.watermark,\n streaming: config.streaming,\n logging: config.logging,\n debug: config.debug,\n accessibility: config.accessibility,\n });\n setPlayer(instance);\n const offs = [\n instance.on(\"statechange\", ({ state: s }) => setState(s)),\n instance.on(\"error\", (err) => setError(err)),\n instance.on(\"ready\", () => options.onReady?.()),\n ];\n return () => {\n for (const off of offs) off();\n instance.destroy();\n setPlayer(null);\n };\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [options.videoId, options.sourceUrl]);\n\n return {\n videoRef,\n player,\n state,\n error,\n play: () => player?.play(),\n pause: () => player?.pause(),\n seek: (t: number) => player?.seek(t),\n goToLive: () => player?.goToLive(),\n isLive: () => player?.isLive() ?? false,\n isAtLiveEdge: () => player?.isAtLiveEdge() ?? true,\n destroy: () => player?.destroy(),\n };\n}\n"],"mappings":"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","names":["VideoPlayer"]}
1
+ {"version":3,"sources":["../src/index.ts","../src/VideoPlayer.tsx"],"sourcesContent":["export {\n VideoPlayer,\n useVideoPlayer,\n type VideoPlayerProps,\n type VideoPlayerHandle,\n type UseVideoPlayerOptions,\n} from \"./VideoPlayer\";\n","\"use client\";\n\nimport {\n createVideoPlayer,\n mergePlayerConfig,\n themeToCssVars,\n type AuthConfig,\n type CreateVideoPlayerOptions,\n type PlaybackCredentialConfig,\n type PlayerConfig,\n type PlayerState,\n type VideoPlayer as CorePlayer,\n} from \"@codenkay/video-nsgplayer-core\";\nimport {\n useEffect,\n useImperativeHandle,\n useLayoutEffect,\n useRef,\n useState,\n forwardRef,\n type CSSProperties,\n type ReactNode,\n type RefObject,\n} from \"react\";\n\nexport type VideoPlayerHandle = CorePlayer;\n\nexport type VideoPlayerProps = {\n videoId?: string;\n auth?: AuthConfig;\n playback?: PlaybackCredentialConfig;\n sourceUrl?: string;\n config?: Parameters<typeof mergePlayerConfig>[0];\n className?: string;\n style?: CSSProperties;\n children?: ReactNode;\n onReady?: () => void;\n onError?: (error: { code: string; message: string; fatal: boolean }) => void;\n onPlay?: () => void;\n onPause?: () => void;\n onAuthError?: (error: { message: string; retryable: boolean }) => void;\n};\n\nexport const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(\n function VideoPlayer(props, ref) {\n const videoRef = useRef<HTMLVideoElement | null>(null);\n const containerRef = useRef<HTMLDivElement | null>(null);\n const playerRef = useRef<CorePlayer | null>(null);\n const generationRef = useRef(0);\n const [state, setState] = useState<PlayerState>(\"idle\");\n const [resolvedConfig, setResolvedConfig] = useState<PlayerConfig>(() =>\n mergePlayerConfig(props.config),\n );\n\n useImperativeHandle(ref, () => playerRef.current as CorePlayer, [state]);\n\n useLayoutEffect(() => {\n const el = videoRef.current;\n if (!el) return;\n\n const generation = ++generationRef.current;\n const nextConfig = mergePlayerConfig(props.config);\n setResolvedConfig(nextConfig);\n\n const options: CreateVideoPlayerOptions = {\n videoId: props.videoId,\n mount: el,\n auth: props.auth,\n playback: props.playback,\n sourceUrl: props.sourceUrl,\n player: nextConfig.player,\n controls: nextConfig.controls,\n theme: nextConfig.theme,\n watermark: nextConfig.watermark,\n streaming: nextConfig.streaming,\n logging: nextConfig.logging,\n debug: nextConfig.debug,\n accessibility: nextConfig.accessibility,\n };\n\n const player = createVideoPlayer(options);\n playerRef.current = player;\n\n const unsubs = [\n player.on(\"statechange\", ({ state: s }) => {\n if (generation !== generationRef.current) return;\n setState(s);\n }),\n player.on(\"ready\", () => props.onReady?.()),\n player.on(\"error\", (err) => props.onError?.(err)),\n player.on(\"play\", () => props.onPlay?.()),\n player.on(\"pause\", () => props.onPause?.()),\n player.on(\"autherror\", (err) => props.onAuthError?.(err)),\n ];\n\n return () => {\n for (const off of unsubs) off();\n player.destroy();\n if (playerRef.current === player) playerRef.current = null;\n };\n // Recreate when identity of source/auth changes\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [props.videoId, props.sourceUrl]);\n\n useEffect(() => {\n const next = mergePlayerConfig(props.config);\n setResolvedConfig(next);\n playerRef.current?.updateConfig(props.config);\n }, [props.config]);\n\n const cssVars = themeToCssVars(resolvedConfig.theme) as CSSProperties;\n const headless = !resolvedConfig.controls.enabled;\n\n return (\n <div\n ref={containerRef}\n data-player-theme\n data-player-state={state}\n className={props.className}\n style={{\n position: \"relative\",\n width: \"100%\",\n background: \"#000\",\n ...cssVars,\n ...props.style,\n }}\n >\n <video\n ref={videoRef}\n playsInline\n style={{ width: \"100%\", height: \"100%\", display: \"block\" }}\n />\n {!headless && props.children}\n {!headless &&\n resolvedConfig.watermark.enabled &&\n resolvedConfig.watermark.text && (\n <div\n aria-hidden\n style={{\n position: \"absolute\",\n top: \"12%\",\n left: \"8%\",\n color: \"rgba(255,255,255,0.55)\",\n fontSize: 12,\n pointerEvents: \"none\",\n userSelect: \"none\",\n }}\n >\n {resolvedConfig.watermark.text}\n </div>\n )}\n </div>\n );\n },\n);\n\nexport type UseVideoPlayerOptions = Omit<\n VideoPlayerProps,\n \"className\" | \"style\" | \"children\"\n>;\n\n/**\n * Headless hook: bind a `<video ref={videoRef} />` in the host app.\n * Uses `useLayoutEffect` so the DOM node is ready before `createVideoPlayer`.\n */\nexport function useVideoPlayer(options: UseVideoPlayerOptions): {\n videoRef: RefObject<HTMLVideoElement | null>;\n player: CorePlayer | null;\n state: PlayerState;\n error: { code: string; message: string } | null;\n play: () => void | Promise<void> | undefined;\n pause: () => void;\n seek: (t: number) => void;\n goToLive: () => ReturnType<CorePlayer[\"goToLive\"]> | undefined;\n isLive: () => boolean;\n isAtLiveEdge: () => boolean;\n destroy: () => void;\n} {\n const [player, setPlayer] = useState<CorePlayer | null>(null);\n const [state, setState] = useState<PlayerState>(\"idle\");\n const [error, setError] = useState<{\n code: string;\n message: string;\n } | null>(null);\n const videoRef = useRef<HTMLVideoElement | null>(null);\n\n useLayoutEffect(() => {\n const el = videoRef.current;\n if (!el) return;\n\n const config = mergePlayerConfig(options.config);\n const instance = createVideoPlayer({\n videoId: options.videoId,\n mount: el,\n auth: options.auth,\n playback: options.playback,\n sourceUrl: options.sourceUrl,\n player: config.player,\n controls: config.controls,\n theme: config.theme,\n watermark: config.watermark,\n streaming: config.streaming,\n logging: config.logging,\n debug: config.debug,\n accessibility: config.accessibility,\n });\n setPlayer(instance);\n setError(null);\n\n const offs = [\n instance.on(\"statechange\", ({ state: s }) => setState(s)),\n instance.on(\"error\", (err) => setError(err)),\n instance.on(\"ready\", () => options.onReady?.()),\n ];\n\n return () => {\n for (const off of offs) off();\n instance.destroy();\n setPlayer(null);\n };\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [options.videoId, options.sourceUrl]);\n\n return {\n videoRef,\n player,\n state,\n error,\n play: () => player?.play(),\n pause: () => player?.pause(),\n seek: (t: number) => player?.seek(t),\n goToLive: () => player?.goToLive(),\n isLive: () => player?.isLive() ?? false,\n isAtLiveEdge: () => player?.isAtLiveEdge() ?? true,\n destroy: () => player?.destroy(),\n };\n}\n"],"mappings":"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","names":["VideoPlayer"]}
package/dist/index.d.cts CHANGED
@@ -1,7 +1,6 @@
1
- import * as _codenkay_video_nsgplayer_core from '@codenkay/video-nsgplayer-core';
2
- import { AuthConfig, PlaybackCredentialConfig, mergePlayerConfig, VideoPlayer as VideoPlayer$1, PlayerState } from '@codenkay/video-nsgplayer-core';
3
1
  import * as react from 'react';
4
- import { CSSProperties, ReactNode } from 'react';
2
+ import { CSSProperties, ReactNode, RefObject } from 'react';
3
+ import { AuthConfig, PlaybackCredentialConfig, mergePlayerConfig, VideoPlayer as VideoPlayer$1, PlayerState } from '@codenkay/video-nsgplayer-core';
5
4
 
6
5
  type VideoPlayerHandle = VideoPlayer$1;
7
6
  type VideoPlayerProps = {
@@ -28,21 +27,25 @@ type VideoPlayerProps = {
28
27
  };
29
28
  declare const VideoPlayer: react.ForwardRefExoticComponent<VideoPlayerProps & react.RefAttributes<VideoPlayer$1>>;
30
29
  type UseVideoPlayerOptions = Omit<VideoPlayerProps, "className" | "style" | "children">;
30
+ /**
31
+ * Headless hook: bind a `<video ref={videoRef} />` in the host app.
32
+ * Uses `useLayoutEffect` so the DOM node is ready before `createVideoPlayer`.
33
+ */
31
34
  declare function useVideoPlayer(options: UseVideoPlayerOptions): {
32
- videoRef: react.RefObject<HTMLVideoElement | null>;
35
+ videoRef: RefObject<HTMLVideoElement | null>;
33
36
  player: VideoPlayer$1 | null;
34
37
  state: PlayerState;
35
38
  error: {
36
39
  code: string;
37
40
  message: string;
38
41
  } | null;
39
- play: () => Promise<void> | undefined;
40
- pause: () => void | undefined;
41
- seek: (t: number) => void | undefined;
42
- goToLive: () => _codenkay_video_nsgplayer_core.SeekToLiveResult | undefined;
42
+ play: () => void | Promise<void> | undefined;
43
+ pause: () => void;
44
+ seek: (t: number) => void;
45
+ goToLive: () => ReturnType<VideoPlayer$1["goToLive"]> | undefined;
43
46
  isLive: () => boolean;
44
47
  isAtLiveEdge: () => boolean;
45
- destroy: () => void | undefined;
48
+ destroy: () => void;
46
49
  };
47
50
 
48
51
  export { type UseVideoPlayerOptions, VideoPlayer, type VideoPlayerHandle, type VideoPlayerProps, useVideoPlayer };
package/dist/index.d.ts CHANGED
@@ -1,7 +1,6 @@
1
- import * as _codenkay_video_nsgplayer_core from '@codenkay/video-nsgplayer-core';
2
- import { AuthConfig, PlaybackCredentialConfig, mergePlayerConfig, VideoPlayer as VideoPlayer$1, PlayerState } from '@codenkay/video-nsgplayer-core';
3
1
  import * as react from 'react';
4
- import { CSSProperties, ReactNode } from 'react';
2
+ import { CSSProperties, ReactNode, RefObject } from 'react';
3
+ import { AuthConfig, PlaybackCredentialConfig, mergePlayerConfig, VideoPlayer as VideoPlayer$1, PlayerState } from '@codenkay/video-nsgplayer-core';
5
4
 
6
5
  type VideoPlayerHandle = VideoPlayer$1;
7
6
  type VideoPlayerProps = {
@@ -28,21 +27,25 @@ type VideoPlayerProps = {
28
27
  };
29
28
  declare const VideoPlayer: react.ForwardRefExoticComponent<VideoPlayerProps & react.RefAttributes<VideoPlayer$1>>;
30
29
  type UseVideoPlayerOptions = Omit<VideoPlayerProps, "className" | "style" | "children">;
30
+ /**
31
+ * Headless hook: bind a `<video ref={videoRef} />` in the host app.
32
+ * Uses `useLayoutEffect` so the DOM node is ready before `createVideoPlayer`.
33
+ */
31
34
  declare function useVideoPlayer(options: UseVideoPlayerOptions): {
32
- videoRef: react.RefObject<HTMLVideoElement | null>;
35
+ videoRef: RefObject<HTMLVideoElement | null>;
33
36
  player: VideoPlayer$1 | null;
34
37
  state: PlayerState;
35
38
  error: {
36
39
  code: string;
37
40
  message: string;
38
41
  } | null;
39
- play: () => Promise<void> | undefined;
40
- pause: () => void | undefined;
41
- seek: (t: number) => void | undefined;
42
- goToLive: () => _codenkay_video_nsgplayer_core.SeekToLiveResult | undefined;
42
+ play: () => void | Promise<void> | undefined;
43
+ pause: () => void;
44
+ seek: (t: number) => void;
45
+ goToLive: () => ReturnType<VideoPlayer$1["goToLive"]> | undefined;
43
46
  isLive: () => boolean;
44
47
  isAtLiveEdge: () => boolean;
45
- destroy: () => void | undefined;
48
+ destroy: () => void;
46
49
  };
47
50
 
48
51
  export { type UseVideoPlayerOptions, VideoPlayer, type VideoPlayerHandle, type VideoPlayerProps, useVideoPlayer };
package/dist/index.js CHANGED
@@ -7,6 +7,7 @@ import {
7
7
  import {
8
8
  useEffect,
9
9
  useImperativeHandle,
10
+ useLayoutEffect,
10
11
  useRef,
11
12
  useState,
12
13
  forwardRef
@@ -23,7 +24,7 @@ var VideoPlayer = forwardRef(
23
24
  () => mergePlayerConfig(props.config)
24
25
  );
25
26
  useImperativeHandle(ref, () => playerRef.current, [state]);
26
- useEffect(() => {
27
+ useLayoutEffect(() => {
27
28
  const el = videoRef.current;
28
29
  if (!el) return;
29
30
  const generation = ++generationRef.current;
@@ -120,7 +121,7 @@ function useVideoPlayer(options) {
120
121
  const [state, setState] = useState("idle");
121
122
  const [error, setError] = useState(null);
122
123
  const videoRef = useRef(null);
123
- useEffect(() => {
124
+ useLayoutEffect(() => {
124
125
  const el = videoRef.current;
125
126
  if (!el) return;
126
127
  const config = mergePlayerConfig(options.config);
@@ -140,6 +141,7 @@ function useVideoPlayer(options) {
140
141
  accessibility: config.accessibility
141
142
  });
142
143
  setPlayer(instance);
144
+ setError(null);
143
145
  const offs = [
144
146
  instance.on("statechange", ({ state: s }) => setState(s)),
145
147
  instance.on("error", (err) => setError(err)),
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/VideoPlayer.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n createVideoPlayer,\n mergePlayerConfig,\n themeToCssVars,\n type AuthConfig,\n type CreateVideoPlayerOptions,\n type PlaybackCredentialConfig,\n type PlayerConfig,\n type PlayerState,\n type VideoPlayer as CorePlayer,\n} from \"@codenkay/video-nsgplayer-core\";\nimport {\n useEffect,\n useImperativeHandle,\n useRef,\n useState,\n forwardRef,\n type CSSProperties,\n type ReactNode,\n} from \"react\";\n\nexport type VideoPlayerHandle = CorePlayer;\n\nexport type VideoPlayerProps = {\n videoId?: string;\n auth?: AuthConfig;\n playback?: PlaybackCredentialConfig;\n sourceUrl?: string;\n config?: Parameters<typeof mergePlayerConfig>[0];\n className?: string;\n style?: CSSProperties;\n children?: ReactNode;\n onReady?: () => void;\n onError?: (error: { code: string; message: string; fatal: boolean }) => void;\n onPlay?: () => void;\n onPause?: () => void;\n onAuthError?: (error: { message: string; retryable: boolean }) => void;\n};\n\nexport const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(\n function VideoPlayer(props, ref) {\n const videoRef = useRef<HTMLVideoElement | null>(null);\n const containerRef = useRef<HTMLDivElement | null>(null);\n const playerRef = useRef<CorePlayer | null>(null);\n const generationRef = useRef(0);\n const [state, setState] = useState<PlayerState>(\"idle\");\n const [resolvedConfig, setResolvedConfig] = useState<PlayerConfig>(() =>\n mergePlayerConfig(props.config),\n );\n\n useImperativeHandle(ref, () => playerRef.current as CorePlayer, [state]);\n\n useEffect(() => {\n const el = videoRef.current;\n if (!el) return;\n\n const generation = ++generationRef.current;\n const nextConfig = mergePlayerConfig(props.config);\n setResolvedConfig(nextConfig);\n\n const options: CreateVideoPlayerOptions = {\n videoId: props.videoId,\n mount: el,\n auth: props.auth,\n playback: props.playback,\n sourceUrl: props.sourceUrl,\n player: nextConfig.player,\n controls: nextConfig.controls,\n theme: nextConfig.theme,\n watermark: nextConfig.watermark,\n streaming: nextConfig.streaming,\n logging: nextConfig.logging,\n debug: nextConfig.debug,\n accessibility: nextConfig.accessibility,\n };\n\n const player = createVideoPlayer(options);\n playerRef.current = player;\n\n const unsubs = [\n player.on(\"statechange\", ({ state: s }) => {\n if (generation !== generationRef.current) return;\n setState(s);\n }),\n player.on(\"ready\", () => props.onReady?.()),\n player.on(\"error\", (err) => props.onError?.(err)),\n player.on(\"play\", () => props.onPlay?.()),\n player.on(\"pause\", () => props.onPause?.()),\n player.on(\"autherror\", (err) => props.onAuthError?.(err)),\n ];\n\n return () => {\n for (const off of unsubs) off();\n player.destroy();\n if (playerRef.current === player) playerRef.current = null;\n };\n // Recreate when identity of source/auth changes\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [props.videoId, props.sourceUrl]);\n\n useEffect(() => {\n const next = mergePlayerConfig(props.config);\n setResolvedConfig(next);\n playerRef.current?.updateConfig(props.config);\n }, [props.config]);\n\n const cssVars = themeToCssVars(resolvedConfig.theme) as CSSProperties;\n const headless = !resolvedConfig.controls.enabled;\n\n return (\n <div\n ref={containerRef}\n data-player-theme\n data-player-state={state}\n className={props.className}\n style={{\n position: \"relative\",\n width: \"100%\",\n background: \"#000\",\n ...cssVars,\n ...props.style,\n }}\n >\n <video\n ref={videoRef}\n playsInline\n style={{ width: \"100%\", height: \"100%\", display: \"block\" }}\n />\n {!headless && props.children}\n {!headless &&\n resolvedConfig.watermark.enabled &&\n resolvedConfig.watermark.text && (\n <div\n aria-hidden\n style={{\n position: \"absolute\",\n top: \"12%\",\n left: \"8%\",\n color: \"rgba(255,255,255,0.55)\",\n fontSize: 12,\n pointerEvents: \"none\",\n userSelect: \"none\",\n }}\n >\n {resolvedConfig.watermark.text}\n </div>\n )}\n </div>\n );\n },\n);\n\nexport type UseVideoPlayerOptions = Omit<VideoPlayerProps, \"className\" | \"style\" | \"children\">;\n\nexport function useVideoPlayer(options: UseVideoPlayerOptions) {\n const [player, setPlayer] = useState<CorePlayer | null>(null);\n const [state, setState] = useState<PlayerState>(\"idle\");\n const [error, setError] = useState<{\n code: string;\n message: string;\n } | null>(null);\n const videoRef = useRef<HTMLVideoElement | null>(null);\n\n useEffect(() => {\n const el = videoRef.current;\n if (!el) return;\n const config = mergePlayerConfig(options.config);\n const instance = createVideoPlayer({\n videoId: options.videoId,\n mount: el,\n auth: options.auth,\n playback: options.playback,\n sourceUrl: options.sourceUrl,\n player: config.player,\n controls: config.controls,\n theme: config.theme,\n watermark: config.watermark,\n streaming: config.streaming,\n logging: config.logging,\n debug: config.debug,\n accessibility: config.accessibility,\n });\n setPlayer(instance);\n const offs = [\n instance.on(\"statechange\", ({ state: s }) => setState(s)),\n instance.on(\"error\", (err) => setError(err)),\n instance.on(\"ready\", () => options.onReady?.()),\n ];\n return () => {\n for (const off of offs) off();\n instance.destroy();\n setPlayer(null);\n };\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [options.videoId, options.sourceUrl]);\n\n return {\n videoRef,\n player,\n state,\n error,\n play: () => player?.play(),\n pause: () => player?.pause(),\n seek: (t: number) => player?.seek(t),\n goToLive: () => player?.goToLive(),\n isLive: () => player?.isLive() ?? false,\n isAtLiveEdge: () => player?.isAtLiveEdge() ?? true,\n destroy: () => player?.destroy(),\n };\n}\n"],"mappings":"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","names":["VideoPlayer"]}
1
+ {"version":3,"sources":["../src/VideoPlayer.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n createVideoPlayer,\n mergePlayerConfig,\n themeToCssVars,\n type AuthConfig,\n type CreateVideoPlayerOptions,\n type PlaybackCredentialConfig,\n type PlayerConfig,\n type PlayerState,\n type VideoPlayer as CorePlayer,\n} from \"@codenkay/video-nsgplayer-core\";\nimport {\n useEffect,\n useImperativeHandle,\n useLayoutEffect,\n useRef,\n useState,\n forwardRef,\n type CSSProperties,\n type ReactNode,\n type RefObject,\n} from \"react\";\n\nexport type VideoPlayerHandle = CorePlayer;\n\nexport type VideoPlayerProps = {\n videoId?: string;\n auth?: AuthConfig;\n playback?: PlaybackCredentialConfig;\n sourceUrl?: string;\n config?: Parameters<typeof mergePlayerConfig>[0];\n className?: string;\n style?: CSSProperties;\n children?: ReactNode;\n onReady?: () => void;\n onError?: (error: { code: string; message: string; fatal: boolean }) => void;\n onPlay?: () => void;\n onPause?: () => void;\n onAuthError?: (error: { message: string; retryable: boolean }) => void;\n};\n\nexport const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(\n function VideoPlayer(props, ref) {\n const videoRef = useRef<HTMLVideoElement | null>(null);\n const containerRef = useRef<HTMLDivElement | null>(null);\n const playerRef = useRef<CorePlayer | null>(null);\n const generationRef = useRef(0);\n const [state, setState] = useState<PlayerState>(\"idle\");\n const [resolvedConfig, setResolvedConfig] = useState<PlayerConfig>(() =>\n mergePlayerConfig(props.config),\n );\n\n useImperativeHandle(ref, () => playerRef.current as CorePlayer, [state]);\n\n useLayoutEffect(() => {\n const el = videoRef.current;\n if (!el) return;\n\n const generation = ++generationRef.current;\n const nextConfig = mergePlayerConfig(props.config);\n setResolvedConfig(nextConfig);\n\n const options: CreateVideoPlayerOptions = {\n videoId: props.videoId,\n mount: el,\n auth: props.auth,\n playback: props.playback,\n sourceUrl: props.sourceUrl,\n player: nextConfig.player,\n controls: nextConfig.controls,\n theme: nextConfig.theme,\n watermark: nextConfig.watermark,\n streaming: nextConfig.streaming,\n logging: nextConfig.logging,\n debug: nextConfig.debug,\n accessibility: nextConfig.accessibility,\n };\n\n const player = createVideoPlayer(options);\n playerRef.current = player;\n\n const unsubs = [\n player.on(\"statechange\", ({ state: s }) => {\n if (generation !== generationRef.current) return;\n setState(s);\n }),\n player.on(\"ready\", () => props.onReady?.()),\n player.on(\"error\", (err) => props.onError?.(err)),\n player.on(\"play\", () => props.onPlay?.()),\n player.on(\"pause\", () => props.onPause?.()),\n player.on(\"autherror\", (err) => props.onAuthError?.(err)),\n ];\n\n return () => {\n for (const off of unsubs) off();\n player.destroy();\n if (playerRef.current === player) playerRef.current = null;\n };\n // Recreate when identity of source/auth changes\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [props.videoId, props.sourceUrl]);\n\n useEffect(() => {\n const next = mergePlayerConfig(props.config);\n setResolvedConfig(next);\n playerRef.current?.updateConfig(props.config);\n }, [props.config]);\n\n const cssVars = themeToCssVars(resolvedConfig.theme) as CSSProperties;\n const headless = !resolvedConfig.controls.enabled;\n\n return (\n <div\n ref={containerRef}\n data-player-theme\n data-player-state={state}\n className={props.className}\n style={{\n position: \"relative\",\n width: \"100%\",\n background: \"#000\",\n ...cssVars,\n ...props.style,\n }}\n >\n <video\n ref={videoRef}\n playsInline\n style={{ width: \"100%\", height: \"100%\", display: \"block\" }}\n />\n {!headless && props.children}\n {!headless &&\n resolvedConfig.watermark.enabled &&\n resolvedConfig.watermark.text && (\n <div\n aria-hidden\n style={{\n position: \"absolute\",\n top: \"12%\",\n left: \"8%\",\n color: \"rgba(255,255,255,0.55)\",\n fontSize: 12,\n pointerEvents: \"none\",\n userSelect: \"none\",\n }}\n >\n {resolvedConfig.watermark.text}\n </div>\n )}\n </div>\n );\n },\n);\n\nexport type UseVideoPlayerOptions = Omit<\n VideoPlayerProps,\n \"className\" | \"style\" | \"children\"\n>;\n\n/**\n * Headless hook: bind a `<video ref={videoRef} />` in the host app.\n * Uses `useLayoutEffect` so the DOM node is ready before `createVideoPlayer`.\n */\nexport function useVideoPlayer(options: UseVideoPlayerOptions): {\n videoRef: RefObject<HTMLVideoElement | null>;\n player: CorePlayer | null;\n state: PlayerState;\n error: { code: string; message: string } | null;\n play: () => void | Promise<void> | undefined;\n pause: () => void;\n seek: (t: number) => void;\n goToLive: () => ReturnType<CorePlayer[\"goToLive\"]> | undefined;\n isLive: () => boolean;\n isAtLiveEdge: () => boolean;\n destroy: () => void;\n} {\n const [player, setPlayer] = useState<CorePlayer | null>(null);\n const [state, setState] = useState<PlayerState>(\"idle\");\n const [error, setError] = useState<{\n code: string;\n message: string;\n } | null>(null);\n const videoRef = useRef<HTMLVideoElement | null>(null);\n\n useLayoutEffect(() => {\n const el = videoRef.current;\n if (!el) return;\n\n const config = mergePlayerConfig(options.config);\n const instance = createVideoPlayer({\n videoId: options.videoId,\n mount: el,\n auth: options.auth,\n playback: options.playback,\n sourceUrl: options.sourceUrl,\n player: config.player,\n controls: config.controls,\n theme: config.theme,\n watermark: config.watermark,\n streaming: config.streaming,\n logging: config.logging,\n debug: config.debug,\n accessibility: config.accessibility,\n });\n setPlayer(instance);\n setError(null);\n\n const offs = [\n instance.on(\"statechange\", ({ state: s }) => setState(s)),\n instance.on(\"error\", (err) => setError(err)),\n instance.on(\"ready\", () => options.onReady?.()),\n ];\n\n return () => {\n for (const off of offs) off();\n instance.destroy();\n setPlayer(null);\n };\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [options.videoId, options.sourceUrl]);\n\n return {\n videoRef,\n player,\n state,\n error,\n play: () => player?.play(),\n pause: () => player?.pause(),\n seek: (t: number) => player?.seek(t),\n goToLive: () => player?.goToLive(),\n isLive: () => player?.isLive() ?? false,\n isAtLiveEdge: () => player?.isAtLiveEdge() ?? true,\n destroy: () => player?.destroy(),\n };\n}\n"],"mappings":"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","names":["VideoPlayer"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@codenkay/video-nsgplayer-react",
3
- "version": "0.1.0",
3
+ "version": "1.0.0",
4
4
  "description": "React bindings for NSG video player",
5
5
  "license": "MIT",
6
6
  "author": "NSG Player",
@@ -15,10 +15,15 @@
15
15
  "require": "./dist/index.cjs"
16
16
  }
17
17
  },
18
- "files": ["dist", "README.md", "LICENSE", "CHANGELOG.md"],
18
+ "files": [
19
+ "dist",
20
+ "README.md",
21
+ "LICENSE",
22
+ "CHANGELOG.md"
23
+ ],
19
24
  "sideEffects": false,
20
25
  "peerDependencies": {
21
- "@codenkay/video-nsgplayer-core": "^0.1.0",
26
+ "@codenkay/video-nsgplayer-core": "^1.0.0",
22
27
  "react": ">=18",
23
28
  "react-dom": ">=18"
24
29
  },
@@ -29,10 +34,10 @@
29
34
  },
30
35
  "devDependencies": {
31
36
  "@codenkay/video-nsgplayer-core": "*",
32
- "@types/react": "^19",
33
- "@types/react-dom": "^19",
34
- "react": "19.2.8",
35
- "react-dom": "19.2.8",
37
+ "@types/react": "^18.3.9",
38
+ "@types/react-dom": "^18.3.0",
39
+ "react": "^18.3.1",
40
+ "react-dom": "^18.3.1",
36
41
  "tsup": "^8.5.0",
37
42
  "typescript": "^5",
38
43
  "vitest": "^4.1.10"