fxtwitter 1.0.0 → 2.0.0

package/README.md

@@ -16,30 +16,37 @@ npm install fxtwitter
 ## Usage
 
 ```ts
-import { FxTwitterV1 } from "fxtwitter";
+import { FxTwitterV2 } from "fxtwitter/v2";
 
-const fx = new FxTwitterV1();
+const fx = new FxTwitterV2();
 
-const { tweet } = await fx.getStatus("20");
-const { user } = await fx.getUser("jack");
+const { status } = await fx.getStatus("20");
+const { user } = await fx.getProfile("X");
+const { results } = await fx.search("puppies");
 ```
 
-Types can be imported alongside the client:
+Each version ships under its own subpath, where its types are exported
+alongside the client:
 
 ```ts
-import { FxTwitterV1, type Tweet, type User } from "fxtwitter";
+import { FxTwitterV2, type TwitterStatus } from "fxtwitter/v2";
+import { FxTwitterV1, type Tweet } from "fxtwitter/v1";
 ```
 
-The client is also available from the `fxtwitter/v1` subpath, which will keep
-working unchanged as further API versions are added to the root:
+If you need both at once, `FxTwitter` bundles them. `v1` is only constructed —
+and so only warns — on first access:
 
 ```ts
-import { FxTwitterV1 } from "fxtwitter/v1";
+import { FxTwitter } from "fxtwitter";
+
+const fx = new FxTwitter({ v1: { silenceDeprecationWarning: true } });
+await fx.v2.getStatus("20");
+await fx.v1.getStatus("20");
 ```
 
-## API
+## Options
 
-### `new FxTwitterV1(options?)`
+Every client takes the same options:
 
 | Option | Type | Default | Description |
 | --- | --- | --- | --- |
@@ -50,13 +57,15 @@ import { FxTwitterV1 } from "fxtwitter/v1";
 | `retryDelay` | `number` | `0` | Delay between retries, in ms |
 | `fetch` | `typeof fetch` | global `fetch` | Custom fetch implementation |
 
+Every method takes an optional `signal` for per-call cancellation.
+
 > The API requires a `User-Agent` identifying the caller and answers `401`
 > without one. When you don't set one, a header describing the current runtime
 > is sent — `Node.js/22.16.0`, `Bun/1.3.0`, `Cloudflare-Workers` and so on.
 > Set your own to identify your app instead:
 >
 > ```ts
-> new FxTwitterV1({
+> new FxTwitterV2({
 >   headers: { "User-Agent": "MyApp/1.0 (+https://example.com)" },
 > });
 > ```
@@ -64,14 +73,69 @@ import { FxTwitterV1 } from "fxtwitter/v1";
 > Nothing is sent in browsers, where `User-Agent` is a forbidden header and the
 > browser supplies its own.
 
