@youmind-openlab/rettiwt-api 1.0.0

package/dist/browser/browser/index.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Browser extension entry point for Rettiwt-API.
+ *
+ * This module exports browser-compatible classes that can be used directly in browser extensions.
+ * Cookies are automatically retrieved from the browser - 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');
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { RettiwtBrowser, IRettiwtBrowserConfig } from './RettiwtBrowser';
+export { BrowserCookieProvider, ICookieProvider } from './adapters/CookieProvider';
+export { Base64Adapter } from './adapters/Base64Adapter';
+export { DomAdapter } from './adapters/DomAdapter';
+export { BrowserRettiwtConfig, IBrowserRettiwtConfig, DefaultBrowserRettiwtHeaders } from './config/BrowserRettiwtConfig';
+export { BrowserFetcherService } from './services/BrowserFetcherService';
+export { BrowserAuthService, BrowserAuthCredential } from './services/BrowserAuthService';
+export { BrowserUserService } from './services/BrowserUserService';
+export { BrowserTweetService, BrowserMedia } from './services/BrowserTweetService';
+export { BrowserListService } from './services/BrowserListService';
+export { BrowserDirectMessageService } from './services/BrowserDirectMessageService';
+export { RawAnalyticsGranularity, RawAnalyticsMetric } from '../enums/raw/Analytics';
+export { RawMediaType } from '../enums/raw/Media';
+export { RawNotificationType } from '../enums/raw/Notification';
+export { AuthenticationType } from '../enums/Authentication';
+export { LogActions } from '../enums/Logging';
+export { MediaType } from '../enums/Media';
+export { NotificationType } from '../enums/Notification';
+export { ResourceType } from '../enums/Resource';
+export { TweetRepliesSortType } from '../enums/Tweet';
+export { Analytics } from '../models/data/Analytics';
+export { BookmarkFolder } from '../models/data/BookmarkFolder';
+export { Conversation } from '../models/data/Conversation';
+export { CursoredData } from '../models/data/CursoredData';
+export { DirectMessage } from '../models/data/DirectMessage';
+export { Inbox } from '../models/data/Inbox';
+export { List } from '../models/data/List';
+export { Notification } from '../models/data/Notification';
+export { Tweet } from '../models/data/Tweet';
+export { User } from '../models/data/User';
+export { TwitterError } from '../models/errors/TwitterError';
+export type { IFetchArgs, ITweetFilter } from '../types/args/FetchArgs';
+export type { IPostArgs, INewTweet } from '../types/args/PostArgs';
+export type { IProfileUpdateOptions } from '../types/args/ProfileArgs';
+export type { IAuthCookie } from '../types/auth/AuthCookie';
+export type { IAuthCredential } from '../types/auth/AuthCredential';
+export type { IErrorHandler } from '../types/ErrorHandler';
+import { RettiwtBrowser } from './RettiwtBrowser';
+import type { IRettiwtBrowserConfig } from './RettiwtBrowser';
+import { User } from '../models/data/User';
+/**
+ * Creates and initializes a RettiwtBrowser instance.
+ * This is a convenience function that creates a new instance and calls initialize().
+ *
+ * @param config - Optional configuration options.
+ * @returns A promise resolving to an object containing the initialized rettiwt instance and the user.
+ * @throws Error if not logged in or initialization fails.
+ *
+ * @example
+ * ```ts
+ * import { createRettiwtBrowser } from 'rettiwt-api/browser';
+ *
+ * const { rettiwt, user } = await createRettiwtBrowser();
+ * console.log(`Logged in as: ${user.userName}`);
+ *
+ * const tweet = await rettiwt.tweet.details('1234567890');
+ * ```
+ */
+export declare function createRettiwtBrowser(config?: IRettiwtBrowserConfig): Promise<{
+    rettiwt: RettiwtBrowser;
+    user: User;
+}>;

package/dist/browser/browser/index.js

