@granitebps/twitter-mcp 1.0.0

package/dist/errors/twitter-error.js

@@ -0,0 +1,35 @@
+export class TwitterError extends Error {
+    code;
+    safeMessage;
+    provider;
+    retryable;
+    retryAfterSeconds;
+    constructor(options) {
+        super(options.safeMessage, { cause: options.cause });
+        this.name = "TwitterError";
+        this.code = options.code;
+        this.safeMessage = options.safeMessage;
+        this.provider = options.provider;
+        this.retryable = options.retryable;
+        this.retryAfterSeconds = options.retryAfterSeconds;
+    }
+}
+const SECRET_PATTERNS = [
+    [/\bAuthorization:\s*(?:Bearer\s+)?[^\s,;]+/gi, "Authorization: [REDACTED]"],
+    [/\b(auth_token|ct0|RETTIWT_API_KEY)=([^\s,;]+)/gi, "$1=[REDACTED]"],
+];
+export function redactSecrets(value) {
+    return SECRET_PATTERNS.reduce((redacted, [pattern, replacement]) => redacted.replace(pattern, replacement), value);
+}
+export function toTwitterError(error, provider) {
+    if (error instanceof TwitterError)
+        return error;
+    return new TwitterError({
+        code: "INTERNAL_ERROR",
+        safeMessage: "The X provider returned an unexpected error",
+        provider,
+        retryable: false,
+        cause: error,
+    });
+}
+//# sourceMappingURL=twitter-error.js.map

package/dist/errors/twitter-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitter-error.js","sourceRoot":"","sources":["../../src/errors/twitter-error.ts"],"names":[],"mappings":"AAsBA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAmB;IACvB,WAAW,CAAS;IACpB,QAAQ,CAAe;IACvB,SAAS,CAAU;IACnB,iBAAiB,CAAqB;IAE/C,YAAY,OAA4B;QACtC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACrD,CAAC;CACF;AAED,MAAM,eAAe,GAA4B;IAC/C,CAAC,6CAA6C,EAAE,2BAA2B,CAAC;IAC5E,CAAC,iDAAiD,EAAE,eAAe,CAAC;CACrE,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,eAAe,CAAC,MAAM,CAC3B,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,EAC5E,KAAK,CACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,QAAsB;IACnE,IAAI,KAAK,YAAY,YAAY;QAAE,OAAO,KAAK,CAAC;IAEhD,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,6CAA6C;QAC1D,QAAQ;QACR,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { loadConfig } from "./config/env.js";
+export type { ApiConfig, ApiCredentials, RettiwtConfig, RuntimeConfig } from "./config/env.js";
+export { ProviderWarningSchema, TweetPageSchema, TweetSchema, UserProfileSchema, } from "./domain/schemas.js";
+export type { ProviderWarning, Tweet, TweetPage, UserProfile } from "./domain/schemas.js";
+export type { GetProfileRequest, GetRepliesRequest, GetTweetRequest, ProviderCapabilities, RequestContext, SearchTweetsRequest, } from "./domain/requests.js";
+export { redactSecrets, toTwitterError, TwitterError } from "./errors/twitter-error.js";
+export type { ProviderName, TwitterErrorCode, TwitterErrorOptions, } from "./errors/twitter-error.js";
+export { createProvider } from "./providers/factory.js";
+export type { ProviderLoaders } from "./providers/factory.js";
+export type { TwitterProvider } from "./providers/provider.js";
+export { createTwitterServer } from "./server/create-server.js";
+export type { CreateServerOptions } from "./server/create-server.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+export { loadConfig } from "./config/env.js";
+export { ProviderWarningSchema, TweetPageSchema, TweetSchema, UserProfileSchema, } from "./domain/schemas.js";
+export { redactSecrets, toTwitterError, TwitterError } from "./errors/twitter-error.js";
+export { createProvider } from "./providers/factory.js";
+export { createTwitterServer } from "./server/create-server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAU7B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAMxF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/providers/api/mapper.d.ts

