@youmind-openlab/rettiwt-api 1.0.1 → 1.0.2

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

@@ -1,290 +0,0 @@
-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

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

@@ -1,59 +0,0 @@
-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

@@ -1,100 +0,0 @@
-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

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

@@ -1,139 +0,0 @@
-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>;
-}