@youmind-openlab/rettiwt-api 1.0.0

package/dist/browser/RettiwtBrowser.d.ts

@@ -0,0 +1,138 @@
+import { User } from '../models/data/User';
+import { IAuthCookie } from '../types/auth/AuthCookie';
+import { ICookieProvider } from './adapters/CookieProvider';
+import { IBrowserRettiwtConfig } from './config/BrowserRettiwtConfig';
+import { BrowserDirectMessageService } from './services/BrowserDirectMessageService';
+import { BrowserListService } from './services/BrowserListService';
+import { BrowserTweetService } from './services/BrowserTweetService';
+import { BrowserUserService } from './services/BrowserUserService';
+/**
+ * Configuration options for RettiwtBrowser.
+ *
+ * @public
+ */
+export interface IRettiwtBrowserConfig extends IBrowserRettiwtConfig {
+    /**
+     * Custom cookie provider. If not provided, uses BrowserCookieProvider
+     * which gets cookies from chrome.cookies API.
+     */
+    cookieProvider?: ICookieProvider;
+}
+/**
+ * Browser extension-specific Rettiwt class.
+ * Automatically retrieves cookies from browser context - no need to pass authentication parameters.
+ *
+ * @example
+ * ```ts
+ * import { RettiwtBrowser } from 'rettiwt-api/browser';
+ *
+ * const rettiwt = new RettiwtBrowser();
+ *
+ * // Check if logged in
+ * if (await rettiwt.isLoggedIn()) {
+ *   // Initialize and verify
+ *   const user = await rettiwt.initialize();
+ *   console.log(`Logged in as: ${user.userName}`);
+ *
+ *   // Use the API
+ *   const tweet = await rettiwt.tweet.details('1234567890');
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare class RettiwtBrowser {
+    /** The configuration for Rettiwt. */
+    private _config;
+    /** The cookie provider for getting Twitter cookies. */
+    private _cookieProvider;
+    /** Whether the instance has been initialized. */
+    private _initialized;
+    /** The cached cookies. */
+    private _cookies?;
+    /** The instance used to fetch data related to direct messages. */
+    dm: BrowserDirectMessageService;
+    /** The instance used to fetch data related to lists. */
+    list: BrowserListService;
+    /** The instance used to fetch data related to tweets. */
+    tweet: BrowserTweetService;
+    /** The instance used to fetch data related to users. */
+    user: BrowserUserService;
+    /**
+     * Creates a new RettiwtBrowser instance.
+     *
+     * @param config - Optional configuration options.
+     */
+    constructor(config?: IRettiwtBrowserConfig);
+    /**
+     * Checks if the user is logged in to Twitter.
+     * This method only checks for the presence of required cookies - it does NOT make any API calls.
+     *
+     * @returns true if the required Twitter authentication cookies are present.
+     *
+     * @example
+     * ```ts
+     * const rettiwt = new RettiwtBrowser();
+     *
+     * if (await rettiwt.isLoggedIn()) {
+     *   console.log('User is logged in to Twitter');
+     * } else {
+     *   console.log('User is not logged in');
+     * }
+     * ```
+     */
+    isLoggedIn(): Promise<boolean>;
+    /**
+     * Initializes the library by getting cookies from the browser and verifying authentication.
+     * This method must be called before using other methods.
+     *
+     * The method:
+     * 1. Gets Twitter authentication cookies from the browser
+     * 2. Initializes the configuration with these cookies
+     * 3. Creates the service instances (dm, list, tweet, user)
+     * 4. Verifies authentication by fetching the current user's profile
+     *
+     * @returns The authenticated user's profile.
+     * @throws Error if not logged in to Twitter or if authentication verification fails.
+     *
+     * @example
+     * ```ts
+     * const rettiwt = new RettiwtBrowser();
+     *
+     * try {
+     *   const user = await rettiwt.initialize();
+     *   console.log(`Logged in as: ${user.userName}`);
+     * } catch (error) {
+     *   console.error('Failed to initialize:', error.message);
+     * }
+     * ```
+     */
+    initialize(): Promise<User>;
+    /**
+     * Alias for initialize() - verifies authentication and returns user profile.
+     *
+     * @returns The authenticated user's profile.
+     * @throws Error if not logged in or verification fails.
+     */
+    verify(): Promise<User>;
+    /**
+     * Whether the instance has been initialized.
+     */
+    get isInitialized(): boolean;
+    /**
+     * Gets the authenticated user's ID (extracted from twid cookie).
+     * Returns undefined if not initialized.
+     */
+    get userId(): string | undefined;
+    /**
+     * Gets the current authentication cookies.
+     * Returns undefined if not initialized.
+     */
+    get cookies(): IAuthCookie | undefined;
+    /**
+     * Sets custom headers for all API requests.
+     */
+    set headers(headers: {
+        [key: string]: string;
+    });
+}

package/dist/browser/RettiwtBrowser.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RettiwtBrowser = void 0;
+const CookieProvider_1 = require("./adapters/CookieProvider");
+const BrowserRettiwtConfig_1 = require("./config/BrowserRettiwtConfig");
+const BrowserDirectMessageService_1 = require("./services/BrowserDirectMessageService");
+const BrowserListService_1 = require("./services/BrowserListService");
+const BrowserTweetService_1 = require("./services/BrowserTweetService");
+const BrowserUserService_1 = require("./services/BrowserUserService");
+/**
+ * Browser extension-specific Rettiwt class.
+ * Automatically retrieves cookies from browser context - no need to pass authentication parameters.
+ *
+ * @example
+ * ```ts
+ * import { RettiwtBrowser } from 'rettiwt-api/browser';
+ *
+ * const rettiwt = new RettiwtBrowser();
+ *
+ * // Check if logged in
+ * if (await rettiwt.isLoggedIn()) {
+ *   // Initialize and verify
+ *   const user = await rettiwt.initialize();
+ *   console.log(`Logged in as: ${user.userName}`);
+ *
+ *   // Use the API
+ *   const tweet = await rettiwt.tweet.details('1234567890');
+ * }
+ * ```
+ *
+ * @public
+ */
+class RettiwtBrowser {
+    /** The configuration for Rettiwt. */
+    _config;
+    /** The cookie provider for getting Twitter cookies. */
+    _cookieProvider;
+    /** Whether the instance has been initialized. */
+    _initialized = false;
+    /** The cached cookies. */
+    _cookies;
+    /** The instance used to fetch data related to direct messages. */
+    dm;
+    /** The instance used to fetch data related to lists. */
+    list;
+    /** The instance used to fetch data related to tweets. */
+    tweet;
+    /** The instance used to fetch data related to users. */
+    user;
+    /**
+     * Creates a new RettiwtBrowser instance.
+     *
+     * @param config - Optional configuration options.
+     */
+    constructor(config) {
+        this._cookieProvider = config?.cookieProvider ?? new CookieProvider_1.BrowserCookieProvider();
+        this._config = new BrowserRettiwtConfig_1.BrowserRettiwtConfig(config);
+    }
+    /**
+     * Checks if the user is logged in to Twitter.
+     * This method only checks for the presence of required cookies - it does NOT make any API calls.
+     *
+     * @returns true if the required Twitter authentication cookies are present.
+     *
+     * @example
+     * ```ts
+     * const rettiwt = new RettiwtBrowser();
+     *
+     * if (await rettiwt.isLoggedIn()) {
+     *   console.log('User is logged in to Twitter');
+     * } else {
+     *   console.log('User is not logged in');
+     * }
+     * ```
+     */
+    async isLoggedIn() {
+        return this._cookieProvider.hasRequiredCookies();
+    }
+    /**
+     * Initializes the library by getting cookies from the browser and verifying authentication.
+     * This method must be called before using other methods.
+     *
+     * The method:
+     * 1. Gets Twitter authentication cookies from the browser
+     * 2. Initializes the configuration with these cookies
+     * 3. Creates the service instances (dm, list, tweet, user)
+     * 4. Verifies authentication by fetching the current user's profile
+     *
+     * @returns The authenticated user's profile.
+     * @throws Error if not logged in to Twitter or if authentication verification fails.
+     *
+     * @example
+     * ```ts
+     * const rettiwt = new RettiwtBrowser();
+     *
+     * try {
+     *   const user = await rettiwt.initialize();
+     *   console.log(`Logged in as: ${user.userName}`);
+     * } catch (error) {
+     *   console.error('Failed to initialize:', error.message);
+     * }
+     * ```
+     */
+    async initialize() {
+        // Get cookies from browser
+        const cookies = await this._cookieProvider.getCookies();
+        if (!cookies.auth_token || !cookies.ct0) {
+            throw new Error('Not logged in to Twitter. Please log in to Twitter first.');
+        }
+        // Store cookies
+        this._cookies = cookies;
+        // Initialize config with cookies
+        this._config.initializeWithCookies(cookies);
+        // Create service instances
+        this.dm = new BrowserDirectMessageService_1.BrowserDirectMessageService(this._config);
+        this.list = new BrowserListService_1.BrowserListService(this._config);
+        this.tweet = new BrowserTweetService_1.BrowserTweetService(this._config);
+        this.user = new BrowserUserService_1.BrowserUserService(this._config);
+        // Set cookies for each service
+        this.dm.setCookies(cookies);
+        this.list.setCookies(cookies);
+        this.tweet.setCookies(cookies);
+        this.user.setCookies(cookies);
+        // Verify by fetching user profile
+        const user = await this.user.details();
+        if (!user) {
+            throw new Error('Failed to verify authentication. Please try logging in to Twitter again.');
+        }
+        this._initialized = true;
+        return user;
+    }
+    /**
+     * Alias for initialize() - verifies authentication and returns user profile.
+     *
+     * @returns The authenticated user's profile.
+     * @throws Error if not logged in or verification fails.
+     */
+    async verify() {
+        return this.initialize();
+    }
+    /**
+     * Whether the instance has been initialized.
+     */
+    get isInitialized() {
+        return this._initialized;
+    }
+    /**
+     * Gets the authenticated user's ID (extracted from twid cookie).
+     * Returns undefined if not initialized.
+     */
+    get userId() {
+        return this._config.userId;
+    }
+    /**
+     * Gets the current authentication cookies.
+     * Returns undefined if not initialized.
+     */
+    get cookies() {
+        return this._cookies;
+    }
+    /**
+     * Sets custom headers for all API requests.
+     */
+    set headers(headers) {
+        this._config.headers = headers;
+    }
+}
+exports.RettiwtBrowser = RettiwtBrowser;
+//# sourceMappingURL=RettiwtBrowser.js.map

