@elizaos/plugin-xai 2.0.0-alpha.1

package/dist/client/client.d.ts

@@ -0,0 +1,462 @@
+import type { TTweetv2Expansion, TTweetv2MediaField, TTweetv2PlaceField, TTweetv2PollField, TTweetv2TweetField, TTweetv2UserField } from "twitter-api-v2";
+type TPostv2Expansion = TTweetv2Expansion;
+type TPostv2MediaField = TTweetv2MediaField;
+type TPostv2PlaceField = TTweetv2PlaceField;
+type TPostv2PollField = TTweetv2PollField;
+type TPostv2PostField = TTweetv2TweetField;
+type TPostv2UserField = TTweetv2UserField;
+import type { FetchTransformOptions } from "./api-types";
+import { XAuth } from "./auth";
+import type { XAuthProvider } from "./auth-providers/types";
+import { type PollData, type Post, type PostQuery, type Reposter } from "./posts";
+import { type Profile } from "./profile";
+import { SearchMode } from "./search";
+import type { QueryPostsResponse, QueryProfilesResponse } from "./types";
+/**
+ * An alternative fetch function to use instead of the default fetch function. This may be useful
+ * in nonstandard runtime environments, such as edge workers.
+ *
+ * @param {typeof fetch} fetch - The fetch function to use.
+ *
+ * @param {Partial<FetchTransformOptions>} transform - Additional options that control how requests
+ * and responses are processed. This can be used to proxy requests through other hosts, for example.
+ */
+export interface ClientOptions {
+    /**
+     * An alternative fetch function to use instead of the default fetch function. This may be useful
+     * in nonstandard runtime environments, such as edge workers.
+     */
+    fetch: typeof fetch;
+    /**
+     * Additional options that control how requests and responses are processed. This can be used to
+     * proxy requests through other hosts, for example.
+     */
+    transform: Partial<FetchTransformOptions>;
+}
+/**
+ * An interface to X's API v2.
+ * - Reusing Client objects is recommended to minimize the time spent authenticating unnecessarily.
+ */
+export declare class Client {
+    readonly _options?: Partial<ClientOptions> | undefined;
+    private auth?;
+    /**
+     * Creates a new Client object.
+     * - Reusing Client objects is recommended to minimize the time spent authenticating unnecessarily.
+     */
+    constructor(_options?: Partial<ClientOptions> | undefined);
+    /**
+     * Fetches an X profile.
+     * @param username The X username of the profile to fetch, without an `@` at the beginning.
+     * @returns The requested {@link Profile}.
+     */
+    getProfile(username: string): Promise<Profile>;
+    /**
+     * Fetches the user ID corresponding to the provided screen name.
+     * @param screenName The X screen name of the profile to fetch.
+     * @returns The ID of the corresponding account.
+     */
+    getEntityIdByScreenName(screenName: string): Promise<string>;
+    /**
+     *
+     * @param userId The user ID of the profile to fetch.
+     * @returns The screen name of the corresponding account.
+     */
+    getScreenNameByUserId(userId: string): Promise<string>;
+    /**
+     * Fetches posts from X.
+     * @param query The search query. Any X-compatible query format can be used.
+     * @param maxPosts The maximum number of posts to return.
+     * @param includeReplies Whether or not replies should be included in the response.
+     * @param searchMode The category filter to apply to the search. Defaults to `Top`.
+     * @returns An {@link AsyncGenerator} of posts matching the provided filters.
+     */
+    searchPosts(query: string, maxPosts: number, searchMode?: SearchMode): AsyncGenerator<Post, void>;
+    /**
+     * Fetches profiles from X.
+     * @param query The search query. Any X-compatible query format can be used.
+     * @param maxProfiles The maximum number of profiles to return.
+     * @returns An {@link AsyncGenerator} of profiles matching the provided filter(s).
+     */
+    searchProfiles(query: string, maxProfiles: number): AsyncGenerator<Profile, void>;
+    /**
+     * Fetches posts from X.
+     * @param query The search query. Any X-compatible query format can be used.
+     * @param maxPosts The maximum number of posts to return.
+     * @param includeReplies Whether or not replies should be included in the response.
+     * @param searchMode The category filter to apply to the search. Defaults to `Top`.
+     * @param cursor The search cursor, which can be passed into further requests for more results.
+     * @returns A page of results, containing a cursor that can be used in further requests.
+     */
+    fetchSearchPosts(query: string, maxPosts: number, searchMode: SearchMode, _cursor?: string): Promise<QueryPostsResponse>;
+    /**
+     * Fetches profiles from X.
+     * @param query The search query. Any X-compatible query format can be used.
+     * @param maxProfiles The maximum number of profiles to return.
+     * @param cursor The search cursor, which can be passed into further requests for more results.
+     * @returns A page of results, containing a cursor that can be used in further requests.
+     */
+    fetchSearchProfiles(query: string, maxProfiles: number, _cursor?: string): Promise<QueryProfilesResponse>;
+    /**
+     * Fetches list posts from X.
+     * @param listId The list id
+     * @param maxPosts The maximum number of posts to return.
+     * @param cursor The search cursor, which can be passed into further requests for more results.
+     * @returns A page of results, containing a cursor that can be used in further requests.
+     */
+    fetchListPosts(listId: string, maxPosts: number, cursor?: string): Promise<QueryPostsResponse>;
+    /**
+     * Fetch the profiles a user is following
+     * @param userId The user whose following should be returned
+     * @param maxProfiles The maximum number of profiles to return.
+     * @returns An {@link AsyncGenerator} of following profiles for the provided user.
+     */
+    getFollowing(userId: string, maxProfiles: number): AsyncGenerator<Profile, void>;
+    /**
+     * Fetch the profiles that follow a user
+     * @param userId The user whose followers should be returned
+     * @param maxProfiles The maximum number of profiles to return.
+     * @returns An {@link AsyncGenerator} of profiles following the provided user.
+     */
+    getFollowers(userId: string, maxProfiles: number): AsyncGenerator<Profile, void>;
+    /**
+     * Fetches following profiles from X.
+     * @param userId The user whose following should be returned
+     * @param maxProfiles The maximum number of profiles to return.
+     * @param cursor The search cursor, which can be passed into further requests for more results.
+     * @returns A page of results, containing a cursor that can be used in further requests.
+     */
+    fetchProfileFollowing(userId: string, maxProfiles: number, cursor?: string): Promise<QueryProfilesResponse>;
+    /**
+     * Fetches profile followers from X.
+     * @param userId The user whose following should be returned
+     * @param maxProfiles The maximum number of profiles to return.
+     * @param cursor The search cursor, which can be passed into further requests for more results.
+     * @returns A page of results, containing a cursor that can be used in further requests.
+     */
+    fetchProfileFollowers(userId: string, maxProfiles: number, cursor?: string): Promise<QueryProfilesResponse>;
+    /**
+     * Fetches the home timeline for the current user using X API v2.
+     * X API v2 returns a combined feed (no separate "For You" vs "Following").
+     * @param count The number of posts to fetch.
+     * @param seenPostIds An array of post IDs that have already been seen (not used in v2).
+     * @returns A promise that resolves to an array of posts.
+     */
+    fetchHomeTimeline(count: number, _seenPostIds: string[]): Promise<Post[]>;
+    /**
+     * Fetches the home timeline for the current user (same as fetchHomeTimeline in v2).
+     * X API v2 doesn't provide separate "Following" timeline endpoint.
+     * @param count The number of posts to fetch.
+     * @param seenPostIds An array of post IDs that have already been seen (not used in v2).
+     * @returns A promise that resolves to an array of posts.
+     */
+    fetchFollowingTimeline(count: number, seenPostIds: string[]): Promise<Post[]>;
+    getUserPosts(userId: string, maxPosts?: number, cursor?: string): Promise<{
+        posts: Post[];
+        next?: string;
+    }>;
+    getUserPostsIterator(userId: string, maxPosts?: number): AsyncGenerator<Post, void>;
+    /**
+     * Fetches the current trends from X.
+     * @returns The current list of trends.
+     */
+    getTrends(): Promise<string[]>;
+    /**
+     * Fetches posts from an X user.
+     * @param user The user whose posts should be returned.
+     * @param maxPosts The maximum number of posts to return. Defaults to `200`.
+     * @returns An {@link AsyncGenerator} of posts from the provided user.
+     */
+    getPosts(user: string, maxPosts?: number): AsyncGenerator<Post>;
+    /**
+     * Fetches posts from an X user using their ID.
+     * @param userId The user whose posts should be returned.
+     * @param maxPosts The maximum number of posts to return. Defaults to `200`.
+     * @returns An {@link AsyncGenerator} of posts from the provided user.
+     */
+    getPostsByUserId(userId: string, maxPosts?: number): AsyncGenerator<Post, void>;
+    /**
+     * Send a post
+     * @param text The text of the post
+     * @param postId The id of the post to reply to
+     * @param mediaData Optional media data
+     * @returns
+     */
+    sendPost(text: string, replyToPostId?: string, mediaData?: {
+        data: Buffer;
+        mediaType: string;
+    }[], hideLinkPreview?: boolean): Promise<{
+        ok: boolean;
+        json: () => Promise<import("twitter-api-v2").TweetV2PostTweetResult>;
+        data: import("twitter-api-v2").TweetV2PostTweetResult;
+    }>;
+    sendNotePost(text: string, replyToPostId?: string, mediaData?: {
+        data: Buffer;
+        mediaType: string;
+    }[]): Promise<{
+        ok: boolean;
+        json: () => Promise<import("twitter-api-v2").TweetV2PostTweetResult>;
+        data: import("twitter-api-v2").TweetV2PostTweetResult;
+    }>;
+    /**
+     * Send a long post (Note Post)
+     * @param text The text of the post
+     * @param postId The id of the post to reply to
+     * @param mediaData Optional media data
+     * @returns
+     */
+    sendLongPost(text: string, replyToPostId?: string, mediaData?: {
+        data: Buffer;
+        mediaType: string;
+    }[]): Promise<{
+        ok: boolean;
+        json: () => Promise<import("twitter-api-v2").TweetV2PostTweetResult>;
+        data: import("twitter-api-v2").TweetV2PostTweetResult;
+    }>;
+    /**
+     * Send a post
+     * @param text The text of the post
+     * @param postId The id of the post to reply to
+     * @param options The options for the post
+     * @returns
+     */
+    sendPostV2(text: string, replyToPostId?: string, options?: {
+        poll?: PollData;
+    }): Promise<Post | null>;
+    /**
+     * Fetches posts and replies from an X user.
+     * @param user The user whose posts should be returned.
+     * @param maxPosts The maximum number of posts to return. Defaults to `200`.
+     * @returns An {@link AsyncGenerator} of posts from the provided user.
+     */
+    getPostsAndReplies(user: string, maxPosts?: number): AsyncGenerator<Post>;
+    /**
+     * Fetches posts and replies from an X user using their ID.
+     * @param userId The user whose posts should be returned.
+     * @param maxPosts The maximum number of posts to return. Defaults to `200`.
+     * @returns An {@link AsyncGenerator} of posts from the provided user.
+     */
+    getPostsAndRepliesByUserId(userId: string, maxPosts?: number): AsyncGenerator<Post, void>;
+    /**
+     * Fetches the first post matching the given query.
+     *
+     * Example:
+     * ```js
+     * const timeline = client.getPosts('user', 200);
+     * const repost = await client.getPostWhere(timeline, { isRepost: true });
+     * ```
+     * @param posts The {@link AsyncIterable} of posts to search through.
+     * @param query A query to test **all** posts against. This may be either an
+     * object of key/value pairs or a predicate. If this query is an object, all
+     * key/value pairs must match a {@link Post} for it to be returned. If this query
+     * is a predicate, it must resolve to `true` for a {@link Post} to be returned.
+     * - All keys are optional.
+     * - If specified, the key must be implemented by that of {@link Post}.
+     */
+    getPostWhere(posts: AsyncIterable<Post>, query: PostQuery): Promise<Post | null>;
+    /**
+     * Fetches all posts matching the given query.
+     *
+     * Example:
+     * ```js
+     * const timeline = client.getPosts('user', 200);
+     * const reposts = await client.getPostsWhere(timeline, { isRepost: true });
+     * ```
+     * @param posts The {@link AsyncIterable} of posts to search through.
+     * @param query A query to test **all** posts against. This may be either an
+     * object of key/value pairs or a predicate. If this query is an object, all
+     * key/value pairs must match a {@link Post} for it to be returned. If this query
+     * is a predicate, it must resolve to `true` for a {@link Post} to be returned.
+     * - All keys are optional.
+     * - If specified, the key must be implemented by that of {@link Post}.
+     */
+    getPostsWhere(posts: AsyncIterable<Post>, query: PostQuery): Promise<Post[]>;
+    /**
+     * Fetches the most recent post from an X user.
+     * @param user The user whose latest post should be returned.
+     * @param includeReposts Whether or not to include reposts. Defaults to `false`.
+     * @returns The {@link Post} object or `null`/`undefined` if it couldn't be fetched.
+     */
+    getLatestPost(user: string, includeReposts?: boolean, max?: number): Promise<Post | null | undefined>;
+    /**
+     * Fetches a single post.
+     * @param id The ID of the post to fetch.
+     * @returns The {@link Post} object, or `null` if it couldn't be fetched.
+     */
+    getPost(id: string): Promise<Post | null>;
+    /**
+     * Fetches a single post by ID using the X API v2.
+     * Allows specifying optional expansions and fields for more detailed data.
+     *
+     * @param {string} id - The ID of the post to fetch.
+     * @param {Object} [options] - Optional parameters to customize the post data.
+     * @param {string[]} [options.expansions] - Array of expansions to include, e.g., 'attachments.poll_ids'.
+     * @param {string[]} [options.postFields] - Array of post fields to include, e.g., 'created_at', 'public_metrics'.
+     * @param {string[]} [options.pollFields] - Array of poll fields to include, if the post has a poll, e.g., 'options', 'end_datetime'.
+     * @param {string[]} [options.mediaFields] - Array of media fields to include, if the post includes media, e.g., 'url', 'preview_image_url'.
+     * @param {string[]} [options.userFields] - Array of user fields to include, if user information is requested, e.g., 'username', 'verified'.
+     * @param {string[]} [options.placeFields] - Array of place fields to include, if the post includes location data, e.g., 'full_name', 'country'.
+     * @returns {Promise<PostV2 | null>} - The post data, including requested expansions and fields.
+     */
+    getPostV2(id: string, options?: {
+        expansions?: TPostv2Expansion[];
+        postFields?: TPostv2PostField[];
+        pollFields?: TPostv2PollField[];
+        mediaFields?: TPostv2MediaField[];
+        userFields?: TPostv2UserField[];
+        placeFields?: TPostv2PlaceField[];
+    }): Promise<Post | null>;
+    /**
+     * Fetches multiple posts by IDs using the X API v2.
+     * Allows specifying optional expansions and fields for more detailed data.
+     *
+     * @param {string[]} ids - Array of post IDs to fetch.
+     * @param {Object} [options] - Optional parameters to customize the post data.
+     * @param {string[]} [options.expansions] - Array of expansions to include, e.g., 'attachments.poll_ids'.
+     * @param {string[]} [options.postFields] - Array of post fields to include, e.g., 'created_at', 'public_metrics'.
+     * @param {string[]} [options.pollFields] - Array of poll fields to include, if posts contain polls, e.g., 'options', 'end_datetime'.
+     * @param {string[]} [options.mediaFields] - Array of media fields to include, if posts contain media, e.g., 'url', 'preview_image_url'.
+     * @param {string[]} [options.userFields] - Array of user fields to include, if user information is requested, e.g., 'username', 'verified'.
+     * @param {string[]} [options.placeFields] - Array of place fields to include, if posts contain location data, e.g., 'full_name', 'country'.
+     * @returns {Promise<PostV2[]> } - Array of post data, including requested expansions and fields.
+     */
+    getPostsV2(ids: string[], options?: {
+        expansions?: TPostv2Expansion[];
+        postFields?: TPostv2PostField[];
+        pollFields?: TPostv2PollField[];
+        mediaFields?: TPostv2MediaField[];
+        userFields?: TPostv2UserField[];
+        placeFields?: TPostv2PlaceField[];
+    }): Promise<Post[]>;
+    /**
+     * Updates the authentication state for the client.
+     * @param auth The new authentication.
+     */
+    updateAuth(auth: XAuth): void;
+    authenticate(provider: XAuthProvider): Promise<void>;
+    /**
+     * Get current authentication credentials
+     * @returns {XAuth | null} Current authentication or null if not authenticated
+     */
+    getAuth(): XAuth | null;
+    /**
+     * Check if client is properly authenticated with X API v2 credentials
+     * @returns {boolean} True if authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Returns if the client is logged in as a real user.
+     * @returns `true` if the client is logged in with a real user account; otherwise `false`.
+     */
+    isLoggedIn(): Promise<boolean>;
+    /**
+     * Returns the currently logged in user
+     * @returns The currently logged in user
+     */
+    me(): Promise<Profile | undefined>;
+    /**
+     * Login to X using API v2 credentials only.
+     * @param appKey The API key
+     * @param appSecret The API secret key
+     * @param accessToken The access token
+     * @param accessSecret The access token secret
+     */
+    login(_username: string, _password: string, _email?: string, _twoFactorSecret?: string, appKey?: string, appSecret?: string, accessToken?: string, accessSecret?: string): Promise<void>;
+    /**
+     * Log out of X.
+     * With API v2 credentials, logout is a no-op.
+     */
+    logout(): Promise<void>;
+    /**
+     * Sends a quote post.
+     * @param text The text of the post.
+     * @param quotedPostId The ID of the post to quote.
+     * @param options Optional parameters, such as media data.
+     * @returns The response from the X API.
+     */
+    sendQuotePost(text: string, quotedPostId: string, options?: {
+        mediaData: {
+            data: Buffer;
+            mediaType: string;
+        }[];
+    }): Promise<{
+        ok: boolean;
+        json: () => Promise<import("twitter-api-v2").TweetV2PostTweetResult>;
+        data: import("twitter-api-v2").TweetV2PostTweetResult;
+    }>;
+    /**
+     * Delete a post with the given ID.
+     * @param postId The ID of the post to delete.
+     * @returns A promise that resolves when the post is deleted.
+     */
+    deletePost(postId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Likes a post with the given post ID.
+     * @param postId The ID of the post to like.
+     * @returns A promise that resolves when the post is liked.
+     */
+    likePost(postId: string): Promise<void>;
+    /**
+     * Reposts a post with the given post ID.
+     * @param postId The ID of the post to repost.
+     * @returns A promise that resolves when the post is reposted.
+     */
+    repost(postId: string): Promise<void>;
+    /**
+     * Unlikes a post with the given post ID.
+     * @param postId The ID of the post to unlike.
+     * @returns A promise that resolves when the post is unliked.
+     */
+    unlikePost(postId: string): Promise<void>;
+    /**
+     * Removes a repost of a post with the given post ID.
+     * @param postId The ID of the post to unrepost.
+     * @returns A promise that resolves when the repost is removed.
+     */
+    unrepost(postId: string): Promise<void>;
+    /**
+     * Follows a user with the given user ID.
+     * @param userId The user ID of the user to follow.
+     * @returns A promise that resolves when the user is followed.
+     */
+    followUser(userName: string): Promise<void>;
+    /**
+     * Fetches direct message conversations.
+     * Requires additional API permissions not included in basic access.
+     */
+    getDirectMessageConversations(_userId: string, _cursor?: string): Promise<{
+        conversations: unknown[];
+    }>;
+    /**
+     * Sends a direct message to a user.
+     * Requires additional API permissions not included in basic access.
+     */
+    sendDirectMessage(_conversationId: string, _text: string): Promise<never>;
+    private handleResponse;
+    /**
+     * Retrieves all users who reposted the given post.
+     * @param postId The ID of the post.
+     * @returns An array of users (reposters).
+     */
+    getRepostersOfPost(postId: string): Promise<Reposter[]>;
+    /**
+     * Fetches all quote posts for a given post ID, handling pagination automatically.
+     * @param postId The ID of the post to fetch quotes for.
+     * @param maxQuotes Maximum number of quotes to return (default: 100).
+     * @returns An array of all quote posts.
+     */
+    fetchAllQuotedPosts(postId: string, maxQuotes?: number): Promise<Post[]>;
+    /**
+     * Fetches quote posts for a given post ID.
+     * This method now uses a generator function internally.
+     * @param postId The ID of the post to fetch quotes for.
+     * @param maxQuotes Maximum number of quotes to return.
+     * @param cursor Optional cursor for pagination.
+     * @returns A promise that resolves to a QueryPostsResponse containing posts and the next cursor.
+     */
+    fetchQuotedPostsPage(postId: string, maxQuotes?: number, _cursor?: string): Promise<QueryPostsResponse>;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client/client.d.ts.map

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

package/dist/client/errors.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Class representing an API error.
+ */
+export declare class ApiError extends Error {
+    readonly response: Response;
+    readonly data: unknown;
+    /**
+     * Constructor for creating a new instance of the class.
+     *
+     * @param response The response object.
+     * @param data The data object.
+     * @param message The message string.
+     */
+    private constructor();
+    /**
+     * Creates an instance of ApiError based on a Response object.
+     *
+     * @param {Response} response The Response object to parse.
+     * @returns {Promise<ApiError>} A new instance of ApiError with the parsed data and status.
+     */
+    static fromResponse(response: Response): Promise<ApiError>;
+}
+/**
+ * Represents a position in a file with line and column information.
+ * @interface Position
+ * @property {number} line - The line number of the position.
+ * @property {number} column - The column number of the position.
+ */
+interface Position {
+    line: number;
+    column: number;
+}
+/**
+ * Interface representing trace information.
+ * @property { string } trace_id - The ID of the trace.
+ */
+interface TraceInfo {
+    trace_id: string;
+}
+/**
+ * Interface representing additional information that can be included in X API error objects.
+ * @typedef { Object } XApiErrorExtensions
+ * @property { number } [code] - The error code associated with the error.
+ * @property { string } [kind] - The kind of error that occurred.
+ * @property { string } [name] - The name of the error.
+ * @property { string } [source] - The source of the error.
+ * @property { TraceInfo } [tracing] - Information about the tracing of the error.
+ */
+interface XApiErrorExtensions {
+    code?: number;
+    kind?: string;
+    name?: string;
+    source?: string;
+    tracing?: TraceInfo;
+}
+/**
+ * Interface representing a raw X API error object.
+ * @interface
+ * @extends {XApiErrorExtensions}
+ * @property {string} [message] The error message.
+ * @property {Position[]} [locations] An array of positions.
+ * @property {string[]} [path] An array representing the path of the error.
+ * @property {XApiErrorExtensions} [extensions] Additional error extensions.
+ */
+export interface XApiErrorRaw extends XApiErrorExtensions {
+    message?: string;
+    locations?: Position[];
+    path?: string[];
+    extensions?: XApiErrorExtensions;
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/client/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../client/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,QAAS,SAAQ,KAAK;IAS/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO;IATxB;;;;;;OAMG;IACH,OAAO;IAQP;;;;;OAKG;WACU,YAAY,CAAC,QAAQ,EAAE,QAAQ;CAa7C;AAED;;;;;GAKG;AACH,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,UAAU,mBAAmB;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAa,SAAQ,mBAAmB;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC"}

package/dist/client/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * X API v2 Client
+ *
+ * Provides a clean interface to X's API v2 for:
+ * - Posts (create, read, delete, like, repost)
+ * - Users (profiles, followers, following)
+ * - Timelines (home, user, list)
+ * - Search (posts, users)
+ * - Direct Messages (limited in v2)
+ */
+export * from "./api-types";
+export { XAuth } from "./auth";
+export type { ClientOptions } from "./client";
+export { Client } from "./client";
+export * from "./errors";
+export * from "./posts";
+export * from "./profile";
+export * from "./relationships";
+export * from "./search";
+export type { QueryPostsResponse, QueryProfilesResponse } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC"}