-### `getStatus(id, options?)`
+## v2
+
+### `new FxTwitterV2(options?)`
+
+| Method | Returns |
+| --- | --- |
+| `getStatus(id, options?)` | A single post |
+| `getThread(id, options?)` | A post with its unrolled thread |
+| `getConversation(id, options?)` | A post, its thread, and ranked replies |
+| `getStatusReposts(id, options?)` | Users who reposted a post |
+| `getStatusQuotes(id, options?)` | Posts quoting a post |
+| `getProfile(handle, options?)` | A user profile |
+| `getProfileStatuses(handle, options?)` | A user's posts |
+| `getProfileArticles(handle, options?)` | A user's long-form articles |
+| `getProfileMedia(handle, options?)` | A user's posts containing media |
+| `getProfileAbout(handle, options?)` | Account metadata |
+| `getProfileFollowers(handle, options?)` | A user's followers |
+| `getProfileFollowing(handle, options?)` | Accounts a user follows |
+| `search(query, options?)` | Post search results |
+| `typeahead(query, options?)` | Autocomplete suggestions |
+| `trends(options?)` | Trending topics |
+
+Common options: `count` and `cursor` paginate list endpoints, `lang` requests an
+inline translation, and `aboutAccount` adds `about_account` to an author.
+
+```ts
+// Paginate
+let cursor: string | undefined;
+do {
+  const page = await fx.search("puppies", { feed: "top", count: 50, cursor });
+  cursor = page.cursor.bottom ?? undefined;
+} while (cursor);
+
+// Look a profile up by numeric ID
+import { byUserId } from "fxtwitter/v2";
+await fx.getProfile(byUserId("783214"));
+```
+
+The list endpoints report "no results" as a `404` carrying an otherwise normal
+body. An empty page is a result rather than an error, so it resolves with
+`results: []`. The API uses that same `404` for an unknown handle, which it does
+not distinguish from an empty timeline.
+
+`getProfileStatuses` resolves to `null` when `since` is set without a `cursor`
+and nothing is newer — the API's documented `204`. Every other method either
+resolves with a body or throws.
+
+## v1
+
+> **Deprecated.** v1 is kept only for backwards compatibility and does not
+> receive new features — use [v2](#v2) instead. Constructing `FxTwitterV1`
+> emits a one-time `DeprecationWarning` (so `--no-deprecation` and
+> `--throw-deprecation` apply); pass `silenceDeprecationWarning: true` to
+> suppress it. `FxTwitter`'s `v1` property only constructs the client, and so
+> only warns, on first access.
+
+### `new FxTwitterV1(options?)`
+
+#### `getStatus(id, options?)`
 
 Fetches a single status by its snowflake ID.
 
 ```ts
-const { tweet } = await fx.getStatus("20");
-
-// Translate the status
 const { tweet } = await fx.getStatus("20", { translateTo: "es" });
 tweet?.translation?.text;
 ```
@@ -80,12 +144,11 @@ tweet?.translation?.text;
 | --- | --- | --- |
 | `translateTo` | `string` | Target language — an ISO 639-1 code (`es`) or locale (`zh-cn`). Adds `translation` to the status |
 | `screenName` | `string` | Author handle, for a readable URL. The API resolves the status from `id` alone and never checks it |
-| `signal` | `AbortSignal` | Per-call cancellation |
 
 Resolves to `{ code, message, tweet }`. `tweet` is `null` when the status could
 not be retrieved.
 
-### `getUser(handle, options?)`
+#### `getUser(handle, options?)`
 
 Fetches a user profile by handle, without a leading `@`.
 
@@ -93,15 +156,19 @@ Fetches a user profile by handle, without a leading `@`.
 const { user } = await fx.getUser("jack");
 ```
 
-| Option | Type | Description |
-| --- | --- | --- |
-| `signal` | `AbortSignal` | Per-call cancellation |
-
 Resolves to `{ code, message, user, reason? }`. `user` is absent when the
 profile could not be retrieved, and `reason` is `"suspended"` for a suspended
 account.
 
-### Errors
+On success, `code` mirrors the HTTP status and `message` is one of `OK`,
+`PRIVATE_TWEET`, `NOT_FOUND`, `UPSTREAM_UNAVAILABLE` or `API_FAIL`.
+
+Malformed input is rejected before a request is sent, because v1 answers those
+cases with HTML or a redirect rather than JSON: a status ID must be 2-20 digits,
+and a handle passed to `getUser` must match `\w{1,15}`. A well-formed handle
+that does not exist is a normal `404`.
+
+## Errors
 
 HTTP 4xx/5xx, network failures, timeouts, invalid input, and non-JSON responses
 are thrown as `FxTwitterError`:
@@ -122,18 +189,10 @@ try {
 }
 ```
 
-On success, `code` mirrors the HTTP status and `message` is one of `OK`,
-`PRIVATE_TWEET`, `NOT_FOUND`, `UPSTREAM_UNAVAILABLE` or `API_FAIL`.
-
 For a network failure or a timeout there is no response, so `status`, `code`
 and `body` are all `undefined` and `message` is a generic description. The
 original error is still available as `cause`.
 
-Malformed input is rejected before a request is sent, because the API answers
-those cases with HTML or a redirect rather than JSON: a status ID must be 2-20
-digits, and a handle passed to `getUser` must match `\w{1,15}`. A well-formed
-handle that does not exist is a normal `404`.
-
 ## Requirements
 
 - Node.js >= 22

package/dist/{v1-KUPCoHD9.mjs → http-BTdKgEdX.mjs}

@@ -144,59 +144,4 @@ function toFxTwitterError(cause) {
 	});
 }
 //#endregion
