@youmind-openlab/rettiwt-api 1.0.0 → 1.0.1

package/.claude/settings.local.json

@@ -2,7 +2,8 @@
   "permissions": {
     "allow": [
       "Bash(npm run build:*)",
-      "Bash(npm run build:browser:*)"
+      "Bash(npm run build:browser:*)",
+      "Bash(npm run build:all:*)"
     ]
   }
 }

package/dist/browser/adapters/DomAdapter.d.ts

@@ -1,6 +1,7 @@
 /**
- * Browser-native DOM parsing.
- * Replaces JSDOM with native DOMParser for browser environments.
+ * DOM parsing adapter for browser environments.
+ * Uses linkedom for compatibility with both popup and service worker (background) contexts.
+ * DOMParser is not available in service workers, so we use linkedom which works everywhere.
  *
  * @internal
  */

package/dist/browser/adapters/DomAdapter.js

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DomAdapter = void 0;
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore - linkedom types are incompatible with DOM types but work at runtime
+const linkedom_1 = require("linkedom");
 /**
- * Browser-native DOM parsing.
- * Replaces JSDOM with native DOMParser for browser environments.
+ * DOM parsing adapter for browser environments.
+ * Uses linkedom for compatibility with both popup and service worker (background) contexts.
+ * DOMParser is not available in service workers, so we use linkedom which works everywhere.
  *
  * @internal
  */
@@ -16,8 +20,10 @@ class DomAdapter {
      * @returns The parsed Document
      */
     static parseHTML(html) {
-        const parser = new DOMParser();
-        return parser.parseFromString(html, 'text/html');
+        // Use linkedom for service worker compatibility
+        // linkedom works in all JS environments (popup, content script, service worker)
+        const { document } = (0, linkedom_1.parseHTML)(html);
+        return document;
     }
 }
 exports.DomAdapter = DomAdapter;

package/dist/browser/adapters/DomAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"DomAdapter.js","sourceRoot":"","sources":["../../../src/browser/adapters/DomAdapter.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAa,UAAU;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,IAAY;QAC5B,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAClD,CAAC;CACD;AAZD,gCAYC"}
+{"version":3,"file":"DomAdapter.js","sourceRoot":"","sources":["../../../src/browser/adapters/DomAdapter.ts"],"names":[],"mappings":";;;AAAA,6DAA6D;AAC7D,kFAAkF;AAClF,uCAA0D;AAE1D;;;;;;GAMG;AACH,MAAa,UAAU;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,IAAY;QAC5B,gDAAgD;QAChD,gFAAgF;QAChF,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAA,oBAAiB,EAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,QAA+B,CAAC;IACxC,CAAC;CACD;AAdD,gCAcC"}

package/dist/browser/browser/adapters/DomAdapter.d.ts

@@ -1,6 +1,7 @@
 /**
- * Browser-native DOM parsing.
- * Replaces JSDOM with native DOMParser for browser environments.
+ * DOM parsing adapter for browser environments.
+ * Uses linkedom for compatibility with both popup and service worker (background) contexts.
+ * DOMParser is not available in service workers, so we use linkedom which works everywhere.
  *
  * @internal
  */

package/dist/browser/browser/adapters/DomAdapter.js

@@ -1,6 +1,10 @@
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore - linkedom types are incompatible with DOM types but work at runtime
+import { parseHTML as linkedomParseHTML } from 'linkedom';
 /**
- * Browser-native DOM parsing.
- * Replaces JSDOM with native DOMParser for browser environments.
+ * DOM parsing adapter for browser environments.
+ * Uses linkedom for compatibility with both popup and service worker (background) contexts.
+ * DOMParser is not available in service workers, so we use linkedom which works everywhere.
  *
  * @internal
  */
@@ -13,8 +17,10 @@ export class DomAdapter {
      * @returns The parsed Document
      */
     static parseHTML(html) {
-        const parser = new DOMParser();
-        return parser.parseFromString(html, 'text/html');
+        // Use linkedom for service worker compatibility
+        // linkedom works in all JS environments (popup, content script, service worker)
+        const { document } = linkedomParseHTML(html);
+        return document;
     }
 }
 //# sourceMappingURL=DomAdapter.js.map