@@ -0,0 +1,34 @@
+import type { Tweet, UserProfile } from "../../domain/schemas.js";
+export interface ApiPublicMetricsLike {
+    like_count?: number;
+    retweet_count?: number;
+    reply_count?: number;
+    quote_count?: number;
+    bookmark_count?: number;
+    impression_count?: number;
+    followers_count?: number;
+    following_count?: number;
+    tweet_count?: number;
+    listed_count?: number;
+}
+export interface ApiUserLike {
+    id: string;
+    name: string;
+    username: string;
+    description?: string;
+    created_at?: string;
+    verified?: boolean;
+    profile_image_url?: string;
+    location?: string;
+    url?: string;
+    public_metrics?: ApiPublicMetricsLike;
+}
+export interface ApiTweetLike {
+    id: string;
+    text: string;
+    created_at?: string;
+    author_id?: string;
+    public_metrics?: ApiPublicMetricsLike;
+}
+export declare function mapApiTweet(tweet: ApiTweetLike, users?: ReadonlyMap<string, ApiUserLike>): Tweet;
+export declare function mapApiUser(user: ApiUserLike): UserProfile;

package/dist/providers/api/mapper.js

@@ -0,0 +1,45 @@
+export function mapApiTweet(tweet, users = new Map()) {
+    const author = tweet.author_id ? users.get(tweet.author_id) : undefined;
+    const metrics = tweet.public_metrics;
+    return {
+        id: tweet.id,
+        text: tweet.text,
+        ...(tweet.created_at ? { created_at: tweet.created_at } : {}),
+        author: author
+            ? {
+                name: author.name,
+                username: author.username,
+                verified: author.verified ?? false,
+            }
+            : null,
+        metrics: {
+            likes: metrics?.like_count ?? 0,
+            retweets: metrics?.retweet_count ?? 0,
+            replies: metrics?.reply_count ?? 0,
+            quotes: metrics?.quote_count ?? 0,
+            bookmarks: metrics?.bookmark_count ?? 0,
+            ...(metrics?.impression_count === undefined ? {} : { views: metrics.impression_count }),
+        },
+    };
+}
+export function mapApiUser(user) {
+    const metrics = user.public_metrics;
+    return {
+        id: user.id,
+        name: user.name,
+        username: user.username,
+        ...(user.description ? { description: user.description } : {}),
+        ...(user.created_at ? { created_at: user.created_at } : {}),
+        verified: user.verified ?? false,
+        ...(user.profile_image_url ? { profile_image_url: user.profile_image_url } : {}),
+        ...(user.location ? { location: user.location } : {}),
+        ...(user.url ? { url: user.url } : {}),
+        metrics: {
+            followers_count: metrics?.followers_count ?? 0,
+            following_count: metrics?.following_count ?? 0,
+            tweet_count: metrics?.tweet_count ?? 0,
+            listed_count: metrics?.listed_count ?? 0,
+        },
+    };
+}
+//# sourceMappingURL=mapper.js.map

package/dist/providers/api/mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../../src/providers/api/mapper.ts"],"names":[],"mappings":"AAoCA,MAAM,UAAU,WAAW,CACzB,KAAmB,EACnB,QAA0C,IAAI,GAAG,EAAE;IAEnD,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,CAAC;IAErC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,MAAM,EAAE,MAAM;YACZ,CAAC,CAAC;gBACE,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;aACnC;YACH,CAAC,CAAC,IAAI;QACR,OAAO,EAAE;YACP,KAAK,EAAE,OAAO,EAAE,UAAU,IAAI,CAAC;YAC/B,QAAQ,EAAE,OAAO,EAAE,aAAa,IAAI,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,WAAW,IAAI,CAAC;YAClC,MAAM,EAAE,OAAO,EAAE,WAAW,IAAI,CAAC;YACjC,SAAS,EAAE,OAAO,EAAE,cAAc,IAAI,CAAC;YACvC,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC;SACxF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC;IACpC,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK;QAChC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE;YACP,eAAe,EAAE,OAAO,EAAE,eAAe,IAAI,CAAC;YAC9C,eAAe,EAAE,OAAO,EAAE,eAAe,IAAI,CAAC;YAC9C,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,CAAC;YACtC,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,CAAC;SACzC;KACF,CAAC;AACJ,CAAC"}