-//#region src/v1.ts
-/**
-* The API resolves a status from the first 2-20 digit run in the path segment,
-* and answers anything else with its embed HTML at HTTP 200 rather than JSON.
-*/
-const STATUS_ID_PATTERN = /^\d{2,20}$/;
-/**
-* Handles are matched as `\w{1,15}` upstream; anything else is redirected to
-* the project's GitHub page instead of returning JSON.
-*/
-const HANDLE_PATTERN = /^\w{1,15}$/;
-/** Client for the FxTwitter v1 API. */
-var FxTwitterV1 = class {
-	http;
-	constructor(options = {}) {
-		this.http = new HttpClient(options);
-	}
-	/**
-	* Fetches a single status by its snowflake ID.
-	*
-	* `GET /status/:id`, `GET /status/:id/:language`,
-	* `GET /:handle/status/:id`, `GET /:handle/status/:id/:language`
-	*/
-	async getStatus(id, options = {}) {
-		if (!STATUS_ID_PATTERN.test(id)) throw new FxTwitterError(`Invalid status ID ${JSON.stringify(id)}: expected 2-20 digits`);
-		if (options.screenName !== void 0 && options.screenName.trim() === "") throw new FxTwitterError("screenName must not be empty");
-		const segments = [
-			options.screenName,
-			"status",
-			id,
-			options.translateTo
-		].filter((segment) => segment !== void 0);
-		return requireBody(await this.http.get({
-			path: `/${segments.map(encodeURIComponent).join("/")}`,
-			signal: options.signal
-		}));
-	}
-	/** Fetches a user profile by handle (`GET /:handle`). */
-	async getUser(screenName, options = {}) {
-		assertHandle(screenName);
-		return requireBody(await this.http.get({
-			path: `/${encodeURIComponent(screenName)}`,
-			signal: options.signal
-		}));
-	}
-};
-function assertHandle(handle) {
-	if (!HANDLE_PATTERN.test(handle)) throw new FxTwitterError(`Invalid handle ${JSON.stringify(handle)}: expected 1-15 letters, digits or underscores, without a leading @`);
-}
-/** v1 never answers 204, so an empty body here means something went wrong. */
-function requireBody(body) {
-	if (body === null) throw new FxTwitterError("The API returned an empty response");
-	return body;
-}
-//#endregion
-export { FxTwitterError as n, FxTwitterV1 as t };
+export { FxTwitterError as n, HttpClient as t };

package/dist/http-CidaL0TV.d.cts

@@ -0,0 +1,24 @@
+//#region src/http.d.ts
+/** Options shared by every client, forwarded to ofetch. */
+interface ClientOptions {
+  /** Overrides the API host. Defaults to `https://api.fxtwitter.com`. */
+  baseUrl?: string;
+  /** Custom fetch implementation (e.g. a mock, or undici in older runtimes). */
+  fetch?: typeof fetch;
+  /**
+   * Extra headers sent with every request.
+   *
+   * When no `User-Agent` is given, one describing the current runtime is
+   * added, because the API answers `401` to requests that do not identify
+   * themselves. Set your own here to override it.
+   */
+  headers?: Record<string, string>;
+  /** Abort a request after this many milliseconds. Disabled by default. */
+  timeout?: number;
+  /** Retry count for failed requests. Defaults to ofetch's `1` for GET. */
+  retry?: number | false;
+  /** Delay between retries in milliseconds. Defaults to `0`. */
+  retryDelay?: number;
+}
+//#endregion
+export { ClientOptions as t };

package/dist/http-CidaL0TV.d.mts