package/dist/browser/browser/adapters/DomAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"DomAdapter.js","sourceRoot":"","sources":["../../../../src/browser/adapters/DomAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,UAAU;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,IAAY;QAC5B,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAClD,CAAC;CACD"}
+{"version":3,"file":"DomAdapter.js","sourceRoot":"","sources":["../../../../src/browser/adapters/DomAdapter.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,kFAAkF;AAClF,OAAO,EAAE,SAAS,IAAI,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,OAAO,UAAU;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,IAAY;QAC5B,gDAAgD;QAChD,gFAAgF;QAChF,MAAM,EAAE,QAAQ,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,QAA+B,CAAC;IACxC,CAAC;CACD"}

package/examples/browser-extension/manifest.json

@@ -14,6 +14,10 @@
     "https://upload.twitter.com/*",
     "https://upload.x.com/*"
   ],
+  "background": {
+    "service_worker": "dist/background.js",
+    "type": "module"
+  },
   "action": {
     "default_popup": "popup.html",
     "default_title": "Rettiwt API Demo",

package/examples/browser-extension/src/background.ts

@@ -0,0 +1,151 @@
+/**
+ * Background service worker for Rettiwt Browser Extension
+ * Handles all API calls and communicates with popup via chrome.runtime messages
+ */
+
+import { RettiwtBrowser } from '../../../src/browser';
+import { Tweet } from '../../../src/models/data/Tweet';
+import { User } from '../../../src/models/data/User';
+
+// Global state
+let rettiwt: RettiwtBrowser | null = null;
+let currentUser: User | null = null;
+
+// Message types
+export type MessageType =
+	| { type: 'CHECK_LOGIN' }
+	| { type: 'INITIALIZE' }
+	| { type: 'GET_USER' }
+	| { type: 'GET_BOOKMARKS'; count?: number; cursor?: string }
+	| { type: 'SEARCH_TWEETS'; query: string; count?: number; cursor?: string };
+
+export type ResponseType =
+	| { success: true; data: unknown }
+	| { success: false; error: string };
+
+/**
+ * Initialize RettiwtBrowser instance
+ */
+async function ensureRettiwt(): Promise<RettiwtBrowser> {
+	if (!rettiwt) {
+		rettiwt = new RettiwtBrowser({ logging: true });
+	}
+	return rettiwt;
+}
+
+/**
+ * Handle incoming messages from popup
+ */
+chrome.runtime.onMessage.addListener(
+	(message: MessageType, _sender, sendResponse: (response: ResponseType) => void) => {
+		handleMessage(message)
+			.then((data) => sendResponse({ success: true, data }))
+			.catch((error) => {
+				console.error('Background error:', error);
+				sendResponse({
+					success: false,
+					error: error instanceof Error ? error.message : String(error),
+				});
+			});
+
+		// Return true to indicate we'll respond asynchronously
+		return true;
+	},
+);
+
+/**
+ * Process messages and return results
+ */
+async function handleMessage(message: MessageType): Promise<unknown> {
+	const api = await ensureRettiwt();
+
+	switch (message.type) {
+		case 'CHECK_LOGIN': {
+			const isLoggedIn = await api.isLoggedIn();
+			return { isLoggedIn };
+		}
+
+		case 'INITIALIZE': {
+			currentUser = await api.initialize();
+			return {
+				user: {
+					id: currentUser.id,
+					userName: currentUser.userName,
+					fullName: currentUser.fullName,
+					profileImage: currentUser.profileImage,
+					followersCount: currentUser.followersCount,
+					followingsCount: currentUser.followingsCount,
+				},
+			};
+		}
+
+		case 'GET_USER': {
+			if (!currentUser) {
+				throw new Error('Not initialized');
+			}
+			return {
+				user: {
+					id: currentUser.id,
+					userName: currentUser.userName,
+					fullName: currentUser.fullName,
+					profileImage: currentUser.profileImage,
+					followersCount: currentUser.followersCount,
+					followingsCount: currentUser.followingsCount,
+				},
+			};
+		}
+
+		case 'GET_BOOKMARKS': {
+			if (!api.isInitialized) {
+				throw new Error('Not initialized');
+			}
+			const bookmarks = await api.user.bookmarks(message.count ?? 20, message.cursor);
+			return {
+				list: bookmarks.list.map(serializeTweet),
+				next: bookmarks.next,
+			};
+		}
+
+		case 'SEARCH_TWEETS': {
+			if (!api.isInitialized) {
+				throw new Error('Not initialized');
+			}
+			const results = await api.tweet.search(
+				{ includeWords: [message.query] },
+				message.count ?? 20,
+				message.cursor,
+			);
+			return {
+				list: results.list.map(serializeTweet),
+				next: results.next,
+			};
+		}
+
+		default:
+			throw new Error(`Unknown message type: ${(message as { type: string }).type}`);
+	}
+}
+
+/**
+ * Serialize a Tweet object to a plain object for message passing
+ */
+function serializeTweet(tweet: Tweet): Record<string, unknown> {
+	return {
+		id: tweet.id,
+		fullText: tweet.fullText,
+		createdAt: tweet.createdAt,
+		likeCount: tweet.likeCount,
+		retweetCount: tweet.retweetCount,
+		replyCount: tweet.replyCount,
+		tweetBy: tweet.tweetBy
+			? {
+					id: tweet.tweetBy.id,
+					userName: tweet.tweetBy.userName,
+					fullName: tweet.tweetBy.fullName,
+					profileImage: tweet.tweetBy.profileImage,
+				}
+			: null,
+	};
+}
+
+console.log('Rettiwt background service worker loaded');

package/examples/browser-extension/src/popup.ts

@@ -1,4 +1,40 @@
-import { RettiwtBrowser, User, Tweet } from 'rettiwt-api/browser';
+/**
+ * Popup script for Rettiwt Browser Extension Demo
+ * Communicates with background service worker via chrome.runtime messages
+ */
+
+import type { MessageType, ResponseType } from './background';
+
+// Types for serialized data from background
+interface SerializedUser {
+	id: string;
+	userName: string;
+	fullName: string;
+	profileImage: string;
+	followersCount: number;
+	followingsCount: number;
+	statusesCount?: number;
+}
+
+interface SerializedTweet {
+	id: string;
+	fullText: string;
+	createdAt: string;
+	likeCount: number;
+	retweetCount: number;
+	replyCount: number;
+	tweetBy: {
+		id: string;
+		userName: string;
+		fullName: string;
+		profileImage: string;
+	} | null;
+}
+
+interface CursoredResponse<T> {
+	list: T[];
+	next: string;
+}
 
 // DOM Elements
 const statusEl = document.getElementById('status') as HTMLDivElement;
@@ -28,10 +64,10 @@ const contentListEl = document.getElementById('content-list') as HTMLDivElement;
 const loadMoreEl = document.getElementById('load-more') as HTMLDivElement;
 
 // Global state
-let rettiwt: RettiwtBrowser | null = null;
+let currentUser: SerializedUser | null = null;
 let currentTab: 'bookmarks' | 'search' = 'bookmarks';
-let bookmarks: Tweet[] = [];
-let searchResults: Tweet[] = [];
+let bookmarks: SerializedTweet[] = [];
+let searchResults: SerializedTweet[] = [];
 let bookmarksCursor: string | undefined;
 let searchCursor: string | undefined;
 let isLoading = false;
@@ -39,6 +75,25 @@ let hasMoreBookmarks = true;
 let hasMoreSearch = true;
 let currentSearchQuery = '';
 
+/**
+ * Send message to background service worker
+ */
+async function sendMessage<T>(message: MessageType): Promise<T> {
+	return new Promise((resolve, reject) => {
+		chrome.runtime.sendMessage(message, (response: ResponseType) => {
+			if (chrome.runtime.lastError) {
+				reject(new Error(chrome.runtime.lastError.message));
+				return;
+			}
+			if (response.success) {
+				resolve(response.data as T);
+			} else {
+				reject(new Error(response.error));
+			}
+		});
+	});
+}
+
 /**
  * Update status display
  */
@@ -67,7 +122,7 @@ function formatNumber(num: number): string {
 /**
  * Display user profile
  */
-function displayProfile(user: User) {
+function displayProfile(user: SerializedUser) {
 	profileAvatarEl.src = user.profileImage || '';
 	profileNameEl.textContent = user.fullName || 'Unknown';
 	profileUsernameEl.textContent = `@${user.userName || 'unknown'}`;
@@ -88,7 +143,7 @@ function escapeHtml(text: string): string {
 /**
  * Render a single tweet card
  */
-function renderTweetCard(tweet: Tweet): string {
+function renderTweetCard(tweet: SerializedTweet): string {
 	const author = tweet.tweetBy;
 	const avatarUrl = author?.profileImage || '';
 	const authorName = author?.fullName || 'Unknown';
@@ -135,34 +190,37 @@ function updateContentList() {
 	itemCountEl.textContent = items.length > 0 ? `${items.length} items` : '';
 
 	// Only hide load-more when there's definitely no more content
-	// The loading indicator is managed by the load functions
 	if (!hasMore && !isLoading) {
 		loadMoreEl.classList.add('hidden');
 	}
 }
 
 /**
- * Load more bookmarks
+ * Load more bookmarks via background script
  */
 async function loadMoreBookmarks() {
-	if (!rettiwt || isLoading || !hasMoreBookmarks) return;
+	if (isLoading || !hasMoreBookmarks) return;
 
 	isLoading = true;
 	loadMoreEl.classList.remove('hidden');
 
 	try {
-		const result = await rettiwt.user.bookmarks(20, bookmarksCursor);
+		const result = await sendMessage<CursoredResponse<SerializedTweet>>({
+			type: 'GET_BOOKMARKS',
+			count: 20,
+			cursor: bookmarksCursor,
+		});
 
 		if (!result.list || result.list.length === 0) {
 			hasMoreBookmarks = false;
 		} else {
 			bookmarks.push(...result.list);
-			bookmarksCursor = result.next;
+			bookmarksCursor = result.next || undefined;
 			hasMoreBookmarks = !!bookmarksCursor;
 		}
 	} catch (error) {
 		console.error('Error loading bookmarks:', error);
-		hasMoreBookmarks = false; // Stop trying on error
+		hasMoreBookmarks = false;
 	} finally {
 		isLoading = false;
 		loadMoreEl.classList.add('hidden');
@@ -171,37 +229,37 @@ async function loadMoreBookmarks() {
 }
 
 /**
- * Load more search results
+ * Load more search results via background script
  */
 async function loadMoreSearchResults() {
-	if (!rettiwt || isLoading || !hasMoreSearch || !currentSearchQuery) return;
+	if (isLoading || !hasMoreSearch || !currentSearchQuery) return;
 
 	isLoading = true;
 	loadMoreEl.classList.remove('hidden');
 
 	try {
 		console.log('Searching for:', currentSearchQuery, 'cursor:', searchCursor);
-		const result = await rettiwt.tweet.search(
-			{ includeWords: [currentSearchQuery] },
-			20,
-			searchCursor,
-		);
+		const result = await sendMessage<CursoredResponse<SerializedTweet>>({
+			type: 'SEARCH_TWEETS',
+			query: currentSearchQuery,
+			count: 20,
+			cursor: searchCursor,
+		});
 		console.log('Search result:', result);
 
 		if (!result.list || result.list.length === 0) {
 			hasMoreSearch = false;
 		} else {
 			searchResults.push(...result.list);
-			searchCursor = result.next;
+			searchCursor = result.next || undefined;
 			hasMoreSearch = !!searchCursor;
 		}
 	} catch (error) {
 		console.error('Error loading search results:', error);
-		// Show error to user
 		if (searchResults.length === 0) {
 			contentListEl.innerHTML = `<div class="empty-state">Search failed: ${error instanceof Error ? error.message : 'Unknown error'}</div>`;
 		}
-		hasMoreSearch = false; // Stop trying on error
+		hasMoreSearch = false;
 	} finally {
 		isLoading = false;
 		loadMoreEl.classList.add('hidden');
@@ -213,8 +271,6 @@ async function loadMoreSearchResults() {
  * Perform search
  */
 async function performSearch() {
-	if (!rettiwt) return;
-
 	const query = searchInputEl.value.trim();
 	if (!query) return;
 
@@ -270,7 +326,14 @@ function handleScroll() {
 
 	// Load more when scrolled near bottom (within 150px)
 	if (scrollTop + clientHeight >= scrollHeight - 150) {
-		console.log('Near bottom detected', { scrollTop, scrollHeight, clientHeight, isLoading, hasMoreBookmarks, hasMoreSearch });
+		console.log('Near bottom detected', {
+			scrollTop,
+			scrollHeight,
+			clientHeight,
+			isLoading,
+			hasMoreBookmarks,
+			hasMoreSearch,
+		});
 		if (currentTab === 'bookmarks' && !isLoading && hasMoreBookmarks) {
 			loadMoreBookmarks();
 		} else if (currentTab === 'search' && currentSearchQuery && !isLoading && hasMoreSearch) {
@@ -288,12 +351,10 @@ async function initialize() {
 	mainContentEl.classList.add('hidden');
 
 	try {
-		rettiwt = new RettiwtBrowser();
-
-		// Check if logged in (just checks cookies, no API call)
-		const isLoggedIn = await rettiwt.isLoggedIn();
+		// Check if logged in via background script
+		const loginResult = await sendMessage<{ isLoggedIn: boolean }>({ type: 'CHECK_LOGIN' });
 
-		if (!isLoggedIn) {
+		if (!loginResult.isLoggedIn) {
 			setStatus('Not logged in to X.com', 'error');
 			loginPromptEl.classList.remove('hidden');
 			return;
@@ -301,12 +362,13 @@ async function initialize() {
 
 		setStatus('Verifying credentials...', 'loading');
 
-		// Initialize and verify (fetches user profile)
-		const user = await rettiwt.initialize();
+		// Initialize and verify via background script
+		const initResult = await sendMessage<{ user: SerializedUser }>({ type: 'INITIALIZE' });
+		currentUser = initResult.user;
 
 		setStatus('Successfully connected!', 'success');
 		mainContentEl.classList.remove('hidden');
-		displayProfile(user);
+		displayProfile(currentUser);
 
 		// Auto-load bookmarks
 		await loadMoreBookmarks();

package/examples/browser-extension/webpack.config.js

@@ -4,6 +4,7 @@ const webpack = require('webpack');
 module.exports = {
   entry: {
     popup: './src/popup.ts',
+    background: './src/background.ts',
   },
   output: {
     path: path.resolve(__dirname, 'dist'),

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@youmind-openlab/rettiwt-api",
-	"version": "1.0.0",
+	"version": "1.0.1",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"description": "YouMind Open Lab fork - An API for fetching data from TwitterAPI, with browser extension support!",

package/src/browser/adapters/DomAdapter.ts

@@ -1,6 +1,11 @@
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore - linkedom types are incompatible with DOM types but work at runtime
+import { parseHTML as linkedomParseHTML } from 'linkedom';
+
 /**
- * Browser-native DOM parsing.
- * Replaces JSDOM with native DOMParser for browser environments.
+ * DOM parsing adapter for browser environments.
+ * Uses linkedom for compatibility with both popup and service worker (background) contexts.
+ * DOMParser is not available in service workers, so we use linkedom which works everywhere.
  *
  * @internal
  */
@@ -13,7 +18,9 @@ export class DomAdapter {
 	 * @returns The parsed Document
 	 */
 	static parseHTML(html: string): Document {
-		const parser = new DOMParser();
-		return parser.parseFromString(html, 'text/html');
+		// Use linkedom for service worker compatibility
+		// linkedom works in all JS environments (popup, content script, service worker)
+		const { document } = linkedomParseHTML(html);
+		return document as unknown as Document;
 	}
 }

package/tsconfig.browser.json

@@ -7,7 +7,8 @@
 		"moduleResolution": "bundler",
 		"module": "ES2022",
 		"declaration": true,
-		"declarationDir": "./dist/browser"
+		"declarationDir": "./dist/browser",
+		"skipLibCheck": true
 	},
 	"include": [
 		"src/browser/**/*",

package/tsconfig.json

@@ -69,7 +69,8 @@
 		// "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
 		// "forceConsistentCasingInFileNames": true,         /* Ensure that casing is correct in imports. */
 		/* Type Checking */
-		"strict": true /* Enable all strict type-checking options. */
+		"strict": true, /* Enable all strict type-checking options. */
+		"skipLibCheck": true /* Skip type checking all .d.ts files. */
 		// "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
 		// "strictNullChecks": true,                         /* When type checking, take into account 'null' and 'undefined'. */
 		// "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */