@scarlett-player/native 0.1.1 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hackney Enterprises Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -24,15 +24,27 @@ __export(index_exports, {
   default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
-var SUPPORTED_EXTENSIONS = ["mp4", "webm", "mov", "mkv", "ogv", "ogg", "m4v"];
+var import_core = require("@scarlett-player/core");
+var VIDEO_EXTENSIONS = ["mp4", "webm", "mov", "mkv", "ogv", "m4v"];
+var AUDIO_EXTENSIONS = ["mp3", "wav", "ogg", "flac", "aac", "m4a", "opus", "weba"];
+var SUPPORTED_EXTENSIONS = [...VIDEO_EXTENSIONS, ...AUDIO_EXTENSIONS];
 var MIME_TYPES = {
+  // Video
   mp4: "video/mp4",
   m4v: "video/mp4",
   webm: "video/webm",
   mov: "video/quicktime",
   mkv: "video/x-matroska",
   ogv: "video/ogg",
-  ogg: "video/ogg"
+  // Audio
+  mp3: "audio/mpeg",
+  wav: "audio/wav",
+  ogg: "audio/ogg",
+  flac: "audio/flac",
+  aac: "audio/aac",
+  m4a: "audio/mp4",
+  opus: "audio/opus",
+  weba: "audio/webm"
 };
 function createNativePlugin(config) {
   const preload = config?.preload ?? "metadata";
@@ -53,9 +65,13 @@ function createNativePlugin(config) {
   const getMimeType = (ext) => {
     return MIME_TYPES[ext] || "video/mp4";
   };
+  const isAudioExtension = (ext) => {
+    return AUDIO_EXTENSIONS.includes(ext);
+  };
   const canBrowserPlay = (mimeType) => {
-    const testVideo = document.createElement("video");
-    const canPlay = testVideo.canPlayType(mimeType);
+    const isAudio = mimeType.startsWith("audio/");
+    const testElement = isAudio ? document.createElement("audio") : document.createElement("video");
+    const canPlay = testElement.canPlayType(mimeType);
     return canPlay === "probably" || canPlay === "maybe";
   };
   const getOrCreateVideo = () => {
@@ -70,6 +86,10 @@ function createNativePlugin(config) {
     video.preload = preload;
     video.controls = false;
     video.playsInline = true;
+    const poster = api?.getState("poster");
+    if (poster) {
+      video.poster = poster;
+    }
     api?.container.appendChild(video);
     return video;
   };
@@ -162,7 +182,7 @@ function createNativePlugin(config) {
       }
       api?.logger.error("Video error", { code: error?.code, message });
       api?.emit("error", {
-        code: "MEDIA_ERROR",
+        code: import_core.ErrorCode.PLAYBACK_FAILED,
         message,
         fatal: true,
         timestamp: Date.now()
@@ -185,10 +205,10 @@ function createNativePlugin(config) {
   };
   const plugin = {
     id: "native-provider",
-    name: "Native Video Provider",
+    name: "Native Media Provider",
     version: "1.0.0",
     type: "provider",
-    description: "Native HTML5 video playback for MP4, WebM, MOV, MKV",
+    description: "Native HTML5 playback for video (MP4, WebM, MOV) and audio (MP3, WAV, FLAC, AAC)",
     canPlay(src) {
       const ext = getExtension(src);
       if (!SUPPORTED_EXTENSIONS.includes(ext)) {
@@ -250,11 +270,35 @@ function createNativePlugin(config) {
       if (!api) throw new Error("Plugin not initialized");
       const ext = getExtension(src);
       const mimeType = getMimeType(ext);
-      api.logger.info("Loading native video source", { src, mimeType });
+      const isAudio = isAudioExtension(ext);
+      api.logger.info("Loading native media source", { src, mimeType, isAudio });
       cleanup();
       api.setState("playbackState", "loading");
       api.setState("buffering", true);
+      api.setState("mediaType", isAudio ? "audio" : "video");
+      if (isAudio) {
+        try {
+          const url = new URL(src, window.location.href);
+          const filename = url.pathname.split("/").pop() || "Audio";
+          const title = decodeURIComponent(filename.replace(/\.[^.]+$/, "").replace(/[-_]/g, " "));
+          api.setState("title", title);
+        } catch {
+          api.setState("title", "Audio");
+        }
+      }
+      api.setState("qualities", []);
+      api.setState("currentQuality", null);
       const videoEl = getOrCreateVideo();
+      if (isAudio) {
+        videoEl.style.display = "none";
+        videoEl.poster = "";
+      } else {
+        videoEl.style.display = "block";
+        const poster = api.getState("poster");
+        if (poster) {
+          videoEl.poster = poster;
+        }
+      }
       cleanupEvents = setupEventListeners(videoEl);
       return new Promise((resolve, reject) => {
         const onLoaded = () => {

package/dist/index.d.cts

@@ -1,14 +1,24 @@
 import { PluginType, IPluginAPI } from '@scarlett-player/core';
 
 /**
- * Native Video Provider Plugin for Scarlett Player
+ * Native Media Provider Plugin for Scarlett Player
  *
  * Provides playback for native browser-supported formats:
+ *
+ * Video:
  * - MP4 (H.264/AAC)
  * - WebM (VP8/VP9/Opus)
  * - MOV (H.264/AAC)
  * - MKV (varies by browser)
  * - OGG/OGV (Theora/Vorbis)
+ *
+ * Audio:
+ * - MP3 (MPEG Audio Layer 3)
+ * - WAV (Waveform Audio)
+ * - OGG (Vorbis)
+ * - FLAC (Free Lossless Audio Codec)
+ * - AAC (Advanced Audio Coding)
+ * - M4A (MPEG-4 Audio)
  */
 
 interface NativePluginConfig {

package/dist/index.d.ts

@@ -1,14 +1,24 @@
 import { PluginType, IPluginAPI } from '@scarlett-player/core';
 
 /**
- * Native Video Provider Plugin for Scarlett Player
+ * Native Media Provider Plugin for Scarlett Player
  *
  * Provides playback for native browser-supported formats:
+ *
+ * Video:
  * - MP4 (H.264/AAC)
  * - WebM (VP8/VP9/Opus)
  * - MOV (H.264/AAC)
  * - MKV (varies by browser)
  * - OGG/OGV (Theora/Vorbis)
+ *
+ * Audio:
+ * - MP3 (MPEG Audio Layer 3)
+ * - WAV (Waveform Audio)
+ * - OGG (Vorbis)
+ * - FLAC (Free Lossless Audio Codec)
+ * - AAC (Advanced Audio Coding)
+ * - M4A (MPEG-4 Audio)
  */
 
 interface NativePluginConfig {

package/dist/index.js

@@ -1,13 +1,25 @@
 // src/index.ts
-var SUPPORTED_EXTENSIONS = ["mp4", "webm", "mov", "mkv", "ogv", "ogg", "m4v"];
+import { ErrorCode } from "@scarlett-player/core";
+var VIDEO_EXTENSIONS = ["mp4", "webm", "mov", "mkv", "ogv", "m4v"];
+var AUDIO_EXTENSIONS = ["mp3", "wav", "ogg", "flac", "aac", "m4a", "opus", "weba"];
+var SUPPORTED_EXTENSIONS = [...VIDEO_EXTENSIONS, ...AUDIO_EXTENSIONS];
 var MIME_TYPES = {
+  // Video
   mp4: "video/mp4",
   m4v: "video/mp4",
   webm: "video/webm",
   mov: "video/quicktime",
   mkv: "video/x-matroska",
   ogv: "video/ogg",
-  ogg: "video/ogg"
+  // Audio
+  mp3: "audio/mpeg",
+  wav: "audio/wav",
+  ogg: "audio/ogg",
+  flac: "audio/flac",
+  aac: "audio/aac",
+  m4a: "audio/mp4",
+  opus: "audio/opus",
+  weba: "audio/webm"
 };
 function createNativePlugin(config) {
   const preload = config?.preload ?? "metadata";
@@ -28,9 +40,13 @@ function createNativePlugin(config) {
   const getMimeType = (ext) => {
     return MIME_TYPES[ext] || "video/mp4";
   };
+  const isAudioExtension = (ext) => {
+    return AUDIO_EXTENSIONS.includes(ext);
+  };
   const canBrowserPlay = (mimeType) => {
-    const testVideo = document.createElement("video");
-    const canPlay = testVideo.canPlayType(mimeType);
+    const isAudio = mimeType.startsWith("audio/");
+    const testElement = isAudio ? document.createElement("audio") : document.createElement("video");
+    const canPlay = testElement.canPlayType(mimeType);
     return canPlay === "probably" || canPlay === "maybe";
   };
   const getOrCreateVideo = () => {
@@ -45,6 +61,10 @@ function createNativePlugin(config) {
     video.preload = preload;
     video.controls = false;
     video.playsInline = true;
+    const poster = api?.getState("poster");
+    if (poster) {
+      video.poster = poster;
+    }
     api?.container.appendChild(video);
     return video;
   };
@@ -137,7 +157,7 @@ function createNativePlugin(config) {
       }
       api?.logger.error("Video error", { code: error?.code, message });
       api?.emit("error", {
-        code: "MEDIA_ERROR",
+        code: ErrorCode.PLAYBACK_FAILED,
         message,
         fatal: true,
         timestamp: Date.now()
@@ -160,10 +180,10 @@ function createNativePlugin(config) {
   };
   const plugin = {
     id: "native-provider",
-    name: "Native Video Provider",
+    name: "Native Media Provider",
     version: "1.0.0",
     type: "provider",
-    description: "Native HTML5 video playback for MP4, WebM, MOV, MKV",
+    description: "Native HTML5 playback for video (MP4, WebM, MOV) and audio (MP3, WAV, FLAC, AAC)",
     canPlay(src) {
       const ext = getExtension(src);
       if (!SUPPORTED_EXTENSIONS.includes(ext)) {
@@ -225,11 +245,35 @@ function createNativePlugin(config) {
       if (!api) throw new Error("Plugin not initialized");
       const ext = getExtension(src);
       const mimeType = getMimeType(ext);
-      api.logger.info("Loading native video source", { src, mimeType });
+      const isAudio = isAudioExtension(ext);
+      api.logger.info("Loading native media source", { src, mimeType, isAudio });
       cleanup();
       api.setState("playbackState", "loading");
       api.setState("buffering", true);
+      api.setState("mediaType", isAudio ? "audio" : "video");
+      if (isAudio) {
+        try {
+          const url = new URL(src, window.location.href);
+          const filename = url.pathname.split("/").pop() || "Audio";
+          const title = decodeURIComponent(filename.replace(/\.[^.]+$/, "").replace(/[-_]/g, " "));
+          api.setState("title", title);
+        } catch {
+          api.setState("title", "Audio");
+        }
+      }
+      api.setState("qualities", []);
+      api.setState("currentQuality", null);
       const videoEl = getOrCreateVideo();
+      if (isAudio) {
+        videoEl.style.display = "none";
+        videoEl.poster = "";
+      } else {
+        videoEl.style.display = "block";
+        const poster = api.getState("poster");
+        if (poster) {
+          videoEl.poster = poster;
+        }
+      }
       cleanupEvents = setupEventListeners(videoEl);
       return new Promise((resolve, reject) => {
         const onLoaded = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scarlett-player/native",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Native Video Provider Plugin for Scarlett Player (MP4, WebM, MOV, MKV)",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -16,20 +16,14 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
-    "test": "vitest --run",
-    "test:watch": "vitest"
-  },
   "peerDependencies": {
-    "@scarlett-player/core": "^0.1.0"
+    "@scarlett-player/core": "^0.2.0"
   },
   "devDependencies": {
-    "@scarlett-player/core": "file:../../core",
     "typescript": "^5.3.0",
     "tsup": "^8.0.0",
-    "vitest": "^1.6.0"
+    "vitest": "^1.6.0",
+    "@scarlett-player/core": "0.2.0"
   },
   "keywords": [
     "video",
@@ -49,5 +43,11 @@
   "bugs": {
     "url": "https://github.com/Hackney-Enterprises-Inc/scarlett-player/issues"
   },
-  "homepage": "https://scarlettplayer.com"
-}
+  "homepage": "https://scarlettplayer.com",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "test": "vitest --run",
+    "test:watch": "vitest"
+  }
+}