package/dist/providers/api/provider.d.ts

@@ -0,0 +1,44 @@
+import type { ApiConfig } from "../../config/env.js";
+import type { Tweet, TweetPage, UserProfile } from "../../domain/schemas.js";
+import type { GetProfileRequest, GetRepliesRequest, GetTweetRequest, ProviderCapabilities, RequestContext, SearchTweetsRequest } from "../../domain/requests.js";
+import type { TwitterProvider } from "../provider.js";
+import { type ApiTweetLike, type ApiUserLike } from "./mapper.js";
+interface ApiTweetResponse {
+    data: ApiTweetLike;
+    includes?: {
+        users?: ApiUserLike[];
+    };
+}
+interface ApiSearchResponse {
+    data: {
+        data?: ApiTweetLike[];
+        meta?: {
+            next_token?: string;
+        };
+    };
+    includes?: {
+        users?: ApiUserLike[];
+    };
+}
+interface ApiUserResponse {
+    data?: ApiUserLike;
+}
+export interface OfficialApiClient {
+    v2: {
+        singleTweet(id: string, options: Record<string, unknown>): Promise<ApiTweetResponse>;
+        search(query: string, options: Record<string, unknown>): Promise<ApiSearchResponse>;
+        userByUsername(username: string, options: Record<string, unknown>): Promise<ApiUserResponse>;
+    };
+}
+export declare class OfficialApiProvider implements TwitterProvider {
+    private readonly client;
+    readonly capabilities: ProviderCapabilities;
+    constructor(client: OfficialApiClient);
+    static create(config: ApiConfig): OfficialApiProvider;
+    getTweet(request: GetTweetRequest, context: RequestContext): Promise<Tweet>;
+    getTweetReplies(request: GetRepliesRequest, context: RequestContext): Promise<TweetPage>;
+    getUserProfile(request: GetProfileRequest, context: RequestContext): Promise<UserProfile>;
+    searchTweets(request: SearchTweetsRequest, context: RequestContext): Promise<TweetPage>;
+    private search;
+}
+export {};

package/dist/providers/api/provider.js

