@moviie/player-sdk 0.6.0 → 0.8.0

package/dist/index.d.cts

@@ -50,6 +50,30 @@ declare function createTranscriptSearchController(opts: {
     minLength?: number;
 }): TranscriptSearchController;
 
+/**
+ * AI video summary shapes (feature 189) — the sanitized, player-ready summary
+ * delivered to native/SDK consumers in the playback payload. The server renders
+ * the stored Markdown to safe HTML before it reaches the client (the embed and
+ * native players never parse Markdown themselves); `html`/`tldrHtml` are already
+ * sanitized. Section timestamps drive seek-on-tap.
+ */
+interface VideoSummarySection {
+    /** 0-based, contiguous per-minute index. */
+    index: number;
+    /** Window start in seconds — the seek target when the viewer taps the section. */
+    startSeconds: number;
+    /** Pre-formatted clock label, e.g. `"00:00–01:00"`. */
+    label: string;
+    /** Sanitized HTML for this minute's prose. */
+    html: string;
+}
+interface VideoSummaryDocument {
+    /** Sanitized HTML for the overall TL;DR shown at the top of the panel. */
+    tldrHtml: string;
+    /** Per-minute sections covering the whole video, in order. */
+    sections: VideoSummarySection[];
+}
+
 interface MoviieClientInfo {
     bundleId?: string;
     platform: 'ios' | 'android' | 'web';
@@ -85,6 +109,20 @@ interface MoviieCTA {
     size: 'sm' | 'md' | 'lg';
     passUrlParams: boolean;
 }
+type DrmWatermarkStyle = {
+    fontFamily: 'Arial' | 'Inter' | 'Raleway' | 'Roboto' | 'Ubuntu';
+    /** Hex #RRGGBB. */
+    backgroundColor: string;
+    /** Hex #RRGGBB. */
+    textColor: string;
+    animationSpeed: 'slow' | 'normal' | 'fast';
+};
+interface DrmWatermark {
+    /** 1–3 sanitized viewer lines (top→bottom). Present only for a triggered playback. */
+    lines: string[];
+    /** Resolved style: per-video override → org default → built-in DS default. */
+    style: DrmWatermarkStyle;
+}
 interface MoviiePlaybackControls {
     autoplay: boolean;
     preload: boolean;
@@ -151,6 +189,12 @@ interface MoviiePlaybackData {
     telemetry: {
         bootstrapUrl: string;
     };
+    /**
+     * Feature 196 — social DRM watermark. Present only for a triggered private
+     * playback (the token carried viewer `drm.lines`); omitted otherwise so the
+     * native player mounts no overlay.
+     */
+    drm?: DrmWatermark;
     /**
      * Feature 185 — native pixel emission (Meta Conversions API only; the native
      * player has no browser tags). Present only when a Meta pixel has the CAPI
@@ -164,6 +208,13 @@ interface MoviiePlaybackData {
         /** Feature 187 → 185: timestamps (s) of pitch checkpoints; crossing fires `pitch`. */
         pitchTimestamps?: number[];
     };
+    /**
+     * Feature 189 — AI video summary (TL;DR + per-minute sections), already
+     * sanitized server-side. Present only when a summary exists AND display
+     * resolves as enabled (org→video override); absent otherwise, so the native
+     * AI-menu trigger stays hidden. Mirrors the web embed's gated inline panel.
+     */
+    summary?: VideoSummaryDocument;
 }
 /** Minimal shape from GET /v1/videos/:id for embed_id resolution */
 interface MoviieVideo {
@@ -372,4 +423,4 @@ declare const MOVIIE_WATCH_BASE = "https://watch.moviie.ai";
 
 declare function deriveTelemetryEventsBaseUrlFromBootstrapUrl(bootstrapUrl: string): string | null;
 
-export { HEARTBEAT_CONFIG, MOVIIE_CDN_BASE, MOVIIE_DEFAULT_API_BASE_URL, MOVIIE_TELEMETRY_API_PATH_PREFIX, MOVIIE_WATCH_BASE, MemoryViewerTokenStore, MoviieAuthError, MoviieBundleBlockedError, type MoviieCTA, type MoviieCaption, type MoviieChapter, MoviieClient, type MoviieClientInfo, MoviieDirectAccessBlockedError, type MoviieEndpointsConfiguration, type MoviieErrorCode, MoviieNetworkError, MoviieNotFoundError, type MoviiePlaybackControls, type MoviiePlaybackData, MoviieRateLimitError, MoviieReferrerBlockedError, MoviieSubscriptionInactiveError, type MoviieVariant, type MoviieVideo, PLAYBACK_EVENT_TYPE, SDK_PLAYBACK_AUTH_ERROR_MESSAGE, SDK_PUBLIC_API_KEY_PREFIX_PUBLISHABLE, TELEMETRY_TOKEN_CONFIG, TRANSCRIPT_SEARCH_DEBOUNCE_MS, TRANSCRIPT_SEARCH_MIN_LENGTH, TelemetryClient, type TranscriptSearchController, type TranscriptSearchMatch, type TranscriptSearchResult, type ViewerTokenStore, buildClientHeaders, configureMoviieEndpoints, createTranscriptSearchController, deriveMoviieTelemetryBaseUrlFromApiBaseUrl, deriveTelemetryEventsBaseUrlFromBootstrapUrl, fetchPlaybackData, fetchTranscriptSearch, getMoviieApiBaseUrl, getMoviieEventsBaseUrl, planRefresh, resetMoviieEndpointsConfiguration };
+export { HEARTBEAT_CONFIG, MOVIIE_CDN_BASE, MOVIIE_DEFAULT_API_BASE_URL, MOVIIE_TELEMETRY_API_PATH_PREFIX, MOVIIE_WATCH_BASE, MemoryViewerTokenStore, MoviieAuthError, MoviieBundleBlockedError, type MoviieCTA, type MoviieCaption, type MoviieChapter, MoviieClient, type MoviieClientInfo, MoviieDirectAccessBlockedError, type MoviieEndpointsConfiguration, type MoviieErrorCode, MoviieNetworkError, MoviieNotFoundError, type MoviiePlaybackControls, type MoviiePlaybackData, MoviieRateLimitError, MoviieReferrerBlockedError, MoviieSubscriptionInactiveError, type MoviieVariant, type MoviieVideo, PLAYBACK_EVENT_TYPE, SDK_PLAYBACK_AUTH_ERROR_MESSAGE, SDK_PUBLIC_API_KEY_PREFIX_PUBLISHABLE, TELEMETRY_TOKEN_CONFIG, TRANSCRIPT_SEARCH_DEBOUNCE_MS, TRANSCRIPT_SEARCH_MIN_LENGTH, TelemetryClient, type TranscriptSearchController, type TranscriptSearchMatch, type TranscriptSearchResult, type VideoSummaryDocument, type VideoSummarySection, type ViewerTokenStore, buildClientHeaders, configureMoviieEndpoints, createTranscriptSearchController, deriveMoviieTelemetryBaseUrlFromApiBaseUrl, deriveTelemetryEventsBaseUrlFromBootstrapUrl, fetchPlaybackData, fetchTranscriptSearch, getMoviieApiBaseUrl, getMoviieEventsBaseUrl, planRefresh, resetMoviieEndpointsConfiguration };

package/dist/index.d.ts

@@ -50,6 +50,30 @@ declare function createTranscriptSearchController(opts: {
     minLength?: number;
 }): TranscriptSearchController;
 
+/**
+ * AI video summary shapes (feature 189) — the sanitized, player-ready summary
+ * delivered to native/SDK consumers in the playback payload. The server renders
+ * the stored Markdown to safe HTML before it reaches the client (the embed and
+ * native players never parse Markdown themselves); `html`/`tldrHtml` are already
+ * sanitized. Section timestamps drive seek-on-tap.
+ */
+interface VideoSummarySection {
+    /** 0-based, contiguous per-minute index. */
+    index: number;
+    /** Window start in seconds — the seek target when the viewer taps the section. */
+    startSeconds: number;
+    /** Pre-formatted clock label, e.g. `"00:00–01:00"`. */
+    label: string;
+    /** Sanitized HTML for this minute's prose. */
+    html: string;
+}
+interface VideoSummaryDocument {
+    /** Sanitized HTML for the overall TL;DR shown at the top of the panel. */
+    tldrHtml: string;
+    /** Per-minute sections covering the whole video, in order. */
+    sections: VideoSummarySection[];
+}
+
 interface MoviieClientInfo {
     bundleId?: string;
     platform: 'ios' | 'android' | 'web';
@@ -85,6 +109,20 @@ interface MoviieCTA {
     size: 'sm' | 'md' | 'lg';
     passUrlParams: boolean;
 }
+type DrmWatermarkStyle = {
+    fontFamily: 'Arial' | 'Inter' | 'Raleway' | 'Roboto' | 'Ubuntu';
+    /** Hex #RRGGBB. */
+    backgroundColor: string;
+    /** Hex #RRGGBB. */
+    textColor: string;
+    animationSpeed: 'slow' | 'normal' | 'fast';
+};
+interface DrmWatermark {
+    /** 1–3 sanitized viewer lines (top→bottom). Present only for a triggered playback. */
+    lines: string[];
+    /** Resolved style: per-video override → org default → built-in DS default. */
+    style: DrmWatermarkStyle;
+}
 interface MoviiePlaybackControls {
     autoplay: boolean;
     preload: boolean;
@@ -151,6 +189,12 @@ interface MoviiePlaybackData {
     telemetry: {
         bootstrapUrl: string;
     };
+    /**
+     * Feature 196 — social DRM watermark. Present only for a triggered private
+     * playback (the token carried viewer `drm.lines`); omitted otherwise so the
+     * native player mounts no overlay.
+     */
+    drm?: DrmWatermark;
     /**
      * Feature 185 — native pixel emission (Meta Conversions API only; the native
      * player has no browser tags). Present only when a Meta pixel has the CAPI
@@ -164,6 +208,13 @@ interface MoviiePlaybackData {
         /** Feature 187 → 185: timestamps (s) of pitch checkpoints; crossing fires `pitch`. */
         pitchTimestamps?: number[];
     };
+    /**
+     * Feature 189 — AI video summary (TL;DR + per-minute sections), already
+     * sanitized server-side. Present only when a summary exists AND display
+     * resolves as enabled (org→video override); absent otherwise, so the native
+     * AI-menu trigger stays hidden. Mirrors the web embed's gated inline panel.
+     */
+    summary?: VideoSummaryDocument;
 }
 /** Minimal shape from GET /v1/videos/:id for embed_id resolution */
 interface MoviieVideo {
@@ -372,4 +423,4 @@ declare const MOVIIE_WATCH_BASE = "https://watch.moviie.ai";
 
 declare function deriveTelemetryEventsBaseUrlFromBootstrapUrl(bootstrapUrl: string): string | null;
 
-export { HEARTBEAT_CONFIG, MOVIIE_CDN_BASE, MOVIIE_DEFAULT_API_BASE_URL, MOVIIE_TELEMETRY_API_PATH_PREFIX, MOVIIE_WATCH_BASE, MemoryViewerTokenStore, MoviieAuthError, MoviieBundleBlockedError, type MoviieCTA, type MoviieCaption, type MoviieChapter, MoviieClient, type MoviieClientInfo, MoviieDirectAccessBlockedError, type MoviieEndpointsConfiguration, type MoviieErrorCode, MoviieNetworkError, MoviieNotFoundError, type MoviiePlaybackControls, type MoviiePlaybackData, MoviieRateLimitError, MoviieReferrerBlockedError, MoviieSubscriptionInactiveError, type MoviieVariant, type MoviieVideo, PLAYBACK_EVENT_TYPE, SDK_PLAYBACK_AUTH_ERROR_MESSAGE, SDK_PUBLIC_API_KEY_PREFIX_PUBLISHABLE, TELEMETRY_TOKEN_CONFIG, TRANSCRIPT_SEARCH_DEBOUNCE_MS, TRANSCRIPT_SEARCH_MIN_LENGTH, TelemetryClient, type TranscriptSearchController, type TranscriptSearchMatch, type TranscriptSearchResult, type ViewerTokenStore, buildClientHeaders, configureMoviieEndpoints, createTranscriptSearchController, deriveMoviieTelemetryBaseUrlFromApiBaseUrl, deriveTelemetryEventsBaseUrlFromBootstrapUrl, fetchPlaybackData, fetchTranscriptSearch, getMoviieApiBaseUrl, getMoviieEventsBaseUrl, planRefresh, resetMoviieEndpointsConfiguration };
+export { HEARTBEAT_CONFIG, MOVIIE_CDN_BASE, MOVIIE_DEFAULT_API_BASE_URL, MOVIIE_TELEMETRY_API_PATH_PREFIX, MOVIIE_WATCH_BASE, MemoryViewerTokenStore, MoviieAuthError, MoviieBundleBlockedError, type MoviieCTA, type MoviieCaption, type MoviieChapter, MoviieClient, type MoviieClientInfo, MoviieDirectAccessBlockedError, type MoviieEndpointsConfiguration, type MoviieErrorCode, MoviieNetworkError, MoviieNotFoundError, type MoviiePlaybackControls, type MoviiePlaybackData, MoviieRateLimitError, MoviieReferrerBlockedError, MoviieSubscriptionInactiveError, type MoviieVariant, type MoviieVideo, PLAYBACK_EVENT_TYPE, SDK_PLAYBACK_AUTH_ERROR_MESSAGE, SDK_PUBLIC_API_KEY_PREFIX_PUBLISHABLE, TELEMETRY_TOKEN_CONFIG, TRANSCRIPT_SEARCH_DEBOUNCE_MS, TRANSCRIPT_SEARCH_MIN_LENGTH, TelemetryClient, type TranscriptSearchController, type TranscriptSearchMatch, type TranscriptSearchResult, type VideoSummaryDocument, type VideoSummarySection, type ViewerTokenStore, buildClientHeaders, configureMoviieEndpoints, createTranscriptSearchController, deriveMoviieTelemetryBaseUrlFromApiBaseUrl, deriveTelemetryEventsBaseUrlFromBootstrapUrl, fetchPlaybackData, fetchTranscriptSearch, getMoviieApiBaseUrl, getMoviieEventsBaseUrl, planRefresh, resetMoviieEndpointsConfiguration };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moviie/player-sdk",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "private": false,
   "description": "Vendor-agnostic Moviie player SDK — playback metadata, HTTP client, telemetry.",
   "keywords": [
@@ -41,7 +41,7 @@
   ],
   "dependencies": {
     "zod": "^3.25.76",
-    "@moviie/player-types": "1.3.0"
+    "@moviie/player-types": "1.4.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",