@mdcrtrs/player 0.1.3

package/LICENSE

@@ -0,0 +1,51 @@
+MediaCreators "MOS ONE" License
+
+Copyright (c) 2025 MediaCreators. All rights reserved.
+
+PROPRIETARY SOFTWARE LICENSE
+
+This software and associated documentation files (the "Software") are the proprietary
+and confidential property of MediaCreators ("Company"). This Software is protected by
+copyright laws and international copyright treaties, as well as other intellectual
+property laws and treaties.
+
+RESTRICTIONS:
+
+1. The Software is licensed, not sold. You may not use, copy, modify, distribute,
+   sell, or transfer the Software or any portion thereof without express written
+   permission from MediaCreators.
+
+2. You may not reverse engineer, decompile, disassemble, or otherwise attempt to
+   derive the source code of the Software.
+
+3. You may not remove, alter, or obscure any proprietary notices (including copyright
+   and trademark notices) that may be affixed to or contained within the Software.
+
+4. This Software may only be used by authorized personnel of MediaCreators or its
+   affiliated entities for business purposes directly related to MediaCreators'
+   operations.
+
+AUTHORIZED USE:
+
+- Employees and contractors of MediaCreators may use this Software for development,
+  testing, and production purposes as part of their work responsibilities.
+- Access to this Software implies acceptance of these license terms.
+
+DISCLAIMER:
+
+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 MEDIACREATORS 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.
+
+CONTACT:
+
+For licensing inquiries or permissions, contact:
+MediaCreators
+Email: legal@mediacreators.io
+Website: https://mediacreators.io
+
+This license is effective as of the date of first use and remains in effect until
+terminated by MediaCreators.

package/README.md

@@ -0,0 +1,77 @@
+# @mdcrtrs/player
+
+Video player SDK for [MediaCreators](https://mediacreators.io) Streaming Community frontends. Drop-in React component with signed playback, theming, volume persistence, and optional watch progress tracking.
+
+## Install
+
+```bash
+npm install @mdcrtrs/player
+```
+
+Requires `react` and `react-dom` >= 18 as peer dependencies.
+
+## Usage
+
+```tsx
+import { MediaCreatorsPlayer } from "@mdcrtrs/player"
+
+function VideoPlayer() {
+  return (
+    <MediaCreatorsPlayer
+      creatorId="your-project-public-id"
+      asset={{
+        assetId: "asset-id",
+        playbackId: "playback-id",
+        title: "Episode 1",
+      }}
+      theme={{ primaryColor: "#6366F1" }}
+      onPlay={(currentTime) => console.log("Playing at", currentTime)}
+    />
+  )
+}
+```
+
+### With fan authentication and watch progress
+
+```tsx
+<MediaCreatorsPlayer
+  creatorId="your-project-public-id"
+  asset={asset}
+  auth={{ fanToken: "fan-session-token" }}
+  autoResume
+  onTimeUpdate={(currentTime, duration, pct) => {}}
+  onQuartile={(q) => console.log(`Reached ${q}%`)}
+  onComplete={() => console.log("Done")}
+/>
+```
+
+## Props
+
+| Prop | Type | Required | Description |
+|------|------|----------|-------------|
+| `creatorId` | `string` | Yes | Project public ID |
+| `asset` | `PlayerAsset` | Yes | Asset to play (`assetId`, `playbackId`, `title`, optional `duration`) |
+| `auth` | `{ fanToken: string }` | No | Fan authentication for personalized features |
+| `theme` | `{ primaryColor: string }` | No | Brand color (CSS color value) |
+| `playerTheme` | `string` | No | Player chrome theme name |
+| `poster` | `string` | No | Poster image URL |
+| `autoResume` | `boolean` | No | Resume from last watched position (requires `auth`) |
+| `className` | `string` | No | CSS class for the player container |
+
+### Events
+
+| Event | Signature | Description |
+|-------|-----------|-------------|
+| `onReady` | `() => void` | Player is ready |
+| `onPlay` | `(currentTime: number) => void` | Playback started |
+| `onPause` | `(currentTime: number) => void` | Playback paused |
+| `onTimeUpdate` | `(currentTime, duration, pct) => void` | Periodic time update |
+| `onQuartile` | `(quartile: 25 \| 50 \| 75 \| 100) => void` | Playback quartile reached |
+| `onSeeked` | `(from: number, to: number) => void` | User seeked |
+| `onComplete` | `() => void` | Playback completed |
+| `onResume` | `(position: number) => void` | Resumed from saved position |
+| `onError` | `(error: { code: string, message: string }) => void` | Playback error |
+
+## License
+
+Proprietary - MediaCreators