@@ -0,0 +1,150 @@
+import { TwitterApi } from "twitter-api-v2";
+import { TwitterError, toTwitterError } from "../../errors/twitter-error.js";
+import { withDeadline } from "../deadline.js";
+import { mapApiTweet, mapApiUser } from "./mapper.js";
+function timeoutError() {
+    return new TwitterError({
+        code: "TIMEOUT",
+        safeMessage: "The official X API request timed out",
+        provider: "api",
+        retryable: true,
+    });
+}
+function mapApiFailure(error) {
+    if (error instanceof TwitterError)
+        return error;
+    const status = typeof error === "object" && error !== null && "code" in error ? Number(error.code) : undefined;
+    const message = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+    if (status === 401 || status === 403) {
+        return new TwitterError({
+            code: "AUTH_FAILED",
+            safeMessage: "Official X API authentication failed",
+            provider: "api",
+            retryable: false,
+            cause: error,
+        });
+    }
+    if (status === 404) {
+        return new TwitterError({
+            code: "NOT_FOUND",
+            safeMessage: "The requested X resource was not found",
+            provider: "api",
+            retryable: false,
+            cause: error,
+        });
+    }
+    if (status === 429) {
+        return new TwitterError({
+            code: "RATE_LIMITED",
+            safeMessage: "Official X API rate limit reached",
+            provider: "api",
+            retryable: true,
+            cause: error,
+        });
+    }
+    if (message.includes("timeout") || message.includes("econnaborted"))
+        return timeoutError();
+    return toTwitterError(error, "api");
+}
+function userMap(users) {
+    return new Map((users ?? []).map((user) => [user.id, user]));
+}
+const TWEET_FIELDS = ["created_at", "public_metrics", "author_id", "conversation_id", "text"];
+const USER_FIELDS = [
+    "name",
+    "username",
+    "description",
+    "created_at",
+    "verified",
+    "profile_image_url",
+    "public_metrics",
+    "location",
+    "url",
+];
+export class OfficialApiProvider {
+    client;
+    capabilities = {
+        provider: "api",
+        authenticated: true,
+        operations: {
+            getTweet: true,
+            getTweetReplies: true,
+            getUserProfile: true,
+            searchTweets: true,
+        },
+        pagination: { replies: true, search: true },
+        limits: { replies: 100, search: 100 },
+    };
+    constructor(client) {
+        this.client = client;
+    }
+    static create(config) {
+        const credentials = config.credentials;
+        const client = credentials.type === "bearer"
+            ? new TwitterApi(credentials.token)
+            : new TwitterApi({
+                appKey: credentials.appKey,
+                appSecret: credentials.appSecret,
+                accessToken: credentials.accessToken,
+                accessSecret: credentials.accessSecret,
+            });
+        return new OfficialApiProvider(client);
+    }
+    async getTweet(request, context) {
+        try {
+            const response = await withDeadline(this.client.v2.singleTweet(request.tweetId, {
+                "tweet.fields": TWEET_FIELDS,
+                expansions: ["author_id"],
+                "user.fields": USER_FIELDS,
+            }), context.signal, context.deadline, timeoutError);
+            return mapApiTweet(response.data, userMap(response.includes?.users));
+        }
+        catch (error) {
+            throw mapApiFailure(error);
+        }
+    }
+    getTweetReplies(request, context) {
+        return this.search(`conversation_id:${request.tweetId} is:reply`, request.maxResults, context);
+    }
+    async getUserProfile(request, context) {
+        try {
+            const response = await withDeadline(this.client.v2.userByUsername(request.username, { "user.fields": USER_FIELDS }), context.signal, context.deadline, timeoutError);
+            if (!response.data) {
+                throw new TwitterError({
+                    code: "NOT_FOUND",
+                    safeMessage: `User @${request.username} was not found`,
+                    provider: "api",
+                    retryable: false,
+                });
+            }
+            return mapApiUser(response.data);
+        }
+        catch (error) {
+            throw mapApiFailure(error);
+        }
+    }
+    searchTweets(request, context) {
+        return this.search(request.query, request.maxResults, context);
+    }
+    async search(query, maxResults, context) {
+        try {
+            const response = await withDeadline(this.client.v2.search(query, {
+                max_results: Math.max(10, Math.min(maxResults, 100)),
+                "tweet.fields": TWEET_FIELDS,
+                expansions: ["author_id"],
+                "user.fields": USER_FIELDS,
+            }), context.signal, context.deadline, timeoutError);
+            const users = userMap(response.includes?.users);
+            return {
+                items: (response.data.data ?? [])
+                    .slice(0, maxResults)
+                    .map((tweet) => mapApiTweet(tweet, users)),
+                ...(response.data.meta?.next_token ? { nextCursor: response.data.meta.next_token } : {}),
+            };
+        }
+        catch (error) {
+            throw mapApiFailure(error);
+        }
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/providers/api/provider.js.map

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

package/dist/providers/deadline.d.ts

@@ -0,0 +1 @@
+export declare function withDeadline<T>(operation: Promise<T>, signal: AbortSignal, deadline: number, createTimeoutError: () => Error): Promise<T>;

package/dist/providers/deadline.js

@@ -0,0 +1,15 @@
+export function withDeadline(operation, signal, deadline, createTimeoutError) {
+    const remaining = deadline - Date.now();
+    if (signal.aborted || remaining <= 0)
+        throw createTimeoutError();
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(createTimeoutError()), remaining);
+        const abort = () => reject(createTimeoutError());
+        signal.addEventListener("abort", abort, { once: true });
+        operation.then(resolve, reject).finally(() => {
+            clearTimeout(timer);
+            signal.removeEventListener("abort", abort);
+        });
+    });
+}
+//# sourceMappingURL=deadline.js.map

package/dist/providers/deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../../src/providers/deadline.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAC1B,SAAqB,EACrB,MAAmB,EACnB,QAAgB,EAChB,kBAA+B;IAE/B,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACxC,IAAI,MAAM,CAAC,OAAO,IAAI,SAAS,IAAI,CAAC;QAAE,MAAM,kBAAkB,EAAE,CAAC;IAEjE,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC;QACjD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAExD,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YAC3C,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/providers/factory.d.ts

@@ -0,0 +1,7 @@
+import type { ApiConfig, RettiwtConfig, RuntimeConfig } from "../config/env.js";
+import type { TwitterProvider } from "./provider.js";
+export interface ProviderLoaders {
+    rettiwt(config: RettiwtConfig): Promise<TwitterProvider>;
+    api(config: ApiConfig): Promise<TwitterProvider>;
+}
+export declare function createProvider(config: RuntimeConfig, loaders?: ProviderLoaders): Promise<TwitterProvider>;

package/dist/providers/factory.js

@@ -0,0 +1,17 @@
+const defaultLoaders = {
+    async rettiwt(config) {
+        const { RettiwtProvider } = await import("./rettiwt/provider.js");
+        return RettiwtProvider.create(config);
+    },
+    async api(config) {
+        const { OfficialApiProvider } = await import("./api/provider.js");
+        return OfficialApiProvider.create(config);
+    },
+};
+export async function createProvider(config, loaders = defaultLoaders) {
+    if (config.mode === "rettiwt") {
+        return loaders.rettiwt(config);
+    }
+    return loaders.api(config);
+}
+//# sourceMappingURL=factory.js.map

package/dist/providers/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AAQA,MAAM,cAAc,GAAoB;IACtC,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAClE,OAAO,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,MAAM;QACd,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAClE,OAAO,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAqB,EACrB,UAA2B,cAAc;IAEzC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/providers/provider.d.ts

@@ -0,0 +1,9 @@
+import type { Tweet, TweetPage, UserProfile } from "../domain/schemas.js";
+import type { GetProfileRequest, GetRepliesRequest, GetTweetRequest, ProviderCapabilities, RequestContext, SearchTweetsRequest } from "../domain/requests.js";
+export interface TwitterProvider {
+    readonly capabilities: ProviderCapabilities;
+    getTweet(request: GetTweetRequest, context: RequestContext): Promise<Tweet>;
+    getTweetReplies(request: GetRepliesRequest, context: RequestContext): Promise<TweetPage>;
+    getUserProfile(request: GetProfileRequest, context: RequestContext): Promise<UserProfile>;
+    searchTweets(request: SearchTweetsRequest, context: RequestContext): Promise<TweetPage>;
+}

package/dist/providers/provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/providers/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":""}

package/dist/providers/rettiwt/mapper.d.ts

@@ -0,0 +1,29 @@
+import type { Tweet, UserProfile } from "../../domain/schemas.js";
+export interface RettiwtUserLike {
+    id?: string;
+    fullName: string;
+    userName: string;
+    createdAt?: string;
+    description?: string;
+    isVerified: boolean;
+    followersCount?: number;
+    followingsCount?: number;
+    statusesCount?: number;
+    likeCount?: number;
+    profileImage?: string;
+    location?: string;
+}
+export interface RettiwtTweetLike {
+    id: string;
+    fullText: string;
+    createdAt?: string;
+    tweetBy?: Pick<RettiwtUserLike, "fullName" | "userName" | "isVerified"> | undefined;
+    likeCount?: number;
+    retweetCount?: number;
+    replyCount?: number;
+    quoteCount?: number;
+    bookmarkCount?: number;
+    viewCount?: number;
+}
+export declare function mapRettiwtTweet(tweet: RettiwtTweetLike): Tweet;
+export declare function mapRettiwtUser(user: RettiwtUserLike): UserProfile;

package/dist/providers/rettiwt/mapper.js

