@youmind-openlab/rettiwt-api 1.0.0

package/dist/browser/browser/services/BrowserFetcherService.js

@@ -0,0 +1,290 @@
+import axios, { isAxiosError } from 'axios';
+import { ClientTransaction } from 'x-client-transaction-id';
+import { AllowGuestAuthenticationGroup, FetchResourcesGroup, PostResourcesGroup } from '../../collections/Groups';
+import { Requests } from '../../collections/Requests';
+import { ApiErrors } from '../../enums/Api';
+import { LogActions } from '../../enums/Logging';
+import { FetchArgs } from '../../models/args/FetchArgs';
+import { PostArgs } from '../../models/args/PostArgs';
+import { TwitterError } from '../../models/errors/TwitterError';
+import { ErrorService } from '../../services/internal/ErrorService';
+import { LogService } from '../../services/internal/LogService';
+import { DomAdapter } from '../adapters/DomAdapter';
+import { BrowserAuthCredential, BrowserAuthService } from './BrowserAuthService';
+/**
+ * Browser-compatible fetcher service.
+ * Uses native DOMParser instead of JSDOM, and browser cookies instead of base64 encoded API key.
+ *
+ * @public
+ */
+export class BrowserFetcherService {
+    /** The AuthService instance to use. */
+    _auth;
+    /** The delay/delay function to use (ms). */
+    _delay;
+    /** The service used to handle HTTP and API errors */
+    _errorHandler;
+    /** The max wait time for a response. */
+    _timeout;
+    /** The config object. */
+    config;
+    /** The authentication cookies. */
+    _cookies;
+    /**
+     * @param config - The browser config object for configuring the Rettiwt instance.
+     */
+    constructor(config) {
+        LogService.enabled = config.logging ?? false;
+        this.config = config;
+        this._delay = config.delay;
+        this._errorHandler = config.errorHandler ?? new ErrorService();
+        this._timeout = config.timeout ?? 0;
+        this._auth = new BrowserAuthService(config);
+    }
+    /**
+     * Sets the authentication cookies for this service.
+     *
+     * @param cookies - The authentication cookies
+     */
+    setCookies(cookies) {
+        this._cookies = cookies;
+    }
+    /**
+     * Checks the authorization status based on the requested resource.
+     *
+     * @param resource - The requested resource.
+     *
+     * @throws An error if not authorized to access the requested resource.
+     */
+    _checkAuthorization(resource) {
+        // Logging
+        LogService.log(LogActions.AUTHORIZATION, { authenticated: this.config.userId != undefined });
+        // Checking authorization status
+        if (!AllowGuestAuthenticationGroup.includes(resource) && this.config.userId == undefined) {
+            throw new Error(ApiErrors.RESOURCE_NOT_ALLOWED);
+        }
+    }
+    /**
+     * Returns the AuthCredentials based on cookies or guest authentication.
+     *
+     * @returns The generated AuthCredential
+     */
+    async _getCredential() {
+        if (this._cookies && this._cookies.auth_token) {
+            // Logging
+            LogService.log(LogActions.GET, { target: 'USER_CREDENTIAL' });
+            return new BrowserAuthCredential(this._cookies);
+        }
+        else {
+            // Logging
+            LogService.log(LogActions.GET, { target: 'NEW_GUEST_CREDENTIAL' });
+            return this._auth.guest();
+        }
+    }
+    /**
+     * Generates the header for the transaction ID.
+     * Uses native DOMParser instead of JSDOM.
+     *
+     * @param method - The target method.
+     * @param url - The target URL.
+     *
+     * @returns The header containing the transaction ID.
+     */
+    async _getTransactionHeader(method, url) {
+        // Get the X homepage HTML document (using browser-native DOM)
+        const document = await this._handleXMigration();
+        // Create and initialize ClientTransaction instance
+        const transaction = await ClientTransaction.create(document);
+        // Getting the URL path excluding all params
+        const path = new URL(url).pathname.split('?')[0].trim();
+        // Generating the transaction ID
+        const tid = await transaction.generateTransactionId(method.toUpperCase(), path);
+        return {
+            /* eslint-disable @typescript-eslint/naming-convention */
+            'x-client-transaction-id': tid,
+            /* eslint-enable @typescript-eslint/naming-convention */
+        };
+    }
+    /**
+     * Handles X.com migration using native DOMParser instead of JSDOM.
+     *
+     * @returns The parsed Document
+     */
+    async _handleXMigration() {
+        // Fetch X.com homepage
+        const homePageResponse = await axios.get('https://x.com', {
+            headers: this.config.headers,
+        });
+        // Parse HTML using native DOMParser
+        let document = DomAdapter.parseHTML(homePageResponse.data);
+        // Check for migration redirection links
+        const migrationRedirectionRegex = new RegExp('(http(?:s)?://(?:www\\.)?(twitter|x){1}\\.com(/x)?/migrate([/?])?tok=[a-zA-Z0-9%\\-_]+)+', 'i');
+        const metaRefresh = document.querySelector("meta[http-equiv='refresh']");
+        const metaContent = metaRefresh ? metaRefresh.getAttribute('content') || '' : '';
+        const migrationRedirectionUrl = migrationRedirectionRegex.exec(metaContent) || migrationRedirectionRegex.exec(homePageResponse.data);
+        if (migrationRedirectionUrl) {
+            // Follow redirection URL
+            const redirectResponse = await axios.get(migrationRedirectionUrl[0]);
+            document = DomAdapter.parseHTML(redirectResponse.data);
+        }
+        // Handle migration form if present
+        const migrationForm = document.querySelector("form[name='f']") ||
+            document.querySelector("form[action='https://x.com/x/migrate']");
+        if (migrationForm) {
+            const url = migrationForm.getAttribute('action') || 'https://x.com/x/migrate';
+            const method = migrationForm.getAttribute('method') || 'POST';
+            // Collect form input fields
+            const requestPayload = new FormData();
+            const inputFields = migrationForm.querySelectorAll('input');
+            for (const element of Array.from(inputFields)) {
+                const name = element.getAttribute('name');
+                const value = element.getAttribute('value');
+                if (name && value) {
+                    requestPayload.append(name, value);
+                }
+            }
+            // Submit form using POST request
+            const formResponse = await axios.request({
+                method: method,
+                url: url,
+                data: requestPayload,
+                headers: {
+                    /* eslint-disable @typescript-eslint/naming-convention */
+                    'Content-Type': 'multipart/form-data',
+                    ...this.config.headers,
+                    /* eslint-enable @typescript-eslint/naming-convention */
+                },
+            });
+            document = DomAdapter.parseHTML(formResponse.data);
+        }
+        // Return final DOM document
+        return document;
+    }
+    /**
+     * Validates the given args against the given resource.
+     *
+     * @param resource - The resource against which validation is to be done.
+     * @param args - The args to be validated.
+     *
+     * @returns The validated args.
+     */
+    _validateArgs(resource, args) {
+        if (FetchResourcesGroup.includes(resource)) {
+            // Logging
+            LogService.log(LogActions.VALIDATE, { target: 'FETCH_ARGS' });
+            return new FetchArgs(args);
+        }
+        else if (PostResourcesGroup.includes(resource)) {
+            // Logging
+            LogService.log(LogActions.VALIDATE, { target: 'POST_ARGS' });
+            return new PostArgs(args);
+        }
+    }
+    /**
+     * Introduces a delay using the configured delay/delay function.
+     */
+    async _wait() {
+        // If no delay is set, skip
+        if (this._delay == undefined) {
+            return;
+        }
+        /** The delay (in ms) to use. */
+        let delay = 0;
+        // Getting the delay
+        if (this._delay && typeof this._delay == 'number') {
+            delay = this._delay;
+        }
+        else if (this._delay && typeof this._delay == 'function') {
+            delay = await this._delay();
+        }
+        // Awaiting for the delay time
+        await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+    /**
+     * Makes an HTTP request according to the given parameters.
+     *
+     * @param resource - The requested resource.
+     * @param config - The request configuration.
+     *
+     * @typeParam T - The type of the returned response data.
+     *
+     * @returns The raw data response received.
+     */
+    async request(resource, args) {
+        /** The current retry number. */
+        let retry = 0;
+        /** The error, if any. */
+        let error = undefined;
+        // Logging
+        LogService.log(LogActions.REQUEST, { resource: resource, args: args });
+        // Checking authorization for the requested resource
+        this._checkAuthorization(resource);
+        // Validating args
+        args = this._validateArgs(resource, args);
+        // Getting credentials from cookies
+        const cred = await this._getCredential();
+        // Getting request configuration
+        const config = Requests[resource](args);
+        // Setting additional request parameters
+        config.headers = {
+            ...config.headers,
+            ...cred.toHeader(),
+            ...this.config.headers,
+        };
+        // Browser doesn't use httpsAgent
+        config.timeout = this._timeout;
+        // Using retries for error 404
+        do {
+            // Sending the request
+            try {
+                // Getting and appending transaction information
+                config.headers = {
+                    ...(await this._getTransactionHeader(config.method ?? '', config.url ?? '')),
+                    ...config.headers,
+                };
+                // Introducing a delay
+                await this._wait();
+                // Getting the response body
+                const responseData = (await axios(config)).data;
+                // Check for Twitter API errors in response body
+                // Type guard to check if response contains errors
+                const potentialErrorResponse = responseData;
+                if (potentialErrorResponse.errors &&
+                    Array.isArray(potentialErrorResponse.errors) &&
+                    (potentialErrorResponse.data === undefined ||
+                        JSON.stringify(potentialErrorResponse.data) === JSON.stringify({}))) {
+                    // Throw TwitterError using existing error class
+                    const axiosError = {
+                        response: {
+                            data: { errors: potentialErrorResponse.errors },
+                            status: 200,
+                        },
+                        message: potentialErrorResponse.errors[0]?.message ?? 'Twitter API Error',
+                        status: 200,
+                    };
+                    throw new TwitterError(axiosError);
+                }
+                // Returning the reponse body
+                return responseData;
+            }
+            catch (err) {
+                // If it's an error 404, retry
+                if (isAxiosError(err) && err.status === 404) {
+                    error = err;
+                    continue;
+                }
+                // Else, delegate error handling
+                else {
+                    this._errorHandler.handle(err);
+                }
+            }
+            finally {
+                // Incrementing the number of retries done
+                retry++;
+            }
+        } while (retry < this.config.maxRetries);
+        /** If request not successful even after retries, throw the error */
+        throw error;
+    }
+}
+//# sourceMappingURL=BrowserFetcherService.js.map

package/dist/browser/browser/services/BrowserFetcherService.js.map

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

package/dist/browser/browser/services/BrowserListService.d.ts

@@ -0,0 +1,59 @@
+import { CursoredData } from '../../models/data/CursoredData';
+import { List } from '../../models/data/List';
+import { Tweet } from '../../models/data/Tweet';
+import { User } from '../../models/data/User';
+import { BrowserFetcherService } from './BrowserFetcherService';
+import { BrowserRettiwtConfig } from '../config/BrowserRettiwtConfig';
+/**
+ * Browser-compatible list service.
+ * Handles interacting with resources related to lists.
+ *
+ * @public
+ */
+export declare class BrowserListService extends BrowserFetcherService {
+    /**
+     * @param config - The browser config object for configuring the Rettiwt instance.
+     */
+    constructor(config: BrowserRettiwtConfig);
+    /**
+     * Add a user as a member of a list.
+     *
+     * @param listId - The ID of the target list.
+     * @param userId - The ID of the target user to be added as a member.
+     * @returns The new member count of the list. If adding was unsuccessful, return `undefined`.
+     */
+    addMember(listId: string, userId: string): Promise<number | undefined>;
+    /**
+     * Get the details of a list.
+     *
+     * @param id - The ID of the target list.
+     * @returns The details of the list.
+     */
+    details(id: string): Promise<List | undefined>;
+    /**
+     * Get the members of a list.
+     *
+     * @param id - The ID of the target list.
+     * @param count - The number of members to fetch, must be <= 100.
+     * @param cursor - The cursor to the batch of members to fetch.
+     * @returns The list of members of the target list.
+     */
+    members(id: string, count?: number, cursor?: string): Promise<CursoredData<User>>;
+    /**
+     * Remove a user from a list.
+     *
+     * @param listId - The ID of the target list.
+     * @param userId - The ID of the target user to be removed.
+     * @returns The new member count of the list. If removal was unsuccessful, return `undefined`.
+     */
+    removeMember(listId: string, userId: string): Promise<number | undefined>;
+    /**
+     * Get the tweets from a list.
+     *
+     * @param id - The ID of the target list.
+     * @param count - The number of tweets to fetch, must be <= 100.
+     * @param cursor - The cursor to the batch of tweets to fetch.
+     * @returns The list of tweets from the target list.
+     */
+    tweets(id: string, count?: number, cursor?: string): Promise<CursoredData<Tweet>>;
+}

package/dist/browser/browser/services/BrowserListService.js

@@ -0,0 +1,100 @@
+import { Extractors } from '../../collections/Extractors';
+import { ResourceType } from '../../enums/Resource';
+import { BrowserFetcherService } from './BrowserFetcherService';
+/**
+ * Browser-compatible list service.
+ * Handles interacting with resources related to lists.
+ *
+ * @public
+ */
+export class BrowserListService extends BrowserFetcherService {
+    /**
+     * @param config - The browser config object for configuring the Rettiwt instance.
+     */
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Add a user as a member of a list.
+     *
+     * @param listId - The ID of the target list.
+     * @param userId - The ID of the target user to be added as a member.
+     * @returns The new member count of the list. If adding was unsuccessful, return `undefined`.
+     */
+    async addMember(listId, userId) {
+        const resource = ResourceType.LIST_MEMBER_ADD;
+        const response = await this.request(resource, {
+            id: listId,
+            userId: userId,
+        });
+        const data = Extractors[resource](response);
+        return data;
+    }
+    /**
+     * Get the details of a list.
+     *
+     * @param id - The ID of the target list.
+     * @returns The details of the list.
+     */
+    async details(id) {
+        const resource = ResourceType.LIST_DETAILS;
+        const response = await this.request(resource, {
+            id: id,
+        });
+        const data = Extractors[resource](response, id);
+        return data;
+    }
+    /**
+     * Get the members of a list.
+     *
+     * @param id - The ID of the target list.
+     * @param count - The number of members to fetch, must be <= 100.
+     * @param cursor - The cursor to the batch of members to fetch.
+     * @returns The list of members of the target list.
+     */
+    async members(id, count, cursor) {
+        const resource = ResourceType.LIST_MEMBERS;
+        const response = await this.request(resource, {
+            id: id,
+            count: count,
+            cursor: cursor,
+        });
+        const data = Extractors[resource](response);
+        return data;
+    }
+    /**
+     * Remove a user from a list.
+     *
+     * @param listId - The ID of the target list.
+     * @param userId - The ID of the target user to be removed.
+     * @returns The new member count of the list. If removal was unsuccessful, return `undefined`.
+     */
+    async removeMember(listId, userId) {
+        const resource = ResourceType.LIST_MEMBER_REMOVE;
+        const response = await this.request(resource, {
+            id: listId,
+            userId: userId,
+        });
+        const data = Extractors[resource](response);
+        return data;
+    }
+    /**
+     * Get the tweets from a list.
+     *
+     * @param id - The ID of the target list.
+     * @param count - The number of tweets to fetch, must be <= 100.
+     * @param cursor - The cursor to the batch of tweets to fetch.
+     * @returns The list of tweets from the target list.
+     */
+    async tweets(id, count, cursor) {
+        const resource = ResourceType.LIST_TWEETS;
+        const response = await this.request(resource, {
+            id: id,
+            count: count,
+            cursor: cursor,
+        });
+        const data = Extractors[resource](response);
+        return data;
+    }
+}
+//# sourceMappingURL=BrowserListService.js.map

package/dist/browser/browser/services/BrowserListService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserListService.js","sourceRoot":"","sources":["../../../../src/browser/services/BrowserListService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAWpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE;;;;;GAKG;AACH,MAAM,OAAO,kBAAmB,SAAQ,qBAAqB;IAC5D;;OAEG;IACH,YAAmB,MAA4B;QAC9C,KAAK,CAAC,MAAM,CAAC,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,MAAc;QACpD,MAAM,QAAQ,GAAG,YAAY,CAAC,eAAe,CAAC;QAE9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAyB,QAAQ,EAAE;YACrE,EAAE,EAAE,MAAM;YACV,MAAM,EAAE,MAAM;SACd,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;QAE5C,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,OAAO,CAAC,EAAU;QAC9B,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC;QAE3C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAuB,QAAQ,EAAE;YACnE,EAAE,EAAE,EAAE;SACN,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAEhD,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,KAAc,EAAE,MAAe;QAC/D,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC;QAE3C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAuB,QAAQ,EAAE;YACnE,EAAE,EAAE,EAAE;YACN,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,MAAM;SACd,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;QAE5C,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,MAAc;QACvD,MAAM,QAAQ,GAAG,YAAY,CAAC,kBAAkB,CAAC;QAEjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAA4B,QAAQ,EAAE;YACxE,EAAE,EAAE,MAAM;YACV,MAAM,EAAE,MAAM;SACd,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;QAE5C,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,KAAc,EAAE,MAAe;QAC9D,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,CAAC;QAE1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAsB,QAAQ,EAAE;YAClE,EAAE,EAAE,EAAE;YACN,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,MAAM;SACd,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;QAE5C,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/dist/browser/browser/services/BrowserTweetService.d.ts

@@ -0,0 +1,139 @@
+import { TweetRepliesSortType } from '../../enums/Tweet';
+import { CursoredData } from '../../models/data/CursoredData';
+import { Tweet } from '../../models/data/Tweet';
+import { User } from '../../models/data/User';
+import { ITweetFilter } from '../../types/args/FetchArgs';
+import { INewTweet } from '../../types/args/PostArgs';
+import { BrowserFetcherService } from './BrowserFetcherService';
+import { BrowserRettiwtConfig } from '../config/BrowserRettiwtConfig';
+/**
+ * Browser media type - accepts Blob, File, or ArrayBuffer.
+ */
+export type BrowserMedia = Blob | File | ArrayBuffer;
+/**
+ * Browser-compatible tweet service.
+ * Handles interacting with resources related to tweets.
+ * Uses Blob/File API instead of fs for media uploads.
+ *
+ * @public
+ */
+export declare class BrowserTweetService extends BrowserFetcherService {
+    /**
+     * @param config - The browser config object for configuring the Rettiwt instance.
+     */
+    constructor(config: BrowserRettiwtConfig);
+    /**
+     * Bookmark a tweet.
+     *
+     * @param id - The ID of the tweet to be bookmarked.
+     * @returns Whether bookmarking was successful or not.
+     */
+    bookmark(id: string): Promise<boolean>;
+    /**
+     * Get the details of a tweet.
+     *
+     * @param id - The ID of the target tweet.
+     * @returns The details of the tweet with the given ID.
+     */
+    details(id: string): Promise<Tweet | undefined>;
+    /**
+     * Get the details of multiple tweets.
+     *
+     * @param ids - The IDs of the target tweets.
+     * @returns The list of tweet details.
+     */
+    details(ids: string[]): Promise<Tweet[]>;
+    /**
+     * Like a tweet.
+     *
+     * @param id - The ID of the tweet to be liked.
+     * @returns Whether liking was successful or not.
+     */
+    like(id: string): Promise<boolean>;
+    /**
+     * Get the list of users who liked a tweet.
+     *
+     * @param id - The ID of the target tweet.
+     * @param count - The number of likers to fetch, must be <= 100.
+     * @param cursor - The cursor to the batch of likers to fetch.
+     * @returns The list of users who liked the target tweet.
+     */
+    likers(id: string, count?: number, cursor?: string): Promise<CursoredData<User>>;
+    /**
+     * Post a new tweet.
+     *
+     * @param tweet - The tweet to be posted.
+     * @returns The ID of the posted tweet, or undefined if posting failed.
+     */
+    post(tweet: INewTweet): Promise<string | undefined>;
+    /**
+     * Get the replies to a tweet.
+     *
+     * @param id - The ID of the target tweet.
+     * @param cursor - The cursor to the batch of replies to fetch.
+     * @param sortBy - The type of sorting for the replies.
+     * @returns The list of replies to the target tweet.
+     */
+    replies(id: string, cursor?: string, sortBy?: TweetRepliesSortType): Promise<CursoredData<Tweet>>;
+    /**
+     * Retweet a tweet.
+     *
+     * @param id - The ID of the tweet to be retweeted.
+     * @returns Whether retweeting was successful or not.
+     */
+    retweet(id: string): Promise<boolean>;
+    /**
+     * Get the list of users who retweeted a tweet.
+     *
+     * @param id - The ID of the target tweet.
+     * @param count - The number of retweeters to fetch, must be <= 100.
+     * @param cursor - The cursor to the batch of retweeters to fetch.
+     * @returns The list of users who retweeted the target tweet.
+     */
+    retweeters(id: string, count?: number, cursor?: string): Promise<CursoredData<User>>;
+    /**
+     * Search for tweets.
+     *
+     * @param filter - The filter for searching tweets.
+     * @param count - The number of tweets to fetch, must be <= 100.
+     * @param cursor - The cursor to the batch of tweets to fetch.
+     * @returns The list of tweets matching the given filter.
+     */
+    search(filter: ITweetFilter, count?: number, cursor?: string): Promise<CursoredData<Tweet>>;
+    /**
+     * Unbookmark a tweet.
+     *
+     * @param id - The ID of the tweet to be unbookmarked.
+     * @returns Whether unbookmarking was successful or not.
+     */
+    unbookmark(id: string): Promise<boolean>;
+    /**
+     * Unlike a tweet.
+     *
+     * @param id - The ID of the tweet to be unliked.
+     * @returns Whether unliking was successful or not.
+     */
+    unlike(id: string): Promise<boolean>;
+    /**
+     * Unpost (delete) a tweet.
+     *
+     * @param id - The ID of the tweet to be unposted.
+     * @returns Whether unposting was successful or not.
+     */
+    unpost(id: string): Promise<boolean>;
+    /**
+     * Unretweet a tweet.
+     *
+     * @param id - The ID of the tweet to be unretweeted.
+     * @returns Whether unretweeting was successful or not.
+     */
+    unretweet(id: string): Promise<boolean>;
+    /**
+     * Upload media for use in tweets.
+     * Uses browser-native Blob/File API instead of fs.
+     *
+     * @param media - The media to upload (Blob, File, or ArrayBuffer).
+     * @returns The media ID string for use in tweet posts.
+     */
+    upload(media: BrowserMedia): Promise<string>;
+}