BUMP: v3.2.9 subscribe WHITELIST feature

Author: varshneydevansh

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## Version 3.2.9
+
+### Subscribed Channels Import + Whitelist Flow
+
+- **Subscribed channels import**: Added a Tab View flow that imports the active YouTube account's subscriptions into whitelist.
+- **YouTube tab startup hardening**: The import now reuses or opens a YouTube tab, routes it to `/feed/channels`, and waits for the FilterTube bridge before starting.
+- **Whitelist semantics clarified**: `Import Only` keeps the current blocklist untouched, while `Import + Turn On Whitelist` follows the existing blocklist-to-whitelist migration behavior.
+- **Documentation refresh**: Added dedicated import docs plus updated architecture, technical, pipeline, renderer, and developer docs for the new flow.
+
 ## Version 3.2.8
 
 ### Theme Refresh + Scenic UI Shell Tuning

README.md

@@ -3,7 +3,7 @@
   <h1>FilterTube</h1>
   <p>Peace of Mind for your Digital Space</p>
 
-  [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/varshneydevansh/FilterTube) ![Version](https://img.shields.io/badge/version-3.2.8-blue.svg) ![License](https://img.shields.io/badge/license-MIT-green.svg) ![Lines of Code](https://img.shields.io/badge/total%20lines-87.1k-brightgreen.svg) ![JavaScript LoC](https://img.shields.io/badge/javascript-53.0k%20lines-yellow.svg) ![Top Language](https://img.shields.io/github/languages/top/varshneydevansh/FilterTube?color=f1e05a) ![Repo Size](https://img.shields.io/github/repo-size/varshneydevansh/FilterTube?color=orange)
+  [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/varshneydevansh/FilterTube) ![Version](https://img.shields.io/badge/version-3.2.9-blue.svg) ![License](https://img.shields.io/badge/license-MIT-green.svg) ![Lines of Code](https://img.shields.io/badge/total%20lines-87.9k-brightgreen.svg) ![JavaScript LoC](https://img.shields.io/badge/javascript-53.2k%20lines-yellow.svg) ![Top Language](https://img.shields.io/github/languages/top/varshneydevansh/FilterTube?color=f1e05a) ![Repo Size](https://img.shields.io/github/repo-size/varshneydevansh/FilterTube?color=orange)
 
 </div>
 

css/tab-view.css

@@ -1273,13 +1273,28 @@ html[data-theme="dark"] .card::after {
 }
 
 .subscriptions-import-trigger {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.58rem;
     min-height: 44px;
     white-space: nowrap;
     justify-content: center;
     flex: 0 0 auto;
     border-radius: 999px;
 }
 
+.subscriptions-import-trigger.is-loading::before {
+    content: '';
+    width: 0.92rem;
+    height: 0.92rem;
+    border-radius: 50%;
+    border: 2px solid currentColor;
+    border-right-color: transparent;
+    flex: 0 0 auto;
+    opacity: 0.82;
+    animation: ft-subscriptions-import-spin 0.78s linear infinite;
+}
+
 .subscriptions-import-inline {
     display: grid;
     grid-template-columns: minmax(0, 1fr) auto;
@@ -1300,6 +1315,24 @@ html[data-theme="dark"] .card::after {
     line-height: 1.4;
 }
 
+.subscriptions-import-inline.is-loading .subscriptions-import-status {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.62rem;
+}
+
+.subscriptions-import-inline.is-loading .subscriptions-import-status::before {
+    content: '';
+    width: 0.88rem;
+    height: 0.88rem;
+    border-radius: 50%;
+    border: 2px solid currentColor;
+    border-top-color: transparent;
+    flex: 0 0 auto;
+    opacity: 0.7;
+    animation: ft-subscriptions-import-spin 0.78s linear infinite;
+}
+
 .subscriptions-import-actions {
     display: flex;
     align-items: center;
@@ -1356,6 +1389,12 @@ html[data-theme="dark"] .card::after {
     flex-wrap: wrap;
 }
 
+@keyframes ft-subscriptions-import-spin {
+    to {
+        transform: rotate(360deg);
+    }
+}
+
 :root[data-theme="dark"] .subscriptions-import-inline {
     border-color: rgba(176, 135, 70, 0.32);
     background: linear-gradient(180deg, rgba(46, 38, 29, 0.94), rgba(33, 28, 23, 0.92));
@@ -1387,6 +1426,13 @@ html[data-theme="dark"] .card::after {
     color: var(--ft-color-text-secondary-dark);
 }
 
+@media (prefers-reduced-motion: reduce) {
+    .subscriptions-import-trigger.is-loading::before,
+    .subscriptions-import-inline.is-loading .subscriptions-import-status::before {
+        animation: none;
+    }
+}
+
 .text-input {
     flex: 1;
     padding: var(--ft-space-sm) var(--ft-space-md);

data/release_notes.json

@@ -2,6 +2,19 @@
   {
     "_comment": "Shared release notes source for the dashboard What's New tab and the YouTube release banner. Keep entries sorted newest-first by version."
   },
+  {
+    "version": "3.2.9",
+    "headline": "Subscribed Channels Import + Whitelist + PIN protection bug fix",
+    "summary": "Import the active YouTube account's subscriptions into whitelist with clearer mode-switch semantics and a more reliable /feed/channels startup flow.",
+    "bannerSummary": "Build whitelist from your current YouTube subscriptions with inline progress and clearer whitelist activation behavior.",
+    "highlights": [
+      "New Tab View import: subscribed channels can be imported from the active signed-in YouTube account into whitelist.",
+      "Import startup now reuses a live YouTube tab, routes it to /feed/channels, and waits for the FilterTube bridge before starting.",
+      "Whitelist copy is clearer: Import Only leaves the blocklist untouched, while Import + Turn On Whitelist follows the existing blocklist-to-whitelist migration path.",
+      "Documentation now covers the import architecture, FEchannels request flow, renderer sources, and whitelist semantics in much more detail."
+    ],
+    "detailsUrl": "https://github.com/varshneydevansh/FilterTube/releases/tag/v3.2.9"
+  },
   {
     "version": "3.2.8",
     "headline": "Theme Refresh + Scenic UI Shell Tuning",

docs/ARCHITECTURE.md

@@ -1,4 +1,4 @@
-# Architecture Documentation (v3.2.8)
+# Architecture Documentation (v3.2.9)
 
 ## Overview
 
@@ -86,6 +86,71 @@ const switchToWhitelist = async (profile, copyBlocklist = true) => {
 };
 ```
 
+## Subscribed Channels Import Architecture (v3.2.9 follow-up)
+
+The subscriptions importer adds a second whitelist acquisition path alongside manual whitelist entry. It is intentionally an on-demand architecture, separate from passive feed filtering.
+
+Detailed reference: `docs/SUBSCRIBED_CHANNELS_IMPORT.md`
+
+### High-level flow
+
+```mermaid
+graph TD
+    A["Tab View: Import Subscribed Channels"] --> B["Resolve signed-in YouTube tab"]
+    B --> C["Route tab to /feed/channels"]
+    C --> D["Wait for page + FilterTube bridge"]
+    D --> E["Isolated bridge forwards import request"]
+    E --> F["MAIN world injector reads page seed"]
+    F --> G["MAIN world injector requests FEchannels browse pages"]
+    G --> H["Normalized subscription channel list"]
+    H --> I["StateManager validates profile + lock state"]
+    I --> J["Background merges into main.whitelistChannels"]
+    J --> K{"Turn On Whitelist?"}
+    K -->|No| L["Whitelist stored only"]
+    K -->|Yes| M["Existing mode-switch path merges blocklist into whitelist"]
+```
+
+### Why this architecture exists
+
+- The importer must run from a real signed-in YouTube page context.
+- Popup/background-only state is not enough because the request depends on the authenticated YouTube tab plus the FilterTube bridge in that tab.
+- `/feed/channels` gives a predictable subscription page shell and lets the importer use both page-local data and active `youtubei` browse requests.
+
+### Two whitelist-construction paths
+
+Architecturally, FilterTube now needs to document two ways the whitelist can be built:
+
+- **Direct whitelist population**
+  - writes rows straight into `whitelistChannels` / `whitelistKeywords`
+  - includes subscriptions import and normal whitelist-specific additions
+- **Mode-switch migration**
+  - activates when `FilterTube_SetListMode('whitelist')` runs
+  - merges current blocklist channels/keywords into whitelist and clears the blocklist
+
+The subscriptions importer can stop after the first path or continue into the second one.
+
+### Startup contract
+
+```ascii
+UI (tab-view)
+  -> choose a YouTube tab
+  -> move it to /feed/channels if needed
+  -> ping the subscriptions-import receiver
+  -> inject isolated bridge if missing
+  -> wait for MAIN-world injector ready signal
+  -> start import
+```
+
+### Persistence boundary
+
+The page never writes storage directly. The trust boundary is:
+
+- page / bridge world: collect and normalize subscription rows
+- `state_manager.js`: validate active profile + session lock state
+- `background.js`: merge, dedupe, persist, refresh tabs
+
+This keeps whitelist imports aligned with the rest of profile-aware storage rules.
+
 ## UI/UX Architecture (v3.2.2)
 
 ### Extension Shell Layer (v3.2.8 follow-up)
@@ -239,6 +304,7 @@ function stashNetworkSnapshot(data, dataName) {
 - **Purpose**: Extract channel identity from multiple data sources
 - **Key Functions**: `searchYtInitialDataForVideoChannel()`, `extractCollaboratorsFromDataObject()`
 - **Data Sources**: Stashed snapshots, page globals, DOM data
+- **Subscriptions Import Role**: Handles `FilterTube_RequestSubscriptionImport`, collects `/feed/channels` page seed, then follows `FEchannels` browse pages and posts progress/results back to the isolated bridge.
 
 ### Isolated World Components
 
@@ -247,6 +313,11 @@ function stashNetworkSnapshot(data, dataName) {
 - **Key Functions**: `prefetchIdentityForCard()`, `injectFilterTubeMenuItem()`, `handleBlockChannelClick()`
 - **Data Flow**: Main World → UI Updates → Background Messages
 
+#### `content/bridge_settings.js` - Import Bridge Gateway
+- **Purpose**: Keeps the subscriptions-import bridge alive in isolated world, forwards requests to MAIN world, relays progress to the UI/runtime, and waits for injector-ready signals.
+- **Key Functions**: `waitForMainWorldImportBridgeReady()`, `FilterTubeRequestSubscribedChannelsFromMainWorld()`
+- **Data Flow**: Tab View/StateManager → runtime message → postMessage to MAIN world → progress/response relay
+
 #### `dom_fallback.js` - DOM Processing
 - **Purpose**: Process DOM elements when structured data fails
 - **Key Functions**: `applyDOMFallback()`, `shouldHideContent()`
@@ -258,6 +329,7 @@ function stashNetworkSnapshot(data, dataName) {
 - **Purpose**: Persistent storage, API calls, enrichment scheduling
 - **Key Functions**: `handleAddFilteredChannel()`, `schedulePostBlockEnrichment()`, `fetchChannelInfo()`
 - **Storage**: Chrome storage API, profile management
+- **Subscriptions Import Role**: `FilterTube_BatchImportWhitelistChannels` merges imported rows into `ftProfilesV4.main.whitelistChannels` and backfills legacy whitelist mirrors plus `channelMap`.
 
 ## Data Flow Architecture
 

docs/CHANNEL_BLOCKING_SYSTEM.md

@@ -245,6 +245,61 @@ Result: Multi-channel menus appear instantly on watch/home/search.
 
 ---
 
+## 5. Subscribed Channels -> Whitelist Import (v3.2.9 follow-up)
+
+This feature gives whitelist mode a second acquisition path besides manual add/import files.
+
+### Scope
+
+- main YouTube only
+- main profile whitelist only
+- driven from Tab View channel management
+- sourced from the active YouTube account in the selected tab
+
+### Flow
+
+```mermaid
+graph TD
+    A["Tab View: Import Subscribed Channels"] --> B["Move selected YouTube tab to /feed/channels"]
+    B --> C["Wait for bridge + MAIN-world injector"]
+    C --> D["Collect subscription rows"]
+    D --> E["Normalize channel identity"]
+    E --> F["Background batch merge into whitelistChannels"]
+    F --> G{"Turn on whitelist?"}
+    G -->|No| H["Whitelist stored only"]
+    G -->|Yes| I["Existing blocklist merged into whitelist and cleared"]
+```
+
+### Important semantics
+
+- FilterTube currently has **two ways to build whitelist**:
+  - direct whitelist population, such as subscribed-channels import or other whitelist-specific adds
+  - blocklist-to-whitelist migration when whitelist mode is activated
+- `Import Only` appends subscriptions to `main.whitelistChannels`
+- it does **not** change the current blocklist
+- `Import + Turn On Whitelist` calls the existing mode-switch path
+- that current path merges the profile's blocklist channels and keywords into whitelist and clears the blocklist
+
+### Identity quality
+
+Imported subscription rows are normalized like other channel entries:
+
+- prefer stable `UC...` IDs
+- keep `@handle` when present
+- keep `customUrl` when present
+- keep best available name/logo
+
+### Persistence behavior
+
+The background batch import:
+
+- dedupes against existing whitelist entries
+- updates weak existing rows with stronger imported metadata
+- mirrors the result into legacy whitelist storage where needed
+- updates `channelMap` when new handle/custom URL mappings are learned
+
+This keeps subscriptions import compatible with the rest of the blocking/allowing system instead of creating a second storage model.
+
 ## 6. Blocking Flow (3-dot Menu → Resolve → Persist → Hide)
 
 ### 6.1 Menu injection and click detection
@@ -920,4 +975,3 @@ The menu injection background enrichment should not do network fetches.
 
 Now:
 - Menu “background fetch” uses `fetchIdForHandle(handle, { skipNetwork: true })`.
-

docs/CODEMAP.md

@@ -91,6 +91,7 @@ FilterTube/
 **New Features:**
 - **Debounced Refresh**: `scheduleSettingsRefreshFromStorage()` with 250ms minimum intervals
 - **Storage Filtering**: Ignores channelMap-only changes to prevent excessive reprocessing
+- **Subscriptions Import Bridge**: Keeps a dedicated MAIN-world import bridge alive, forwards `FilterTube_ImportSubscribedChannels`, and relays progress/errors safely back to the UI.
 
 ### `js/filter_logic.js` - **OPTIMIZED v3.2.1+**
 **Context:** Main World (YouTube pages)
@@ -104,6 +105,7 @@ FilterTube/
 **Improvements:**
 - **Non-configurable Property Safety**: Checks for `configurable: false` before attempting to define properties
 - **Error Handling**: Try-catch blocks around `ytInitialData` hook installation
+- **Subscriptions Import Coordinator**: Handles `FilterTube_RequestSubscriptionImport`, builds `FEchannels` request profiles from `ytcfg`, normalizes channel rows, emits progress, and returns the final channel list.
 
 ### `js/seed.js` - **SAFETY ENHANCED v3.2.1+**
 **Context:** Main World (YouTube pages)
@@ -119,6 +121,7 @@ FilterTube/
 **Enhancements:**
 - **Source-based Enrichment Logic**: Import channels skip unnecessary enrichment
 - **Storage Change Filtering**: Ignores channelMap-only changes to reduce listeners
+- **Subscribed Channels Import**: `importSubscribedChannelsToWhitelist()` validates tab/profile/lock state, requests the channel roster from the selected YouTube tab, then persists it through background batch import.
 
 ### `js/io_manager.js`
 **Context:** UI contexts (Tab View) + future sync modules
@@ -187,6 +190,20 @@ FilterTube/
 - Reads both hash (`#whatsnew`) and query parameters (`?view=whatsnew`) so banner deep-links auto-select the correct view.
 - Import/Export card calls into `io_manager.js` for all serialization logic.
 
+#### Tab view additions (v3.2.9 follow-up)
+- `resolveSubscriptionsImportTab()` reuses a main YouTube tab, moves it to `/feed/channels`, and waits for the page + bridge to be ready.
+- `waitForYoutubeTabReady()` distinguishes page-loading, bridge-startup, sign-in, and receiver-unavailable states.
+- `renderSubscriptionsImportState()` and `syncSubscriptionsImportControls()` drive the inline import status shell and loading animation.
+- `confirmSubscriptionsImportModeChoice()` explains the difference between plain whitelist import and whitelist activation.
+
+### `js/background.js` - subscriptions import additions
+| Function / Action | Description |
+| :--- | :--- |
+| `mergeImportedWhitelistChannels()` | Normalizes/dedupes imported whitelist rows and returns merge counts. |
+| `FilterTube_BatchImportWhitelistChannels` | Persists imported rows into `ftProfilesV4` plus legacy whitelist mirrors and `channelMap`. |
+| `FilterTube_EnsureSubscriptionsImportBridge` | Injects the isolated import bridge into a YouTube tab when the receiver is missing. |
+| `FilterTube_SetListMode` | Existing mode-switch handler that the import flow can call after persistence. |
+
 ### `js/render_engine.js`
 **Context:** UI Contexts
 **Purpose:** Handles DOM updates and rendering of lists (keywords, channels).