package/dist/browser/RettiwtBrowser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RettiwtBrowser.js","sourceRoot":"","sources":["../../src/browser/RettiwtBrowser.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,24 @@
+/**
+ * Browser-compatible base64 encoding/decoding.
+ * Replaces Node.js Buffer for base64 operations.
+ *
+ * @internal
+ */
+export declare class Base64Adapter {
+    /**
+     * Decodes a base64 string to ASCII.
+     * Equivalent to: Buffer.from(encoded, 'base64').toString('ascii')
+     *
+     * @param encoded - The base64 encoded string
+     * @returns The decoded ASCII string
+     */
+    static decode(encoded: string): string;
+    /**
+     * Encodes a string to base64.
+     * Equivalent to: Buffer.from(data).toString('base64')
+     *
+     * @param data - The string to encode
+     * @returns The base64 encoded string
+     */
+    static encode(data: string): string;
+}

package/dist/browser/adapters/Base64Adapter.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Base64Adapter = void 0;
+/**
+ * Browser-compatible base64 encoding/decoding.
+ * Replaces Node.js Buffer for base64 operations.
+ *
+ * @internal
+ */
+class Base64Adapter {
+    /**
+     * Decodes a base64 string to ASCII.
+     * Equivalent to: Buffer.from(encoded, 'base64').toString('ascii')
+     *
+     * @param encoded - The base64 encoded string
+     * @returns The decoded ASCII string
+     */
+    static decode(encoded) {
+        return atob(encoded);
+    }
+    /**
+     * Encodes a string to base64.
+     * Equivalent to: Buffer.from(data).toString('base64')
+     *
+     * @param data - The string to encode
+     * @returns The base64 encoded string
+     */
+    static encode(data) {
+        return btoa(data);
+    }
+}
+exports.Base64Adapter = Base64Adapter;
+//# sourceMappingURL=Base64Adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Base64Adapter.js","sourceRoot":"","sources":["../../../src/browser/adapters/Base64Adapter.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAa,aAAa;IACzB;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;CACD;AAtBD,sCAsBC"}

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

@@ -0,0 +1,42 @@
+import { IAuthCookie } from '../../types/auth/AuthCookie';
+/**
+ * Interface for cookie retrieval, allowing different implementations
+ * for browser extension vs other environments.
+ *
+ * @public
+ */
+export interface ICookieProvider {
+    /**
+     * Retrieves Twitter authentication cookies.
+     * @returns Promise resolving to cookies in the format expected by AuthCookie
+     */
+    getCookies(): Promise<IAuthCookie>;
+    /**
+     * Checks if required cookies exist for authentication.
+     * @returns Promise resolving to true if all required cookies are present
+     */
+    hasRequiredCookies(): Promise<boolean>;
+}
+/**
+ * Browser extension implementation using chrome.cookies API.
+ * Automatically retrieves Twitter cookies from the browser.
+ *
+ * @public
+ */
+export declare class BrowserCookieProvider implements ICookieProvider {
+    private readonly domain;
+    private readonly requiredCookieNames;
+    /**
+     * Retrieves Twitter authentication cookies from the browser.
+     * Requires the "cookies" permission in manifest.json.
+     *
+     * @returns The authentication cookies
+     */
+    getCookies(): Promise<IAuthCookie>;
+    /**
+     * Checks if the user is logged in by verifying required cookies exist.
+     *
+     * @returns true if all required cookies are present
+     */
+    hasRequiredCookies(): Promise<boolean>;
+}

