npm - unified-video-framework - Versions diffs - 1.0.0 - Mend

unified-video-framework 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.

Files changed (129) hide show

package/.github/workflows/ci.yml +253 -0
package/ANDROID_TV_IMPLEMENTATION.md +313 -0
package/COMPLETION_STATUS.md +165 -0
package/CONTRIBUTING.md +376 -0
package/FINAL_STATUS_REPORT.md +170 -0
package/FRAMEWORK_REVIEW.md +247 -0
package/IMPROVEMENTS_SUMMARY.md +168 -0
package/LICENSE +21 -0
package/NATIVE_APP_INTEGRATION_GUIDE.md +903 -0
package/PAYWALL_RENTAL_FLOW.md +499 -0
package/PLATFORM_SETUP_GUIDE.md +1636 -0
package/README.md +315 -0
package/RUN_LOCALLY.md +151 -0
package/apps/demo/cast-sender-min.html +173 -0
package/apps/demo/custom-player.html +883 -0
package/apps/demo/demo.html +990 -0
package/apps/demo/enhanced-player.html +3556 -0
package/apps/demo/index.html +159 -0
package/apps/rental-api/.env.example +24 -0
package/apps/rental-api/README.md +23 -0
package/apps/rental-api/migrations/001_init.sql +35 -0
package/apps/rental-api/migrations/002_videos.sql +10 -0
package/apps/rental-api/migrations/003_add_gateway_subref.sql +4 -0
package/apps/rental-api/migrations/004_update_gateways.sql +4 -0
package/apps/rental-api/migrations/005_seed_demo_video.sql +5 -0
package/apps/rental-api/package-lock.json +2045 -0
package/apps/rental-api/package.json +33 -0
package/apps/rental-api/scripts/run-migration.js +42 -0
package/apps/rental-api/scripts/update-video-currency.js +21 -0
package/apps/rental-api/scripts/update-video-price.js +19 -0
package/apps/rental-api/src/config.ts +14 -0
package/apps/rental-api/src/db.ts +10 -0
package/apps/rental-api/src/routes/cashfree.ts +167 -0
package/apps/rental-api/src/routes/pesapal.ts +92 -0
package/apps/rental-api/src/routes/rentals.ts +242 -0
package/apps/rental-api/src/routes/webhooks.ts +73 -0
package/apps/rental-api/src/server.ts +41 -0
package/apps/rental-api/src/services/entitlements.ts +45 -0
package/apps/rental-api/src/services/payments.ts +22 -0
package/apps/rental-api/tsconfig.json +17 -0
package/check-urls.ps1 +74 -0
package/comparison-report.md +181 -0
package/docs/PAYWALL.md +95 -0
package/docs/PLAYER_UI_VISIBILITY.md +431 -0
package/docs/README.md +7 -0
package/docs/SYSTEM_ARCHITECTURE.md +612 -0
package/docs/VDOCIPHER_CLONE_REQUIREMENTS.md +403 -0
package/examples/android/JavaSampleApp/MainActivity.java +641 -0
package/examples/android/JavaSampleApp/activity_main.xml +226 -0
package/examples/android/SampleApp/MainActivity.kt +430 -0
package/examples/ios/SampleApp/ViewController.swift +337 -0
package/examples/ios/SwiftUISampleApp/ContentView.swift +304 -0
package/iOS_IMPLEMENTATION_OPTIONS.md +470 -0
package/ios/UnifiedVideoPlayer/UnifiedVideoPlayer.podspec +33 -0
package/jest.config.js +33 -0
package/jitpack.yml +5 -0
package/lerna.json +35 -0
package/package.json +69 -0
package/packages/PLATFORM_STATUS.md +163 -0
package/packages/android/build.gradle +135 -0
package/packages/android/src/main/AndroidManifest.xml +36 -0
package/packages/android/src/main/java/com/unifiedvideo/player/PlayerConfiguration.java +221 -0
package/packages/android/src/main/java/com/unifiedvideo/player/UnifiedVideoPlayer.java +1037 -0
package/packages/android/src/main/java/com/unifiedvideo/player/UnifiedVideoPlayer.kt +707 -0
package/packages/android/src/main/java/com/unifiedvideo/player/analytics/AnalyticsProvider.java +9 -0
package/packages/android/src/main/java/com/unifiedvideo/player/cast/CastManager.java +141 -0
package/packages/android/src/main/java/com/unifiedvideo/player/cast/CastOptionsProvider.java +29 -0
package/packages/android/src/main/java/com/unifiedvideo/player/overlay/WatermarkOverlayView.java +88 -0
package/packages/android/src/main/java/com/unifiedvideo/player/pip/PipActionReceiver.java +33 -0
package/packages/android/src/main/java/com/unifiedvideo/player/services/PlaybackService.java +110 -0
package/packages/android/src/main/java/com/unifiedvideo/player/services/PlayerHolder.java +19 -0
package/packages/core/package.json +34 -0
package/packages/core/src/BasePlayer.ts +250 -0
package/packages/core/src/VideoPlayer.ts +237 -0
package/packages/core/src/VideoPlayerFactory.ts +145 -0
package/packages/core/src/index.ts +20 -0
package/packages/core/src/interfaces/IVideoPlayer.ts +184 -0
package/packages/core/src/interfaces.ts +240 -0
package/packages/core/src/utils/EventEmitter.ts +66 -0
package/packages/core/src/utils/PlatformDetector.ts +300 -0
package/packages/core/tsconfig.json +20 -0
package/packages/enact/package.json +51 -0
package/packages/enact/src/VideoPlayer.js +365 -0
package/packages/enact/src/adapters/TizenAdapter.js +354 -0
package/packages/enact/src/index.js +82 -0
package/packages/ios/BUILD_INSTRUCTIONS.md +108 -0
package/packages/ios/FIX_EMBED_ISSUE.md +142 -0
package/packages/ios/GETTING_STARTED.md +100 -0
package/packages/ios/Package.swift +35 -0
package/packages/ios/README.md +84 -0
package/packages/ios/Sources/UnifiedVideoPlayer/Analytics/AnalyticsEmitter.swift +26 -0
package/packages/ios/Sources/UnifiedVideoPlayer/DRM/FairPlayDRMManager.swift +102 -0
package/packages/ios/Sources/UnifiedVideoPlayer/Info.plist +24 -0
package/packages/ios/Sources/UnifiedVideoPlayer/Remote/RemoteCommandCenter.swift +109 -0
package/packages/ios/Sources/UnifiedVideoPlayer/UnifiedVideoPlayer.swift +811 -0
package/packages/ios/Sources/UnifiedVideoPlayer/UnifiedVideoPlayerView.swift +640 -0
package/packages/ios/Sources/UnifiedVideoPlayer/Utilities/Color+Hex.swift +36 -0
package/packages/ios/UnifiedVideoPlayer.podspec +27 -0
package/packages/ios/UnifiedVideoPlayer.xcodeproj/project.pbxproj +385 -0
package/packages/ios/build_framework.sh +55 -0
package/packages/react-native/android/src/main/java/com/unifiedvideo/UnifiedVideoPlayerModule.kt +482 -0
package/packages/react-native/ios/UnifiedVideoPlayer.swift +436 -0
package/packages/react-native/package.json +51 -0
package/packages/react-native/src/ReactNativePlayer.tsx +423 -0
package/packages/react-native/src/VideoPlayer.tsx +224 -0
package/packages/react-native/src/index.ts +28 -0
package/packages/react-native/src/utils/EventEmitter.ts +66 -0
package/packages/react-native/tsconfig.json +31 -0
package/packages/roku/components/UnifiedVideoPlayer.brs +400 -0
package/packages/roku/package.json +44 -0
package/packages/roku/source/VideoPlayer.brs +231 -0
package/packages/roku/source/main.brs +28 -0
package/packages/web/GETTING_STARTED.md +292 -0
package/packages/web/jest.config.js +28 -0
package/packages/web/jest.setup.ts +110 -0
package/packages/web/package.json +50 -0
package/packages/web/src/SecureVideoPlayer.ts +1164 -0
package/packages/web/src/WebPlayer.ts +3110 -0
package/packages/web/src/__tests__/WebPlayer.test.ts +314 -0
package/packages/web/src/index.ts +14 -0
package/packages/web/src/paywall/PaywallController.ts +215 -0
package/packages/web/src/react/WebPlayerView.tsx +177 -0
package/packages/web/tsconfig.json +23 -0
package/packages/web/webpack.config.js +45 -0
package/server.js +131 -0
package/server.py +84 -0
package/test-urls.ps1 +97 -0
package/test-video-urls.ps1 +87 -0
package/tsconfig.json +39 -0