@@ -0,0 +1,24 @@
+//#region src/http.d.ts
+/** Options shared by every client, forwarded to ofetch. */
+interface ClientOptions {
+  /** Overrides the API host. Defaults to `https://api.fxtwitter.com`. */
+  baseUrl?: string;
+  /** Custom fetch implementation (e.g. a mock, or undici in older runtimes). */
+  fetch?: typeof fetch;
+  /**
+   * Extra headers sent with every request.
+   *
+   * When no `User-Agent` is given, one describing the current runtime is
+   * added, because the API answers `401` to requests that do not identify
+   * themselves. Set your own here to override it.
+   */
+  headers?: Record<string, string>;
+  /** Abort a request after this many milliseconds. Disabled by default. */
+  timeout?: number;
+  /** Retry count for failed requests. Defaults to ofetch's `1` for GET. */
+  retry?: number | false;
+  /** Delay between retries in milliseconds. Defaults to `0`. */
+  retryDelay?: number;
+}
+//#endregion
+export { ClientOptions as t };

package/dist/{v1-Da3KbdIz.cjs → http-Cs4GJeg-.cjs}

@@ -144,70 +144,15 @@ function toFxTwitterError(cause) {
 	});
 }
 //#endregion
-//#region src/v1.ts
-/**
-* The API resolves a status from the first 2-20 digit run in the path segment,
-* and answers anything else with its embed HTML at HTTP 200 rather than JSON.
-*/
-const STATUS_ID_PATTERN = /^\d{2,20}$/;
-/**
-* Handles are matched as `\w{1,15}` upstream; anything else is redirected to
-* the project's GitHub page instead of returning JSON.
-*/
-const HANDLE_PATTERN = /^\w{1,15}$/;
-/** Client for the FxTwitter v1 API. */
-var FxTwitterV1 = class {
-	http;
-	constructor(options = {}) {
-		this.http = new HttpClient(options);
-	}
-	/**
-	* Fetches a single status by its snowflake ID.
-	*
-	* `GET /status/:id`, `GET /status/:id/:language`,
-	* `GET /:handle/status/:id`, `GET /:handle/status/:id/:language`
-	*/
-	async getStatus(id, options = {}) {
-		if (!STATUS_ID_PATTERN.test(id)) throw new FxTwitterError(`Invalid status ID ${JSON.stringify(id)}: expected 2-20 digits`);
-		if (options.screenName !== void 0 && options.screenName.trim() === "") throw new FxTwitterError("screenName must not be empty");
-		const segments = [
-			options.screenName,
-			"status",
-			id,
-			options.translateTo
-		].filter((segment) => segment !== void 0);
-		return requireBody(await this.http.get({
-			path: `/${segments.map(encodeURIComponent).join("/")}`,
-			signal: options.signal
-		}));
-	}
-	/** Fetches a user profile by handle (`GET /:handle`). */
-	async getUser(screenName, options = {}) {
-		assertHandle(screenName);
-		return requireBody(await this.http.get({
-			path: `/${encodeURIComponent(screenName)}`,
-			signal: options.signal
-		}));
-	}
-};
-function assertHandle(handle) {
-	if (!HANDLE_PATTERN.test(handle)) throw new FxTwitterError(`Invalid handle ${JSON.stringify(handle)}: expected 1-15 letters, digits or underscores, without a leading @`);
-}
-/** v1 never answers 204, so an empty body here means something went wrong. */
-function requireBody(body) {
-	if (body === null) throw new FxTwitterError("The API returned an empty response");
-	return body;
-}
-//#endregion
 Object.defineProperty(exports, "FxTwitterError", {
 	enumerable: true,
 	get: function() {
 		return FxTwitterError;
 	}
 });