package/dist/browser/adapters/CookieProvider.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserCookieProvider = void 0;
+/**
+ * Browser extension implementation using chrome.cookies API.
+ * Automatically retrieves Twitter cookies from the browser.
+ *
+ * @public
+ */
+class BrowserCookieProvider {
+    domain = '.x.com';
+    requiredCookieNames = ['auth_token', 'ct0', 'twid'];
+    /**
+     * Retrieves Twitter authentication cookies from the browser.
+     * Requires the "cookies" permission in manifest.json.
+     *
+     * @returns The authentication cookies
+     */
+    async getCookies() {
+        const cookies = await chrome.cookies.getAll({ domain: this.domain });
+        const result = {
+            auth_token: '',
+            ct0: '',
+            kdt: '',
+            twid: '',
+        };
+        for (const cookie of cookies) {
+            if (cookie.name === 'auth_token') {
+                result.auth_token = cookie.value;
+            }
+            else if (cookie.name === 'ct0') {
+                result.ct0 = cookie.value;
+            }
+            else if (cookie.name === 'kdt') {
+                result.kdt = cookie.value;
+            }
+            else if (cookie.name === 'twid') {
+                result.twid = cookie.value;
+            }
+        }
+        return result;
+    }
+    /**
+     * Checks if the user is logged in by verifying required cookies exist.
+     *
+     * @returns true if all required cookies are present
+     */
+    async hasRequiredCookies() {
+        const cookies = await this.getCookies();
+        return !!(cookies.auth_token && cookies.ct0 && cookies.twid);
+    }
+}
+exports.BrowserCookieProvider = BrowserCookieProvider;
+//# sourceMappingURL=CookieProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CookieProvider.js","sourceRoot":"","sources":["../../../src/browser/adapters/CookieProvider.ts"],"names":[],"mappings":";;;AAsBA;;;;;GAKG;AACH,MAAa,qBAAqB;IAChB,MAAM,GAAG,QAAQ,CAAC;IAClB,mBAAmB,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAErE;;;;;OAKG;IACH,KAAK,CAAC,UAAU;QACf,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAErE,MAAM,MAAM,GAAgB;YAC3B,UAAU,EAAE,EAAE;YACd,GAAG,EAAE,EAAE;YACP,GAAG,EAAE,EAAE;YACP,IAAI,EAAE,EAAE;SACR,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC9B,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAClC,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC;YAClC,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC;YAC3B,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC;YAC3B,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACnC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;YAC5B,CAAC;QACF,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,kBAAkB;QACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;CACD;AA5CD,sDA4CC"}

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

@@ -0,0 +1,16 @@
+/**
+ * Browser-native DOM parsing.
+ * Replaces JSDOM with native DOMParser for browser environments.
+ *
+ * @internal
+ */
+export declare class DomAdapter {
+    /**
+     * Parses an HTML string into a Document.
+     * Equivalent to: new JSDOM(html).window.document
+     *
+     * @param html - The HTML string to parse
+     * @returns The parsed Document
+     */
+    static parseHTML(html: string): Document;
+}

package/dist/browser/adapters/DomAdapter.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomAdapter = void 0;
+/**
+ * Browser-native DOM parsing.
+ * Replaces JSDOM with native DOMParser for browser environments.
+ *
+ * @internal
+ */
+class DomAdapter {
+    /**
+     * Parses an HTML string into a Document.
+     * Equivalent to: new JSDOM(html).window.document
+     *
+     * @param html - The HTML string to parse
+     * @returns The parsed Document
+     */
+    static parseHTML(html) {
+        const parser = new DOMParser();
+        return parser.parseFromString(html, 'text/html');
+    }
+}
+exports.DomAdapter = DomAdapter;
+//# sourceMappingURL=DomAdapter.js.map

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

@@ -0,0 +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"}

package/dist/browser/browser/RettiwtBrowser.d.ts