package/apps/demo/index.html ADDED Viewed

@@ -0,0 +1,159 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Unified Video Framework - Web Demo</title>
+  <style>
+    html, body { height: 100%; margin: 0; background: #111; color: #eee; font-family: Arial, sans-serif; }
+    .app { display: flex; height: 100%; }
+    .sidebar { width: 320px; background: #1b1b1b; padding: 16px; box-sizing: border-box; border-right: 1px solid #2a2a2a; }
+    .content { flex: 1; display: flex; flex-direction: column; }
+    .player-container { position: relative; flex: 1; padding: 12px; box-sizing: border-box; }
+    .player { width: 100%; height: 100%; border-radius: 6px; overflow: hidden; background: #000; }
+    h1 { font-size: 18px; margin: 0 0 12px; }
+    label { display: block; margin: 10px 0 6px; font-size: 12px; color: #bbb; }
+    input, select { width: 100%; padding: 8px; border-radius: 4px; border: 1px solid #333; background: #222; color: #eee; }
+    button { padding: 8px 12px; background: #2e7d32; color: #fff; border: none; border-radius: 4px; cursor: pointer; margin-right: 8px; }
+    button.secondary { background: #1565c0; }
+    .controls { padding: 12px; border-top: 1px solid #2a2a2a; background: #161616; }
+    .row { margin-bottom: 12px; }
+    .small { font-size: 12px; color: #aaa; }
+    .examples { margin-top: 16px; }
+    .examples button { display: block; width: 100%; margin: 6px 0; background: #333; }
+  </style>
+</head>
+<body>
+  <div class="app">
+    <div class="sidebar">
+      <h1>Web Demo</h1>
+      <div class="row">
+        <label for="sourceUrl">Video URL</label>
+        <input id="sourceUrl" type="text" placeholder="https://... .mp4 | .m3u8 | .mpd" />
+      </div>
+      <div class="row">
+        <label for="subtitleUrl">Subtitle (VTT) URL</label>
+        <input id="subtitleUrl" type="text" placeholder="https://... .vtt (optional)" />
+      </div>
+      <div class="row">
+        <button id="loadBtn">Load</button>
+        <button id="playBtn" class="secondary">Play</button>
+        <button id="pauseBtn" class="secondary">Pause</button>
+      </div>
+      <div class="examples">
+        <div class="small">Examples</div>
+        <button data-url="https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4">Big Buck Bunny (MP4)</button>
+        <button data-url="https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8">HLS Sample (m3u8)</button>
+        <button data-url="https://dash.akamaized.net/envivio/EnvivioDash3/manifest.mpd">DASH Sample (mpd)</button>
+      </div>
+    </div>
+    <div class="content">
+      <div class="player-container">
+        <div id="player" class="player"></div>
+      </div>
+      <div class="controls">
+        <div class="row">
+          <button id="seekBack">⏪ 10s</button>
+          <button id="seekFwd">10s ⏩</button>
+          <button id="muteBtn">Mute</button>
+          <button id="unmuteBtn">Unmute</button>
+          <button id="pipBtn">PiP</button>
+          <button id="fsBtn">Fullscreen</button>
+        </div>
+        <div class="row small" id="status">Idle</div>
+      </div>
+    </div>
+  </div>
+  <script type="module">
+    // If this page is opened in a popup (checkout return), notify the opener and close
+    try {
+      const params = new URLSearchParams(window.location.search);
+      if (params.get('popup') === '1') {
+        const status = params.get('rental') || 'cancel';
+        const orderId = params.get('order_id') || null;
+        window.opener?.postMessage({ type: 'uvfCheckout', status, orderId }, '*');
+        window.close();
+      }
+    } catch (_) {}
+    import { WebPlayer } from '../../packages/web/dist/WebPlayer.js';
+    const container = document.getElementById('player');
+    const player = new WebPlayer();
+    const urlInput = document.getElementById('sourceUrl');
+    const subInput = document.getElementById('subtitleUrl');
+    const status = document.getElementById('status');
+    function setStatus(text) {
+      status.textContent = text;
+    }
+    async function initPlayer() {
+      // Fetch a dynamic paywall config (mock) for demo tenant
+      let paywallCfg = null;
+      try {
+        const r = await fetch('http://localhost:3100/api/rentals/config?tenant=demo&userId=u1&videoId=v1');
+        if (r.ok) paywallCfg = await r.json();
+      } catch(_) {}
+      await player.initialize(container, {
+        autoPlay: false,
+        playsInline: true,
+        freeDuration: 60,
+        paywall: paywallCfg
+      });
+    }
+    async function loadFromInputs() {
+      const url = urlInput.value.trim();
+      const sub = subInput.value.trim();
+      if (!url) {
+        alert('Please enter a video URL');
+        return;
+      }
+      const source = sub ? { url, subtitles: [{ url: sub, label: 'English', language: 'en', kind: 'subtitles' }] } : { url };
+      await player.load(source);
+      setStatus('Loaded: ' + url);
+    }
+    document.getElementById('loadBtn').addEventListener('click', loadFromInputs);
+    document.getElementById('playBtn').addEventListener('click', () => player.play());
+    document.getElementById('pauseBtn').addEventListener('click', () => player.pause());
+    document.getElementById('seekBack').addEventListener('click', () => player.seek(Math.max(0, player.getCurrentTime() - 10)));
+    document.getElementById('seekFwd').addEventListener('click', () => player.seek(player.getCurrentTime() + 10));
+    document.getElementById('muteBtn').addEventListener('click', () => player.mute());
+    document.getElementById('unmuteBtn').addEventListener('click', () => player.unmute());
+    document.getElementById('pipBtn').addEventListener('click', () => player.enterPictureInPicture());
+    document.getElementById('fsBtn').addEventListener('click', () => player.enterFullscreen());
+    // Example buttons
+    document.querySelectorAll('.examples button').forEach(btn => {
+      btn.addEventListener('click', async () => {
+        urlInput.value = btn.dataset.url;
+        subInput.value = '';
+        await loadFromInputs();
+        await player.play();
+      });
+    });
+    // Initialize and set default content
+    await initPlayer();
+    // Update status on core events emitted by WebPlayer
+    player.on('onReady', () => setStatus('ready'));
+    player.on('onPlay', () => setStatus('play'));
+    player.on('onPause', () => setStatus('pause'));
+    player.on('onEnded', () => setStatus('ended'));
+    player.on('onTimeUpdate', (t) => setStatus('timeupdate | ' + t));
+    player.on('onProgress', (b) => setStatus('progress | ' + b));
+    player.on('onBuffering', (is) => setStatus('buffering | ' + is));
+    // Load an example by default
+    urlInput.value = document.querySelector('.examples button')?.dataset.url || '';
+    await loadFromInputs();
+  </script>
+</body>
+</html>

package/apps/rental-api/.env.example ADDED Viewed

@@ -0,0 +1,24 @@
+# Environment variables for Rental API
+# Server
+APP_BASE_URL=http://localhost:3100
+# Database
+# Stripe
+STRIPE_SECRET_KEY=sk_test_51Ng98aG6SInHNoTWaOwzKVMVh4TrBoAph0udCI7jx53Ho2aaVMyAqWi2jyqg2tu4MYRXunb9Gcok0FTn0LDKtYWy00aHmPk4u7
+STRIPE_WEBHOOK_SECRET=whsec_...
+# Cashfree (use sandbox creds for testing)
+CASHFREE_APP_ID=TEST10707044630f12610890ea0a28ed44070701
+CASHFREE_SECRET_KEY=cfsk_ma_test_6d20ed37e28873306663b9615051e96d_9a698b9d
+CASHFREE_BASE_URL=https://sandbox.cashfree.com
+# Cashfree (live creds)
+# CASHFREE_APP_ID=1015351787aa22366940646e8bc1535101
+# CASHFREE_SECRET_KEY=cfsk_ma_prod_8fa46de39384ffcf86de01fb50aacdcc_0f3197a9
+# https://api.cashfree.com - live
+# https://sandbox.cashfree.com - sandbox
+DATABASE_URL=postgres://postgres:CzfWq3PUksRKnw50O6vlacxF@localhost:5432/uvf
+PORT=3100
+ENABLE_DEV_MOCKS=1

package/apps/rental-api/README.md ADDED Viewed

@@ -0,0 +1,23 @@
+# Rental API (Stripe + Pesapal)
+Implements the per-video rental paywall flow. Keep the player payment-agnostic and unlock playback after entitlement is true.
+## Commands
+- Install deps: (from repo root)
+  - npm install
+- Build: (from repo root)
+  - npm run build:rental-api
+- Dev server (hot reload):
+  - cd apps/rental-api && npm run dev
+- Start (compiled):
+  - cd apps/rental-api && npm start
+## Env
+Copy .env.example to .env and set values.
+## Migrations
+Run SQL in migrations/001_init.sql on your Postgres DB (or use your migration tool). A simple script scaffolding is included in scripts/run-migration.js.

package/apps/rental-api/migrations/001_init.sql ADDED Viewed

@@ -0,0 +1,35 @@
+-- Enable pgcrypto for gen_random_uuid()
+CREATE EXTENSION IF NOT EXISTS pgcrypto;
+-- Payments
+CREATE TABLE IF NOT EXISTS payments (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  gateway TEXT NOT NULL CHECK (gateway IN ('stripe','pesapal','google_pay')),
+  gateway_ref TEXT NOT NULL UNIQUE,
+  amount_cents INT NOT NULL,
+  currency TEXT NOT NULL,
+  status TEXT NOT NULL CHECK (status IN ('succeeded','pending','failed','refunded')),
+  raw_payload JSONB NOT NULL,
+  user_id TEXT NOT NULL,
+  video_id TEXT NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_payments_user_video ON payments(user_id, video_id);
+-- Entitlements (rentals only)
+CREATE TABLE IF NOT EXISTS entitlements (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  user_id TEXT NOT NULL,
+  video_id TEXT NOT NULL,
+  type TEXT NOT NULL CHECK (type = 'rental'),
+  starts_at TIMESTAMPTZ NOT NULL,
+  expires_at TIMESTAMPTZ NOT NULL,
+  status TEXT NOT NULL CHECK (status IN ('active','expired')),
+  source_payment_id UUID NOT NULL REFERENCES payments(id) ON DELETE RESTRICT,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  UNIQUE (user_id, video_id, status)
+);
+CREATE INDEX IF NOT EXISTS idx_entitlements_user_video ON entitlements(user_id, video_id);

package/apps/rental-api/migrations/002_videos.sql ADDED Viewed

@@ -0,0 +1,10 @@
+-- Videos catalog used by the rental API
+CREATE TABLE IF NOT EXISTS videos (
+  video_id TEXT PRIMARY KEY,
+  title TEXT,
+  price_cents INT NOT NULL,
+  currency TEXT NOT NULL,
+  rental_duration_hours INT NOT NULL DEFAULT 48,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);

package/apps/rental-api/migrations/003_add_gateway_subref.sql ADDED Viewed

@@ -0,0 +1,4 @@
+-- Add gateway_subref to correlate refunds with payments (e.g., Stripe payment_intent)
+ALTER TABLE payments ADD COLUMN IF NOT EXISTS gateway_subref TEXT;
+CREATE INDEX IF NOT EXISTS idx_payments_gateway_subref ON payments(gateway_subref);

package/apps/rental-api/migrations/004_update_gateways.sql ADDED Viewed

@@ -0,0 +1,4 @@
+-- Update payments.gateway check constraint to include 'cashfree' and drop 'pesapal'
+ALTER TABLE payments DROP CONSTRAINT IF EXISTS payments_gateway_check;
+ALTER TABLE payments ADD CONSTRAINT payments_gateway_check CHECK (gateway IN ('stripe','cashfree','google_pay'));

package/apps/rental-api/migrations/005_seed_demo_video.sql ADDED Viewed

@@ -0,0 +1,5 @@
+-- Seed a demo video so checkout endpoints can resolve price and duration
+INSERT INTO videos (video_id, title, price_cents, currency, rental_duration_hours)
+VALUES ('v1', 'Demo Video', 199, 'USD', 48)
+ON CONFLICT (video_id) DO NOTHING;