@@ -0,0 +1,42 @@
+export function mapRettiwtTweet(tweet) {
+    return {
+        id: tweet.id,
+        text: tweet.fullText,
+        ...(tweet.createdAt ? { created_at: tweet.createdAt } : {}),
+        author: tweet.tweetBy
+            ? {
+                name: tweet.tweetBy.fullName,
+                username: tweet.tweetBy.userName,
+                verified: tweet.tweetBy.isVerified,
+            }
+            : null,
+        metrics: {
+            likes: tweet.likeCount ?? 0,
+            retweets: tweet.retweetCount ?? 0,
+            replies: tweet.replyCount ?? 0,
+            quotes: tweet.quoteCount ?? 0,
+            bookmarks: tweet.bookmarkCount ?? 0,
+            views: tweet.viewCount ?? 0,
+        },
+    };
+}
+export function mapRettiwtUser(user) {
+    return {
+        id: user.id ?? "",
+        name: user.fullName,
+        username: user.userName,
+        ...(user.description ? { description: user.description } : {}),
+        ...(user.createdAt ? { created_at: user.createdAt } : {}),
+        verified: user.isVerified,
+        ...(user.profileImage ? { profile_image_url: user.profileImage } : {}),
+        ...(user.location ? { location: user.location } : {}),
+        metrics: {
+            followers_count: user.followersCount ?? 0,
+            following_count: user.followingsCount ?? 0,
+            tweet_count: user.statusesCount ?? 0,
+            listed_count: 0,
+            likes_count: user.likeCount ?? 0,
+        },
+    };
+}
+//# sourceMappingURL=mapper.js.map

package/dist/providers/rettiwt/mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../../src/providers/rettiwt/mapper.ts"],"names":[],"mappings":"AA8BA,MAAM,UAAU,eAAe,CAAC,KAAuB;IACrD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,QAAQ;QACpB,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,EAAE,KAAK,CAAC,OAAO;YACnB,CAAC,CAAC;gBACE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ;gBAC5B,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ;gBAChC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU;aACnC;YACH,CAAC,CAAC,IAAI;QACR,OAAO,EAAE;YACP,KAAK,EAAE,KAAK,CAAC,SAAS,IAAI,CAAC;YAC3B,QAAQ,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;YACjC,OAAO,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;YAC9B,MAAM,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;YAC7B,SAAS,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;YACnC,KAAK,EAAE,KAAK,CAAC,SAAS,IAAI,CAAC;SAC5B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAqB;IAClD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;QACjB,IAAI,EAAE,IAAI,CAAC,QAAQ;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,QAAQ,EAAE,IAAI,CAAC,UAAU;QACzB,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE;YACP,eAAe,EAAE,IAAI,CAAC,cAAc,IAAI,CAAC;YACzC,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,CAAC;YAC1C,WAAW,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC;YACpC,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;SACjC;KACF,CAAC;AACJ,CAAC"}

package/dist/providers/rettiwt/provider.d.ts

@@ -0,0 +1,30 @@
+import type { RettiwtConfig } from "../../config/env.js";
+import type { Tweet, TweetPage, UserProfile } from "../../domain/schemas.js";
+import type { GetProfileRequest, GetRepliesRequest, GetTweetRequest, ProviderCapabilities, RequestContext, SearchTweetsRequest } from "../../domain/requests.js";
+import type { TwitterProvider } from "../provider.js";
+import { type RettiwtTweetLike, type RettiwtUserLike } from "./mapper.js";
+interface CursoredTweets {
+    list: RettiwtTweetLike[];
+    next: string;
+}
+export interface RettiwtClient {
+    tweet: {
+        details(id: string): Promise<RettiwtTweetLike | undefined>;
+        replies(id: string): Promise<CursoredTweets>;
+        search(filter: Record<string, unknown>, count?: number): Promise<CursoredTweets>;
+    };
+    user: {
+        details(id: string): Promise<RettiwtUserLike | undefined>;
+    };
+}
+export declare class RettiwtProvider implements TwitterProvider {
+    private readonly client;
+    readonly capabilities: ProviderCapabilities;
+    constructor(client: RettiwtClient);
+    static create(config: RettiwtConfig): RettiwtProvider;
+    getTweet(request: GetTweetRequest, context: RequestContext): Promise<Tweet>;
+    getTweetReplies(request: GetRepliesRequest, context: RequestContext): Promise<TweetPage>;
+    getUserProfile(request: GetProfileRequest, context: RequestContext): Promise<UserProfile>;
+    searchTweets(request: SearchTweetsRequest, context: RequestContext): Promise<TweetPage>;
+}
+export {};