@@ -0,0 +1,88 @@
+/**
+ * Browser extension entry point for Rettiwt-API.
+ *
+ * This module exports browser-compatible classes that can be used directly in browser extensions.
+ * Cookies are automatically retrieved from the browser - 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');
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Main class
+export { RettiwtBrowser } from './RettiwtBrowser';
+// Adapters
+export { BrowserCookieProvider } from './adapters/CookieProvider';
+export { Base64Adapter } from './adapters/Base64Adapter';
+export { DomAdapter } from './adapters/DomAdapter';
+// Config
+export { BrowserRettiwtConfig, DefaultBrowserRettiwtHeaders } from './config/BrowserRettiwtConfig';
+// Services
+export { BrowserFetcherService } from './services/BrowserFetcherService';
+export { BrowserAuthService, BrowserAuthCredential } from './services/BrowserAuthService';
+export { BrowserUserService } from './services/BrowserUserService';
+export { BrowserTweetService } from './services/BrowserTweetService';
+export { BrowserListService } from './services/BrowserListService';
+export { BrowserDirectMessageService } from './services/BrowserDirectMessageService';
+// Re-export enums (importing directly to avoid Node.js dependencies)
+export { RawAnalyticsGranularity, RawAnalyticsMetric } from '../enums/raw/Analytics';
+export { RawMediaType } from '../enums/raw/Media';
+export { RawNotificationType } from '../enums/raw/Notification';
+export { AuthenticationType } from '../enums/Authentication';
+export { LogActions } from '../enums/Logging';
+export { MediaType } from '../enums/Media';
+export { NotificationType } from '../enums/Notification';
+export { ResourceType } from '../enums/Resource';
+export { TweetRepliesSortType } from '../enums/Tweet';
+// Re-export models (importing directly to avoid Node.js dependencies)
+export { Analytics } from '../models/data/Analytics';
+export { BookmarkFolder } from '../models/data/BookmarkFolder';
+export { Conversation } from '../models/data/Conversation';
+export { CursoredData } from '../models/data/CursoredData';
+export { DirectMessage } from '../models/data/DirectMessage';
+export { Inbox } from '../models/data/Inbox';
+export { List } from '../models/data/List';
+export { Notification } from '../models/data/Notification';
+export { Tweet } from '../models/data/Tweet';
+export { User } from '../models/data/User';
+export { TwitterError } from '../models/errors/TwitterError';
+// Factory function for creating initialized RettiwtBrowser instance
+import { RettiwtBrowser } from './RettiwtBrowser';
+/**
+ * Creates and initializes a RettiwtBrowser instance.
+ * This is a convenience function that creates a new instance and calls initialize().
+ *
+ * @param config - Optional configuration options.
+ * @returns A promise resolving to an object containing the initialized rettiwt instance and the user.
+ * @throws Error if not logged in or initialization fails.
+ *
+ * @example
+ * ```ts
+ * import { createRettiwtBrowser } from 'rettiwt-api/browser';
+ *
+ * const { rettiwt, user } = await createRettiwtBrowser();
+ * console.log(`Logged in as: ${user.userName}`);
+ *
+ * const tweet = await rettiwt.tweet.details('1234567890');
+ * ```
+ */
+export async function createRettiwtBrowser(config) {
+    const rettiwt = new RettiwtBrowser(config);
+    const user = await rettiwt.initialize();
+    return { rettiwt, user };
+}
+//# sourceMappingURL=index.js.map

