update docs

.docs/content/3.in-depth/3.building-scrapers.md

@@ -351,6 +351,9 @@ if (!apiResponse.success) {
 ```
 
 ### 4. Protected Streams
+There are several ways to bypass protections on streams.
+
+Using the M3U8 proxy:
 ```typescript
 import { createM3U8ProxyUrl } from '@/utils/proxy';
 
@@ -366,7 +369,28 @@ return {
     id: 'primary',
     type: 'hls',
     playlist: createM3U8ProxyUrl(originalPlaylist, streamHeaders),
-    flags: [], // Proxy handles CORS
+    flags: [flags.CORS_ALLOWED], // Proxy bypasses cors so we say it's allowed
+    captions: []
+  }]
+};
+```
+
+Using the browser extension:
+```typescript
+// For streams that require special headers
+const streamHeaders = {
+  'Referer': 'https://player.example.com/',
+  'Origin': 'https://player.example.com',
+  'User-Agent': 'Mozilla/5.0...'
+};
+
+return {
+  stream: [{
+    id: 'primary',
+    type: 'hls',
+    playlist: originalPlaylist,
+    headers: streamHeaders,
+    flags: [], // Use the extension becuase it can pass headers
     captions: []
   }]
 };
@@ -448,7 +472,7 @@ pnpm cli --source-id turbovid --url "https://turbovid.eu/embed/DjncbDBEmbLW"
       type: 'hls',
       id: 'primary',
       playlist: 'https://proxy.fifthwit.net/m3u8-proxy?url=https%3A%2F%2Fqueenselti.pro%2Fwrofm%2Fuwu.m3u8&headers=%7B%22referer%22%3A%22https%3A%2F%2Fturbovid.eu%2F%22%2C%22origin%22%3A%2F%2Fturbovid.eu%22%7D',
-      flags: [],
+      flags: [flags.CORS_ALLOWED],
       captions: []
     }
   ]

.docs/content/5.api-reference/1.ProviderControlsRunAll.md

@@ -4,14 +4,15 @@ Run all providers one by one in order of their built-in ranking.
 You can attach events if you need to know what is going on while it is processing.
 
 ## Example
-
+(Use the cli to learn more specifics about inputs)
 ```ts
 // media from TMDB
 const media = {
-  type: 'movie',
+  type: 'movie',         // "movie" | "show"
   title: 'Hamilton',
-  releaseYear: 2020,
-  tmdbId: '556574'
+  tmdbId: '556574',
+  // season: '1',
+  // episode: '1'
 }
 
 // scrape a stream