@@ -0,0 +1,138 @@
+import { User } from '../models/data/User';
+import { IAuthCookie } from '../types/auth/AuthCookie';
+import { ICookieProvider } from './adapters/CookieProvider';
+import { IBrowserRettiwtConfig } from './config/BrowserRettiwtConfig';
+import { BrowserDirectMessageService } from './services/BrowserDirectMessageService';
+import { BrowserListService } from './services/BrowserListService';
+import { BrowserTweetService } from './services/BrowserTweetService';
+import { BrowserUserService } from './services/BrowserUserService';
+/**
+ * Configuration options for RettiwtBrowser.
+ *
+ * @public
+ */
+export interface IRettiwtBrowserConfig extends IBrowserRettiwtConfig {
+    /**
+     * Custom cookie provider. If not provided, uses BrowserCookieProvider
+     * which gets cookies from chrome.cookies API.
+     */
+    cookieProvider?: ICookieProvider;
+}
+/**
+ * Browser extension-specific Rettiwt class.
+ * Automatically retrieves cookies from browser context - no need to pass authentication parameters.
+ *
+ * @example
+ * ```ts
+ * import { RettiwtBrowser } from 'rettiwt-api/browser';
+ *
+ * const rettiwt = new RettiwtBrowser();
+ *
+ * // Check if logged in
+ * if (await rettiwt.isLoggedIn()) {
+ *   // Initialize and verify
+ *   const user = await rettiwt.initialize();
+ *   console.log(`Logged in as: ${user.userName}`);
+ *
+ *   // Use the API
+ *   const tweet = await rettiwt.tweet.details('1234567890');
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare class RettiwtBrowser {
+    /** The configuration for Rettiwt. */
+    private _config;
+    /** The cookie provider for getting Twitter cookies. */
+    private _cookieProvider;
+    /** Whether the instance has been initialized. */
+    private _initialized;
+    /** The cached cookies. */
+    private _cookies?;
+    /** The instance used to fetch data related to direct messages. */
+    dm: BrowserDirectMessageService;
+    /** The instance used to fetch data related to lists. */
+    list: BrowserListService;
+    /** The instance used to fetch data related to tweets. */
+    tweet: BrowserTweetService;
+    /** The instance used to fetch data related to users. */
+    user: BrowserUserService;
+    /**
+     * Creates a new RettiwtBrowser instance.
+     *
+     * @param config - Optional configuration options.
+     */
+    constructor(config?: IRettiwtBrowserConfig);
+    /**
+     * Checks if the user is logged in to Twitter.
+     * This method only checks for the presence of required cookies - it does NOT make any API calls.
+     *
+     * @returns true if the required Twitter authentication cookies are present.
+     *
+     * @example
+     * ```ts
+     * const rettiwt = new RettiwtBrowser();
+     *
+     * if (await rettiwt.isLoggedIn()) {
+     *   console.log('User is logged in to Twitter');
+     * } else {
+     *   console.log('User is not logged in');
+     * }
+     * ```
+     */
+    isLoggedIn(): Promise<boolean>;
+    /**
+     * Initializes the library by getting cookies from the browser and verifying authentication.
+     * This method must be called before using other methods.
+     *
+     * The method:
+     * 1. Gets Twitter authentication cookies from the browser
+     * 2. Initializes the configuration with these cookies
+     * 3. Creates the service instances (dm, list, tweet, user)
+     * 4. Verifies authentication by fetching the current user's profile
+     *
+     * @returns The authenticated user's profile.
+     * @throws Error if not logged in to Twitter or if authentication verification fails.
+     *
+     * @example
+     * ```ts
+     * const rettiwt = new RettiwtBrowser();
+     *
+     * try {
+     *   const user = await rettiwt.initialize();
+     *   console.log(`Logged in as: ${user.userName}`);
+     * } catch (error) {
+     *   console.error('Failed to initialize:', error.message);
+     * }
+     * ```
+     */
+    initialize(): Promise<User>;
+    /**
+     * Alias for initialize() - verifies authentication and returns user profile.
+     *
+     * @returns The authenticated user's profile.
+     * @throws Error if not logged in or verification fails.
+     */
+    verify(): Promise<User>;
+    /**
+     * Whether the instance has been initialized.
+     */
+    get isInitialized(): boolean;
+    /**
+     * Gets the authenticated user's ID (extracted from twid cookie).
+     * Returns undefined if not initialized.
+     */
+    get userId(): string | undefined;
+    /**
+     * Gets the current authentication cookies.
+     * Returns undefined if not initialized.
+     */
+    get cookies(): IAuthCookie | undefined;
+    /**
+     * Sets custom headers for all API requests.
+     */
+    set headers(headers: {
+        [key: string]: string;
+    });
+}