package/dist/browser/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,aAAa;AACb,OAAO,EAAE,cAAc,EAAyB,MAAM,kBAAkB,CAAC;AAEzE,WAAW;AACX,OAAO,EAAE,qBAAqB,EAAmB,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,SAAS;AACT,OAAO,EAAE,oBAAoB,EAAyB,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAE1H,WAAW;AACX,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAgB,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAErF,qEAAqE;AACrE,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,sEAAsE;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAU7D,oEAAoE;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,MAA8B;IAE9B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,77 @@
+import { AuthenticationType } from '../../enums/Authentication';
+import { IAuthCookie } from '../../types/auth/AuthCookie';
+import { IAuthCredential } from '../../types/auth/AuthCredential';
+import { BrowserRettiwtConfig } from '../config/BrowserRettiwtConfig';
+/**
+ * Browser-compatible AuthCredential that doesn't depend on cookiejar.
+ *
+ * @internal
+ */
+export declare class BrowserAuthCredential implements IAuthCredential {
+    authToken?: string;
+    authenticationType?: AuthenticationType;
+    cookies?: string;
+    csrfToken?: string;
+    guestToken?: string;
+    /**
+     * Creates a new BrowserAuthCredential from IAuthCookie.
+     *
+     * @param cookies - The authentication cookies from browser
+     * @param guestToken - Optional guest token for guest authentication
+     */
+    constructor(cookies?: IAuthCookie, guestToken?: string);
+    /**
+     * Converts the credentials to HTTP headers.
+     *
+     * @returns The headers object for axios requests
+     */
+    toHeader(): Record<string, string>;
+}
+/**
+ * Browser-compatible authentication service.
+ * Uses atob/btoa instead of Node.js Buffer.
+ *
+ * @internal
+ */
+export declare class BrowserAuthService {
+    /** The config object. */
+    private readonly _config;
+    /**
+     * @param config - The browser config for Rettiwt.
+     */
+    constructor(config: BrowserRettiwtConfig);
+    /**
+     * Decodes the encoded cookie string using browser-native atob.
+     *
+     * @param encodedCookies - The encoded cookie string to decode.
+     * @returns The decoded cookie string.
+     */
+    static decodeCookie(encodedCookies: string): string;
+    /**
+     * Encodes the given cookie string using browser-native btoa.
+     *
+     * @param cookieString - The cookie string to encode.
+     * @returns The encoded cookie string.
+     */
+    static encodeCookie(cookieString: string): string;
+    /**
+     * Gets the user's id from the given API key.
+     *
+     * @param apiKey - The API key (base64 encoded cookie string).
+     * @returns The user id associated with the API key.
+     */
+    static getUserId(apiKey: string): string | undefined;
+    /**
+     * Gets the user's id from the twid cookie value.
+     *
+     * @param twid - The twid cookie value.
+     * @returns The user id.
+     */
+    static getUserIdFromTwid(twid: string): string | undefined;
+    /**
+     * Login to twitter as guest.
+     *
+     * @returns A new guest credential.
+     */
+    guest(): Promise<BrowserAuthCredential>;
+}

package/dist/browser/browser/services/BrowserAuthService.js

@@ -0,0 +1,135 @@
+import axios from 'axios';
+import { AuthenticationType } from '../../enums/Authentication';
+import { Base64Adapter } from '../adapters/Base64Adapter';
+/**
+ * Browser-compatible AuthCredential that doesn't depend on cookiejar.
+ *
+ * @internal
+ */
+export class BrowserAuthCredential {
+    authToken;
+    authenticationType;
+    cookies;
+    csrfToken;
+    guestToken;
+    /**
+     * Creates a new BrowserAuthCredential from IAuthCookie.
+     *
+     * @param cookies - The authentication cookies from browser
+     * @param guestToken - Optional guest token for guest authentication
+     */
+    constructor(cookies, guestToken) {
+        this.authToken =
+            'AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA';
+        // If guest credentials given
+        if (!cookies && guestToken) {
+            this.guestToken = guestToken;
+            this.authenticationType = AuthenticationType.GUEST;
+        }
+        // If user credentials given
+        else if (cookies && !guestToken) {
+            this.cookies = `auth_token=${cookies.auth_token};ct0=${cookies.ct0};kdt=${cookies.kdt};twid=${cookies.twid}`;
+            this.csrfToken = cookies.ct0;
+            this.authenticationType = AuthenticationType.USER;
+        }
+        // If login credentials given (both cookies and guest token)
+        else if (cookies && guestToken) {
+            this.cookies = `auth_token=${cookies.auth_token};ct0=${cookies.ct0};kdt=${cookies.kdt};twid=${cookies.twid}`;
+            this.guestToken = guestToken;
+            this.authenticationType = AuthenticationType.LOGIN;
+        }
+    }
+    /**
+     * Converts the credentials to HTTP headers.
+     *
+     * @returns The headers object for axios requests
+     */
+    toHeader() {
+        const headers = {};
+        if (this.authToken) {
+            headers['authorization'] = `Bearer ${this.authToken}`;
+        }
+        if (this.guestToken) {
+            headers['x-guest-token'] = this.guestToken;
+        }
+        if (this.csrfToken) {
+            headers['x-csrf-token'] = this.csrfToken;
+        }
+        if (this.cookies) {
+            headers['cookie'] = this.cookies;
+        }
+        return headers;
+    }
+}
+/**
+ * Browser-compatible authentication service.
+ * Uses atob/btoa instead of Node.js Buffer.
+ *
+ * @internal
+ */
+export class BrowserAuthService {
+    /** The config object. */
+    _config;
+    /**
+     * @param config - The browser config for Rettiwt.
+     */
+    constructor(config) {
+        this._config = config;
+    }
+    /**
+     * Decodes the encoded cookie string using browser-native atob.
+     *
+     * @param encodedCookies - The encoded cookie string to decode.
+     * @returns The decoded cookie string.
+     */
+    static decodeCookie(encodedCookies) {
+        return Base64Adapter.decode(encodedCookies);
+    }
+    /**
+     * Encodes the given cookie string using browser-native btoa.
+     *
+     * @param cookieString - The cookie string to encode.
+     * @returns The encoded cookie string.
+     */
+    static encodeCookie(cookieString) {
+        return Base64Adapter.encode(cookieString);
+    }
+    /**
+     * Gets the user's id from the given API key.
+     *
+     * @param apiKey - The API key (base64 encoded cookie string).
+     * @returns The user id associated with the API key.
+     */
+    static getUserId(apiKey) {
+        const cookieString = BrowserAuthService.decodeCookie(apiKey);
+        const searchResults = cookieString.match(/((?<=twid="u=)(\d+)(?="))|((?<=twid=u%3D)(\d+)(?=;))/);
+        return searchResults ? searchResults[0] : undefined;
+    }
+    /**
+     * Gets the user's id from the twid cookie value.
+     *
+     * @param twid - The twid cookie value.
+     * @returns The user id.
+     */
+    static getUserIdFromTwid(twid) {
+        // twid format: "u=1234567890" or URL-encoded "u%3D1234567890"
+        const match = twid.match(/u[=%]3[dD]?(\d+)/);
+        return match ? match[1] : undefined;
+    }
+    /**
+     * Login to twitter as guest.
+     *
+     * @returns A new guest credential.
+     */
+    async guest() {
+        // Creating a new blank credential
+        const cred = new BrowserAuthCredential();
+        // Getting the guest token
+        const response = await axios.post('https://api.twitter.com/1.1/guest/activate.json', undefined, {
+            headers: cred.toHeader(),
+        });
+        cred.guestToken = response.data.guest_token;
+        return cred;
+    }
+}
+//# sourceMappingURL=BrowserAuthService.js.map

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

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

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