-Object.defineProperty(exports, "FxTwitterV1", {
+Object.defineProperty(exports, "HttpClient", {
 	enumerable: true,
 	get: function() {
-		return FxTwitterV1;
+		return HttpClient;
 	}
 });

package/dist/index.cjs

@@ -1,4 +1,50 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_v1 = require("./v1-Da3KbdIz.cjs");
-exports.FxTwitterError = require_v1.FxTwitterError;
+const require_v1 = require("./v1-BFKgLuJi.cjs");
+const require_http = require("./http-Cs4GJeg-.cjs");
+const require_v2 = require("./v2.cjs");
+//#region src/client.ts
+/**
+* Combined client exposing every API version.
+*
+* Prefer importing a single version when you only need one — `FxTwitterV2`
+* from `fxtwitter/v2` — and reach for this only when you use both.
+*
+* ```ts
+* const fx = new FxTwitter();
+* const { status } = await fx.v2.getStatus("20");
+* const { tweet } = await fx.v1.getStatus("20");
+* ```
+*/
+var FxTwitter = class {
+	v2;
+	v1Options;
+	v1Client;
+	constructor(options = {}) {
+		const { v1, v2, ...shared } = options;
+		this.v2 = new require_v2.FxTwitterV2({
+			...shared,
+			baseUrl: v2?.baseUrl
+		});
+		this.v1Options = {
+			...shared,
+			baseUrl: v1?.baseUrl,
+			silenceDeprecationWarning: v1?.silenceDeprecationWarning
+		};
+	}
+	/**
+	* The legacy v1 client, constructed on first access so its deprecation
+	* warning is only emitted if you actually use it.
+	*
+	* @deprecated Use {@link FxTwitter.v2} instead.
+	*/
+	get v1() {
+		this.v1Client ??= new require_v1.FxTwitterV1(this.v1Options);
+		return this.v1Client;
+	}
+};
+//#endregion
+exports.FxTwitter = FxTwitter;
+exports.FxTwitterError = require_http.FxTwitterError;
 exports.FxTwitterV1 = require_v1.FxTwitterV1;
+exports.FxTwitterV2 = require_v2.FxTwitterV2;
+exports.byUserId = require_v2.byUserId;

package/dist/index.d.cts

@@ -1,4 +1,42 @@
-import { A as ClientOptions, C as User, D as Video, E as VerificationType, O as VideoFormat, S as TwitterCard, T as Verification, _ as StatusMessage, a as AnyMedia, b as Translation, c as ExternalMedia, d as Photo, f as Poll, g as StatusMedia, h as RepostedBy, i as GetUserOptions, k as Website, l as Facet, m as RawText, n as FxTwitterV1Options, o as Author, p as PollChoice, r as GetStatusOptions, s as CommunityNote, t as FxTwitterV1, u as MosaicPhoto, v as StatusRawText, w as UserResponse, x as Tweet, y as StatusResponse } from "./v1-BKUGwGbc.cjs";
+import { t as ClientOptions } from "./http-CidaL0TV.cjs";
+import { AnyMedia, Author, CommunityNote, ExternalMedia, Facet, FxTwitterV1, FxTwitterV1Options, GetStatusOptions, GetUserOptions, MosaicPhoto, Photo, Poll, PollChoice, RawText, RepostedBy, StatusMedia, StatusMessage, StatusRawText, StatusResponse, Translation, Tweet, TwitterCard, User, UserResponse, Verification, VerificationType, Video, VideoFormat, Website } from "./v1.cjs";
+import { FxTwitterV2, FxTwitterV2Options, byUserId, t as v2_d_exports } from "./v2.cjs";
+//#region src/client.d.ts
+type FxTwitterOptions = ClientOptions & {
+  /** Overrides applied only to the v1 client. */
+  v1?: Pick<ClientOptions, "baseUrl"> & {
+    /** Suppresses the one-time deprecation warning emitted when `v1` is first accessed. */
+    silenceDeprecationWarning?: boolean;
+  };
+  /** Overrides applied only to the v2 client. */
+  v2?: Pick<ClientOptions, "baseUrl">;
+};
+/**
+ * Combined client exposing every API version.
+ *
+ * Prefer importing a single version when you only need one — `FxTwitterV2`
+ * from `fxtwitter/v2` — and reach for this only when you use both.
+ *
+ * ```ts
+ * const fx = new FxTwitter();
+ * const { status } = await fx.v2.getStatus("20");
+ * const { tweet } = await fx.v1.getStatus("20");
+ * ```
+ */
+declare class FxTwitter {
+  readonly v2: FxTwitterV2;
+  private readonly v1Options;
+  private v1Client?;
+  constructor(options?: FxTwitterOptions);
+  /**
+   * The legacy v1 client, constructed on first access so its deprecation
+   * warning is only emitted if you actually use it.
+   *
+   * @deprecated Use {@link FxTwitter.v2} instead.
+   */
+  get v1(): FxTwitterV1;
+}
+//#endregion
 //#region src/errors.d.ts
 interface FxTwitterErrorOptions {
   /** HTTP status code returned by the API. */
@@ -17,4 +55,4 @@ declare class FxTwitterError extends Error {
   constructor(message: string, options?: FxTwitterErrorOptions);
 }
 //#endregion
-export { type AnyMedia, type Author, type ClientOptions, type CommunityNote, type ExternalMedia, type Facet, FxTwitterError, type FxTwitterErrorOptions, FxTwitterV1, type FxTwitterV1Options, type GetStatusOptions, type GetUserOptions, type MosaicPhoto, type Photo, type Poll, type PollChoice, type RawText, type RepostedBy, type StatusMedia, type StatusMessage, type StatusRawText, type StatusResponse, type Translation, type Tweet, type TwitterCard, type User, type UserResponse, type Verification, type VerificationType, type Video, type VideoFormat, type Website };
+export { type AnyMedia, type Author, type ClientOptions, type CommunityNote, type ExternalMedia, type Facet, FxTwitter, FxTwitterError, type FxTwitterErrorOptions, type FxTwitterOptions, FxTwitterV1, type FxTwitterV1Options, FxTwitterV2, type FxTwitterV2Options, type GetStatusOptions, type GetUserOptions, type MosaicPhoto, type Photo, type Poll, type PollChoice, type RawText, type RepostedBy, type StatusMedia, type StatusMessage, type StatusRawText, type StatusResponse, type Translation, type Tweet, type TwitterCard, type User, type UserResponse, type v2_d_exports as V2, type Verification, type VerificationType, type Video, type VideoFormat, type Website, byUserId };

package/dist/index.d.mts

@@ -1,4 +1,42 @@
-import { A as ClientOptions, C as User, D as Video, E as VerificationType, O as VideoFormat, S as TwitterCard, T as Verification, _ as StatusMessage, a as AnyMedia, b as Translation, c as ExternalMedia, d as Photo, f as Poll, g as StatusMedia, h as RepostedBy, i as GetUserOptions, k as Website, l as Facet, m as RawText, n as FxTwitterV1Options, o as Author, p as PollChoice, r as GetStatusOptions, s as CommunityNote, t as FxTwitterV1, u as MosaicPhoto, v as StatusRawText, w as UserResponse, x as Tweet, y as StatusResponse } from "./v1-BKUGwGbc.mjs";
+import { t as ClientOptions } from "./http-CidaL0TV.mjs";
+import { AnyMedia, Author, CommunityNote, ExternalMedia, Facet, FxTwitterV1, FxTwitterV1Options, GetStatusOptions, GetUserOptions, MosaicPhoto, Photo, Poll, PollChoice, RawText, RepostedBy, StatusMedia, StatusMessage, StatusRawText, StatusResponse, Translation, Tweet, TwitterCard, User, UserResponse, Verification, VerificationType, Video, VideoFormat, Website } from "./v1.mjs";
+import { FxTwitterV2, FxTwitterV2Options, byUserId, t as v2_d_exports } from "./v2.mjs";
+//#region src/client.d.ts
+type FxTwitterOptions = ClientOptions & {
+  /** Overrides applied only to the v1 client. */
+  v1?: Pick<ClientOptions, "baseUrl"> & {
+    /** Suppresses the one-time deprecation warning emitted when `v1` is first accessed. */
+    silenceDeprecationWarning?: boolean;
+  };
+  /** Overrides applied only to the v2 client. */
+  v2?: Pick<ClientOptions, "baseUrl">;
+};
+/**
+ * Combined client exposing every API version.
+ *
+ * Prefer importing a single version when you only need one — `FxTwitterV2`
+ * from `fxtwitter/v2` — and reach for this only when you use both.
+ *
+ * ```ts
+ * const fx = new FxTwitter();
+ * const { status } = await fx.v2.getStatus("20");
+ * const { tweet } = await fx.v1.getStatus("20");
+ * ```
+ */
+declare class FxTwitter {
+  readonly v2: FxTwitterV2;
+  private readonly v1Options;
+  private v1Client?;
+  constructor(options?: FxTwitterOptions);
+  /**
+   * The legacy v1 client, constructed on first access so its deprecation
+   * warning is only emitted if you actually use it.
+   *
+   * @deprecated Use {@link FxTwitter.v2} instead.
+   */
+  get v1(): FxTwitterV1;
+}
+//#endregion
 //#region src/errors.d.ts
 interface FxTwitterErrorOptions {
   /** HTTP status code returned by the API. */
@@ -17,4 +55,4 @@ declare class FxTwitterError extends Error {
   constructor(message: string, options?: FxTwitterErrorOptions);
 }
 //#endregion
-export { type AnyMedia, type Author, type ClientOptions, type CommunityNote, type ExternalMedia, type Facet, FxTwitterError, type FxTwitterErrorOptions, FxTwitterV1, type FxTwitterV1Options, type GetStatusOptions, type GetUserOptions, type MosaicPhoto, type Photo, type Poll, type PollChoice, type RawText, type RepostedBy, type StatusMedia, type StatusMessage, type StatusRawText, type StatusResponse, type Translation, type Tweet, type TwitterCard, type User, type UserResponse, type Verification, type VerificationType, type Video, type VideoFormat, type Website };
+export { type AnyMedia, type Author, type ClientOptions, type CommunityNote, type ExternalMedia, type Facet, FxTwitter, FxTwitterError, type FxTwitterErrorOptions, type FxTwitterOptions, FxTwitterV1, type FxTwitterV1Options, FxTwitterV2, type FxTwitterV2Options, type GetStatusOptions, type GetUserOptions, type MosaicPhoto, type Photo, type Poll, type PollChoice, type RawText, type RepostedBy, type StatusMedia, type StatusMessage, type StatusRawText, type StatusResponse, type Translation, type Tweet, type TwitterCard, type User, type UserResponse, type v2_d_exports as V2, type Verification, type VerificationType, type Video, type VideoFormat, type Website, byUserId };

package/dist/index.mjs

@@ -1,2 +1,45 @@
-import { n as FxTwitterError, t as FxTwitterV1 } from "./v1-KUPCoHD9.mjs";
-export { FxTwitterError, FxTwitterV1 };
+import { t as FxTwitterV1 } from "./v1-ByqsBlpO.mjs";
+import { n as FxTwitterError } from "./http-BTdKgEdX.mjs";
+import { FxTwitterV2, byUserId } from "./v2.mjs";
+//#region src/client.ts
+/**
+* Combined client exposing every API version.
+*
+* Prefer importing a single version when you only need one — `FxTwitterV2`
+* from `fxtwitter/v2` — and reach for this only when you use both.
+*
+* ```ts
+* const fx = new FxTwitter();
+* const { status } = await fx.v2.getStatus("20");
+* const { tweet } = await fx.v1.getStatus("20");
+* ```
+*/
+var FxTwitter = class {
+	v2;
+	v1Options;
+	v1Client;
+	constructor(options = {}) {
+		const { v1, v2, ...shared } = options;
+		this.v2 = new FxTwitterV2({
+			...shared,
+			baseUrl: v2?.baseUrl
+		});
+		this.v1Options = {
+			...shared,
+			baseUrl: v1?.baseUrl,
+			silenceDeprecationWarning: v1?.silenceDeprecationWarning
+		};
+	}
+	/**
+	* The legacy v1 client, constructed on first access so its deprecation
+	* warning is only emitted if you actually use it.
+	*
+	* @deprecated Use {@link FxTwitter.v2} instead.
+	*/
+	get v1() {
+		this.v1Client ??= new FxTwitterV1(this.v1Options);
+		return this.v1Client;
+	}
+};
+//#endregion
+export { FxTwitter, FxTwitterError, FxTwitterV1, FxTwitterV2, byUserId };

package/dist/v1-BFKgLuJi.cjs

@@ -0,0 +1,92 @@
+const require_http = require("./http-Cs4GJeg-.cjs");
+//#region src/deprecation.ts
+const emitted = /* @__PURE__ */ new Set();
+/**
+* Emits a deprecation warning once per process, the way Node's own deprecated
+* APIs (and libraries such as discord.js) do — so `--no-deprecation` and
+* `--throw-deprecation` apply, and repeated construction doesn't spam the
+* console. Falls back to `console.warn` in runtimes without
+* `process.emitWarning`.
+*/
+function emitDeprecationWarning(code, message) {
+	if (emitted.has(code)) return;
+	emitted.add(code);
+	const proc = globalThis.process;
+	if (typeof proc?.emitWarning === "function") {
+		proc.emitWarning(message, {
+			type: "DeprecationWarning",
+			code
+		});
+		return;
+	}
+	console.warn(`DeprecationWarning [${code}]: ${message}`);
+}
+//#endregion
+//#region src/v1.ts
+/**
+* The API resolves a status from the first 2-20 digit run in the path segment,
+* and answers anything else with its embed HTML at HTTP 200 rather than JSON.
+*/
+const STATUS_ID_PATTERN = /^\d{2,20}$/;
+/**
+* Handles are matched as `\w{1,15}` upstream; anything else is redirected to
+* the project's GitHub page instead of returning JSON.
+*/
+const HANDLE_PATTERN = /^\w{1,15}$/;
+const DEPRECATION_MESSAGE = "FxTwitterV1 targets the legacy FxTwitter v1 API, which is kept only for backwards compatibility and does not receive new features. Use FxTwitterV2 (import from \"fxtwitter/v2\") instead.";
+/**
+* Client for the legacy FxTwitter v1 API.
+*
+* @deprecated Use {@link import("./v2").FxTwitterV2} instead. v1 is kept only
+* for backwards compatibility and does not receive new features.
+*/
+var FxTwitterV1 = class {
+	http;
+	constructor(options = {}) {
+		if (!options.silenceDeprecationWarning) emitDeprecationWarning("FXTWITTER_V1_DEPRECATED", DEPRECATION_MESSAGE);
+		this.http = new require_http.HttpClient(options);
+	}
+	/**
+	* Fetches a single status by its snowflake ID.
+	*
+	* `GET /status/:id`, `GET /status/:id/:language`,
+	* `GET /:handle/status/:id`, `GET /:handle/status/:id/:language`
+	*/
+	async getStatus(id, options = {}) {
+		if (!STATUS_ID_PATTERN.test(id)) throw new require_http.FxTwitterError(`Invalid status ID ${JSON.stringify(id)}: expected 2-20 digits`);
+		if (options.screenName !== void 0 && options.screenName.trim() === "") throw new require_http.FxTwitterError("screenName must not be empty");
+		const segments = [
+			options.screenName,
+			"status",
+			id,
+			options.translateTo
+		].filter((segment) => segment !== void 0);
+		return requireBody(await this.http.get({
+			path: `/${segments.map(encodeURIComponent).join("/")}`,
+			signal: options.signal
+		}));
+	}
+	/** Fetches a user profile by handle (`GET /:handle`). */
+	async getUser(screenName, options = {}) {
+		assertHandle(screenName);
+		return requireBody(await this.http.get({
+			path: `/${encodeURIComponent(screenName)}`,
+			signal: options.signal
+		}));
+	}
+};
+function assertHandle(handle) {
+	if (!HANDLE_PATTERN.test(handle)) throw new require_http.FxTwitterError(`Invalid handle ${JSON.stringify(handle)}: expected 1-15 letters, digits or underscores, without a leading @`);
+}
+/** v1 never answers 204, so an empty body here means something went wrong. */
+function requireBody(body) {
+	if (body === null) throw new require_http.FxTwitterError("The API returned an empty response");
+	return body;
+}
+//#endregion
+Object.defineProperty(exports, "FxTwitterV1", {
+	enumerable: true,
+	get: function() {
+		return FxTwitterV1;
+	}
+});