@@ -0,0 +1,37 @@
+import { Conversation } from '../../models/data/Conversation';
+import { Inbox } from '../../models/data/Inbox';
+import { BrowserFetcherService } from './BrowserFetcherService';
+import { BrowserRettiwtConfig } from '../config/BrowserRettiwtConfig';
+/**
+ * Browser-compatible direct message service.
+ * Handles interacting with resources related to direct messages.
+ *
+ * @public
+ */
+export declare class BrowserDirectMessageService extends BrowserFetcherService {
+    /**
+     * @param config - The browser config object for configuring the Rettiwt instance.
+     */
+    constructor(config: BrowserRettiwtConfig);
+    /**
+     * Get the full conversation history for a specific conversation.
+     *
+     * @param conversationId - The ID of the conversation.
+     * @param cursor - The cursor for pagination.
+     * @returns The conversation with full message history.
+     */
+    conversation(conversationId: string, cursor?: string): Promise<Conversation | undefined>;
+    /**
+     * Get the inbox with recent conversations.
+     *
+     * @returns The inbox containing conversations.
+     */
+    inbox(): Promise<Inbox | undefined>;
+    /**
+     * Get more conversations from the inbox timeline.
+     *
+     * @param cursor - The cursor for pagination.
+     * @returns The inbox timeline with more conversations.
+     */
+    inboxTimeline(cursor: string): Promise<Inbox | undefined>;
+}

package/dist/browser/browser/services/BrowserDirectMessageService.js

@@ -0,0 +1,59 @@
+import { Extractors } from '../../collections/Extractors';
+import { ResourceType } from '../../enums/Resource';
+import { BrowserFetcherService } from './BrowserFetcherService';
+/**
+ * Browser-compatible direct message service.
+ * Handles interacting with resources related to direct messages.
+ *
+ * @public
+ */
+export class BrowserDirectMessageService extends BrowserFetcherService {
+    /**
+     * @param config - The browser config object for configuring the Rettiwt instance.
+     */
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Get the full conversation history for a specific conversation.
+     *
+     * @param conversationId - The ID of the conversation.
+     * @param cursor - The cursor for pagination.
+     * @returns The conversation with full message history.
+     */
+    async conversation(conversationId, cursor) {
+        const resource = ResourceType.DM_CONVERSATION;
+        const response = await this.request(resource, {
+            id: conversationId,
+            cursor: cursor,
+        });
+        const data = Extractors[resource](response);
+        return data;
+    }
+    /**
+     * Get the inbox with recent conversations.
+     *
+     * @returns The inbox containing conversations.
+     */
+    async inbox() {
+        const resource = ResourceType.DM_INBOX_INITIAL_STATE;
+        const response = await this.request(resource, {});
+        const data = Extractors[resource](response);
+        return data;
+    }
+    /**
+     * Get more conversations from the inbox timeline.
+     *
+     * @param cursor - The cursor for pagination.
+     * @returns The inbox timeline with more conversations.
+     */
+    async inboxTimeline(cursor) {
+        const resource = ResourceType.DM_INBOX_TIMELINE;
+        const response = await this.request(resource, {
+            cursor: cursor,
+        });
+        const data = Extractors[resource](response);
+        return data;
+    }
+}
+//# sourceMappingURL=BrowserDirectMessageService.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserDirectMessageService.js","sourceRoot":"","sources":["../../../../src/browser/services/BrowserDirectMessageService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE;;;;;GAKG;AACH,MAAM,OAAO,2BAA4B,SAAQ,qBAAqB;IACrE;;OAEG;IACH,YAAmB,MAA4B;QAC9C,KAAK,CAAC,MAAM,CAAC,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,YAAY,CAAC,cAAsB,EAAE,MAAe;QAChE,MAAM,QAAQ,GAAG,YAAY,CAAC,eAAe,CAAC;QAE9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAgC,QAAQ,EAAE;YAC5E,EAAE,EAAE,cAAc;YAClB,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;;;;OAIG;IACI,KAAK,CAAC,KAAK;QACjB,MAAM,QAAQ,GAAG,YAAY,CAAC,sBAAsB,CAAC;QAErD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAwB,QAAQ,EAAE,EAAE,CAAC,CAAC;QAEzE,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;QAE5C,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,aAAa,CAAC,MAAc;QACxC,MAAM,QAAQ,GAAG,YAAY,CAAC,iBAAiB,CAAC;QAEhD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAyB,QAAQ,EAAE;YACrE,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/BrowserFetcherService.d.ts

@@ -0,0 +1,91 @@
+import { ResourceType } from '../../enums/Resource';
+import { IFetchArgs } from '../../types/args/FetchArgs';
+import { IPostArgs } from '../../types/args/PostArgs';
+import { IAuthCookie } from '../../types/auth/AuthCookie';
+import { ITransactionHeader } from '../../types/auth/TransactionHeader';
+import { BrowserRettiwtConfig } from '../config/BrowserRettiwtConfig';
+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 declare class BrowserFetcherService {
+    /** The AuthService instance to use. */
+    protected readonly _auth: BrowserAuthService;
+    /** The delay/delay function to use (ms). */
+    private readonly _delay?;
+    /** The service used to handle HTTP and API errors */
+    private readonly _errorHandler;
+    /** The max wait time for a response. */
+    private readonly _timeout;
+    /** The config object. */
+    protected readonly config: BrowserRettiwtConfig;
+    /** The authentication cookies. */
+    private _cookies?;
+    /**
+     * @param config - The browser config object for configuring the Rettiwt instance.
+     */
+    constructor(config: BrowserRettiwtConfig);
+    /**
+     * Sets the authentication cookies for this service.
+     *
+     * @param cookies - The authentication cookies
+     */
+    setCookies(cookies: IAuthCookie): void;
+    /**
+     * 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.
+     */
+    private _checkAuthorization;
+    /**
+     * Returns the AuthCredentials based on cookies or guest authentication.
+     *
+     * @returns The generated AuthCredential
+     */
+    protected _getCredential(): Promise<BrowserAuthCredential>;
+    /**
+     * 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.
+     */
+    protected _getTransactionHeader(method: string, url: string): Promise<ITransactionHeader>;
+    /**
+     * Handles X.com migration using native DOMParser instead of JSDOM.
+     *
+     * @returns The parsed Document
+     */
+    protected _handleXMigration(): Promise<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.
+     */
+    private _validateArgs;
+    /**
+     * Introduces a delay using the configured delay/delay function.
+     */
+    private _wait;
+    /**
+     * 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.
+     */
+    request<T = unknown>(resource: ResourceType, args: IFetchArgs | IPostArgs): Promise<T>;
+}