fxtwitter 0.0.0-reserved → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 otoneko.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,147 @@
+# fxtwitter
+
+[![npm](https://img.shields.io/npm/v/fxtwitter)](https://www.npmjs.com/package/fxtwitter)
+[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/otnc/fxtwitter-wrapper/ci.yml?branch=main)](https://github.com/otnc/fxtwitter-wrapper/actions)
+[![GitHub](https://img.shields.io/github/license/otnc/fxtwitter-wrapper)](https://github.com/otnc/fxtwitter-wrapper/blob/main/LICENSE)
+[![Node](https://img.shields.io/node/v/fxtwitter)](https://www.npmjs.com/package/fxtwitter)
+
+Typed wrapper for the [FxTwitter](https://github.com/FxEmbed/FxEmbed) API.
+
+## Install
+
+```sh
+npm install fxtwitter
+```
+
+## Usage
+
+```ts
+import { FxTwitterV1 } from "fxtwitter";
+
+const fx = new FxTwitterV1();
+
+const { tweet } = await fx.getStatus("20");
+const { user } = await fx.getUser("jack");
+```
+
+Types can be imported alongside the client:
+
+```ts
+import { FxTwitterV1, type Tweet, type User } from "fxtwitter";
+```
+
+The client is also available from the `fxtwitter/v1` subpath, which will keep
+working unchanged as further API versions are added to the root:
+
+```ts
+import { FxTwitterV1 } from "fxtwitter/v1";
+```
+
+## API
+
+### `new FxTwitterV1(options?)`
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `baseUrl` | `string` | `https://api.fxtwitter.com` | API host, e.g. a self-hosted instance |
+| `headers` | `Record<string, string>` | — | Extra headers sent with every request |
+| `timeout` | `number` | disabled | Abort a request after this many ms |
+| `retry` | `number \| false` | `1` | Retries for failed requests |
+| `retryDelay` | `number` | `0` | Delay between retries, in ms |
+| `fetch` | `typeof fetch` | global `fetch` | Custom fetch implementation |
+
+> 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({
+>   headers: { "User-Agent": "MyApp/1.0 (+https://example.com)" },
+> });
+> ```
+>
+> Nothing is sent in browsers, where `User-Agent` is a forbidden header and the
+> browser supplies its own.
+
+### `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;
+```
+
+| Option | Type | Description |
+| --- | --- | --- |
+| `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?)`
+
+Fetches a user profile by handle, without a leading `@`.
+
+```ts
+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
+
+HTTP 4xx/5xx, network failures, timeouts, invalid input, and non-JSON responses
+are thrown as `FxTwitterError`:
+
+```ts
+import { FxTwitterError } from "fxtwitter";
+
+try {
+  await fx.getStatus("20");
+} catch (error) {
+  if (error instanceof FxTwitterError) {
+    error.status; // 404
+    error.code; // 404
+    error.message; // "NOT_FOUND"
+    error.body; // parsed response body, when available
+    error.cause; // underlying error, when available
+  }
+}
+```
+
+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
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for details.
+
+## License
+
+Distributed under the [MIT License](./LICENSE).

package/dist/index.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_v1 = require("./v1-Da3KbdIz.cjs");
+exports.FxTwitterError = require_v1.FxTwitterError;
+exports.FxTwitterV1 = require_v1.FxTwitterV1;

package/dist/index.d.cts

@@ -0,0 +1,20 @@
+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";
+//#region src/errors.d.ts
+interface FxTwitterErrorOptions {
+  /** HTTP status code returned by the API. */
+  status?: number;
+  /** `code` field from the JSON response body (mirrors the HTTP status). */
+  code?: number;
+  /** Parsed response body, when available. */
+  body?: unknown;
+  cause?: unknown;
+}
+/** Thrown for any non-2xx response, network failure, timeout, or unparsable body. */
+declare class FxTwitterError extends Error {
+  readonly status?: number;
+  readonly code?: number;
+  readonly body?: unknown;
+  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 };

package/dist/index.d.mts

@@ -0,0 +1,20 @@
+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";
+//#region src/errors.d.ts
+interface FxTwitterErrorOptions {
+  /** HTTP status code returned by the API. */
+  status?: number;
+  /** `code` field from the JSON response body (mirrors the HTTP status). */
+  code?: number;
+  /** Parsed response body, when available. */
+  body?: unknown;
+  cause?: unknown;
+}
+/** Thrown for any non-2xx response, network failure, timeout, or unparsable body. */
+declare class FxTwitterError extends Error {
+  readonly status?: number;
+  readonly code?: number;
+  readonly body?: unknown;
+  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 };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { n as FxTwitterError, t as FxTwitterV1 } from "./v1-KUPCoHD9.mjs";
+export { FxTwitterError, FxTwitterV1 };

package/dist/v1-BKUGwGbc.d.cts

@@ -0,0 +1,267 @@
+//#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
+//#region src/types/v1.d.ts
+interface Facet {
+  /** e.g. `url`, `mention`, `hashtag`, `media`. */
+  type: string;
+  /** Start/end UTF-16 indices. */
+  indices: [number, number];
+  original?: string;
+  replacement?: string;
+  display?: string;
+  id?: string;
+}
+interface RawText {
+  text: string;
+  facets: Facet[];
+}
+interface StatusRawText extends RawText {
+  display_text_range: [number, number];
+}
+interface Website {
+  url: string;
+  display_url: string;
+}
+type VerificationType = "organization" | "government" | "individual" | null;
+interface Verification {
+  verified: boolean;
+  type: VerificationType;
+  verified_at?: string | null;
+  identity_verified?: boolean;
+  verified_by?: string;
+}
+/** The author embedded in a status. Same shape as {@link User}, plus `avatar_color`. */
+interface Author {
+  id: string;
+  name: string;
+  screen_name: string;
+  url: string;
+  description: string;
+  raw_description: RawText;
+  location: string;
+  avatar_url: string | null;
+  banner_url: string | null;
+  /** @deprecated Always `null` upstream. */
+  avatar_color?: string | null;
+  followers: number;
+  following: number;
+  likes: number;
+  media_count: number;
+  joined: string;
+  protected: boolean;
+  website: Website | null;
+  verification?: Verification;
+}
+/** The user returned by `GET /:screen_name`. Uses `tweets` where v2 uses `statuses`. */
+interface User extends Author {
+  /** Status count. Named `statuses` in the v2 API. */
+  tweets: number;
+}
+interface Translation {
+  text: string;
+  source_lang: string;
+  source_lang_en: string;
+  target_lang: string;
+  provider: string;
+}
+interface PollChoice {
+  label: string;
+  count: number;
+  /** 0-100. */
+  percentage: number;
+}
+interface Poll {
+  choices: PollChoice[];
+  total_votes: number;
+  ends_at: string;
+  time_left_en: string;
+}
+interface VideoFormat {
+  container?: "mp4" | "webm" | "m3u8";
+  codec?: "h264" | "hevc" | "vp9" | "av1";
+  bitrate?: number;
+  url: string;
+  size?: number;
+  height?: number;
+  width?: number;
+}
+interface Photo {
+  id?: string;
+  /** MIME type, e.g. `image/jpeg`. */
+  format?: string;
+  type: "photo" | "gif";
+  url: string;
+  width: number;
+  height: number;
+  transcode_url?: string | null;
+  altText?: string;
+}
+interface Video {
+  id?: string;
+  /** MIME type, e.g. `video/mp4`. */
+  format?: string;
+  type: "video" | "gif";
+  url: string;
+  width: number;
+  height: number;
+  thumbnail_url?: string | null;
+  transcode_url?: string | null;
+  duration: number;
+  filesize?: number;
+  formats?: VideoFormat[];
+}
+interface MosaicPhoto {
+  id?: string;
+  type: "mosaic_photo";
+  url?: string;
+  width: number;
+  height: number;
+  formats: {
+    webp: string;
+    jpeg: string;
+  };
+}
+interface ExternalMedia {
+  /** Currently always `video`. */
+  type: string;
+  url: string;
+  thumbnail_url?: string;
+  height?: number;
+  width?: number;
+  duration?: number;
+}
+type AnyMedia = Photo | Video | MosaicPhoto;
+interface StatusMedia {
+  /** Preserves the original ordering across photos and videos. */
+  all?: AnyMedia[];
+  external?: ExternalMedia;
+  photos?: Photo[];
+  videos?: Video[];
+  mosaic?: MosaicPhoto;
+}
+interface CommunityNote {
+  text: string;
+  facets: Facet[];
+}
+interface RepostedBy {
+  id: string;
+  name: string;
+  screen_name: string;
+  avatar_url?: string | null;
+  url?: string;
+}
+type TwitterCard = "tweet" | "summary" | "summary_large_image" | "player";
+interface Tweet {
+  id: string;
+  url: string;
+  text: string;
+  raw_text: StatusRawText;
+  created_at: string;
+  created_timestamp: number;
+  author: Author;
+  likes: number;
+  /** Named `reposts` in the v2 API. */
+  retweets: number;
+  replies: number;
+  quotes: number;
+  views: number | null;
+  bookmarks?: number | null;
+  lang: string | null;
+  /** Screen name of the account being replied to. An object in the v2 API. */
+  replying_to: string | null;
+  /** Status ID being replied to. Folded into `replying_to` in the v2 API. */
+  replying_to_status: string | null;
+  source: string | null;
+  /** Named `embed_card` in the v2 API. */
+  twitter_card: TwitterCard;
+  provider?: string;
+  possibly_sensitive?: boolean;
+  is_note_tweet: boolean;
+  community_note: CommunityNote | null;
+  reposted_by: RepostedBy | null;
+  /** @deprecated Always `null` upstream. */
+  color?: string | null;
+  quote?: Tweet;
+  poll?: Poll;
+  /** Only present when a translation target was requested. */
+  translation?: Translation;
+  media?: StatusMedia;
+}
+/**
+ * `message` values the API maps onto its status codes: 200, 401, 404, 503
+ * and 500 respectively.
+ */
+type StatusMessage = "OK" | "PRIVATE_TWEET" | "NOT_FOUND" | "UPSTREAM_UNAVAILABLE" | "API_FAIL";
+interface StatusResponse {
+  /** Mirrors the HTTP status code. */
+  code: number;
+  message: StatusMessage | string;
+  /** `null` when the status could not be retrieved. */
+  tweet: Tweet | null;
+}
+interface UserResponse {
+  /** Mirrors the HTTP status code. */
+  code: number;
+  message: string;
+  /** Omitted entirely when the user could not be retrieved. */
+  user?: User;
+  /** Set to `suspended` when the account is suspended. */
+  reason?: "suspended";
+}
+//#endregion
+//#region src/v1.d.ts
+type FxTwitterV1Options = ClientOptions;
+interface GetStatusOptions {
+  /**
+   * Included in the URL for readability only. The API resolves the status from
+   * `id` alone and never validates this, so a wrong handle still succeeds.
+   */
+  screenName?: string;
+  /**
+   * Language to translate the status into, as an ISO 639-1 code (`es`) or a
+   * locale (`zh-cn`). Adds a `translation` object to the returned status.
+   */
+  translateTo?: string;
+  /** Per-call cancellation, composed with the client-level `timeout`. */
+  signal?: AbortSignal;
+}
+interface GetUserOptions {
+  signal?: AbortSignal;
+}
+/** Client for the FxTwitter v1 API. */
+declare class FxTwitterV1 {
+  private readonly http;
+  constructor(options?: FxTwitterV1Options);
+  /**
+   * Fetches a single status by its snowflake ID.
+   *
+   * `GET /status/:id`, `GET /status/:id/:language`,
+   * `GET /:handle/status/:id`, `GET /:handle/status/:id/:language`
+   */
+  getStatus(id: string, options?: GetStatusOptions): Promise<StatusResponse>;
+  /** Fetches a user profile by handle (`GET /:handle`). */
+  getUser(screenName: string, options?: GetUserOptions): Promise<UserResponse>;
+}
+//#endregion
+export { ClientOptions as A, User as C, Video as D, VerificationType as E, VideoFormat as O, TwitterCard as S, Verification as T, StatusMessage as _, AnyMedia as a, Translation as b, ExternalMedia as c, Photo as d, Poll as f, StatusMedia as g, RepostedBy as h, GetUserOptions as i, Website as k, Facet as l, RawText as m, FxTwitterV1Options as n, Author as o, PollChoice as p, GetStatusOptions as r, CommunityNote as s, FxTwitterV1 as t, MosaicPhoto as u, StatusRawText as v, UserResponse as w, Tweet as x, StatusResponse as y };

package/dist/v1-BKUGwGbc.d.mts

@@ -0,0 +1,267 @@
+//#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
+//#region src/types/v1.d.ts
+interface Facet {
+  /** e.g. `url`, `mention`, `hashtag`, `media`. */
+  type: string;
+  /** Start/end UTF-16 indices. */
+  indices: [number, number];
+  original?: string;
+  replacement?: string;
+  display?: string;
+  id?: string;
+}
+interface RawText {
+  text: string;
+  facets: Facet[];
+}
+interface StatusRawText extends RawText {
+  display_text_range: [number, number];
+}
+interface Website {
+  url: string;
+  display_url: string;
+}
+type VerificationType = "organization" | "government" | "individual" | null;
+interface Verification {
+  verified: boolean;
+  type: VerificationType;
+  verified_at?: string | null;
+  identity_verified?: boolean;
+  verified_by?: string;
+}
+/** The author embedded in a status. Same shape as {@link User}, plus `avatar_color`. */
+interface Author {
+  id: string;
+  name: string;
+  screen_name: string;
+  url: string;
+  description: string;
+  raw_description: RawText;
+  location: string;
+  avatar_url: string | null;
+  banner_url: string | null;
+  /** @deprecated Always `null` upstream. */
+  avatar_color?: string | null;
+  followers: number;
+  following: number;
+  likes: number;
+  media_count: number;
+  joined: string;
+  protected: boolean;
+  website: Website | null;
+  verification?: Verification;
+}
+/** The user returned by `GET /:screen_name`. Uses `tweets` where v2 uses `statuses`. */
+interface User extends Author {
+  /** Status count. Named `statuses` in the v2 API. */
+  tweets: number;
+}
+interface Translation {
+  text: string;
+  source_lang: string;
+  source_lang_en: string;
+  target_lang: string;
+  provider: string;
+}
+interface PollChoice {
+  label: string;
+  count: number;
+  /** 0-100. */
+  percentage: number;
+}
+interface Poll {
+  choices: PollChoice[];
+  total_votes: number;
+  ends_at: string;
+  time_left_en: string;
+}
+interface VideoFormat {
+  container?: "mp4" | "webm" | "m3u8";
+  codec?: "h264" | "hevc" | "vp9" | "av1";
+  bitrate?: number;
+  url: string;
+  size?: number;
+  height?: number;
+  width?: number;
+}
+interface Photo {
+  id?: string;
+  /** MIME type, e.g. `image/jpeg`. */
+  format?: string;
+  type: "photo" | "gif";
+  url: string;
+  width: number;
+  height: number;
+  transcode_url?: string | null;
+  altText?: string;
+}
+interface Video {
+  id?: string;
+  /** MIME type, e.g. `video/mp4`. */
+  format?: string;
+  type: "video" | "gif";
+  url: string;
+  width: number;
+  height: number;
+  thumbnail_url?: string | null;
+  transcode_url?: string | null;
+  duration: number;
+  filesize?: number;
+  formats?: VideoFormat[];
+}
+interface MosaicPhoto {
+  id?: string;
+  type: "mosaic_photo";
+  url?: string;
+  width: number;
+  height: number;
+  formats: {
+    webp: string;
+    jpeg: string;
+  };
+}
+interface ExternalMedia {
+  /** Currently always `video`. */
+  type: string;
+  url: string;
+  thumbnail_url?: string;
+  height?: number;
+  width?: number;
+  duration?: number;
+}
+type AnyMedia = Photo | Video | MosaicPhoto;
+interface StatusMedia {
+  /** Preserves the original ordering across photos and videos. */
+  all?: AnyMedia[];
+  external?: ExternalMedia;
+  photos?: Photo[];
+  videos?: Video[];
+  mosaic?: MosaicPhoto;
+}
+interface CommunityNote {
+  text: string;
+  facets: Facet[];
+}
+interface RepostedBy {
+  id: string;
+  name: string;
+  screen_name: string;
+  avatar_url?: string | null;
+  url?: string;
+}
+type TwitterCard = "tweet" | "summary" | "summary_large_image" | "player";
+interface Tweet {
+  id: string;
+  url: string;
+  text: string;
+  raw_text: StatusRawText;
+  created_at: string;
+  created_timestamp: number;
+  author: Author;
+  likes: number;
+  /** Named `reposts` in the v2 API. */
+  retweets: number;
+  replies: number;
+  quotes: number;
+  views: number | null;
+  bookmarks?: number | null;
+  lang: string | null;
+  /** Screen name of the account being replied to. An object in the v2 API. */
+  replying_to: string | null;
+  /** Status ID being replied to. Folded into `replying_to` in the v2 API. */
+  replying_to_status: string | null;
+  source: string | null;
+  /** Named `embed_card` in the v2 API. */
+  twitter_card: TwitterCard;
+  provider?: string;
+  possibly_sensitive?: boolean;
+  is_note_tweet: boolean;
+  community_note: CommunityNote | null;
+  reposted_by: RepostedBy | null;
+  /** @deprecated Always `null` upstream. */
+  color?: string | null;
+  quote?: Tweet;
+  poll?: Poll;
+  /** Only present when a translation target was requested. */
+  translation?: Translation;
+  media?: StatusMedia;
+}
+/**
+ * `message` values the API maps onto its status codes: 200, 401, 404, 503
+ * and 500 respectively.
+ */
+type StatusMessage = "OK" | "PRIVATE_TWEET" | "NOT_FOUND" | "UPSTREAM_UNAVAILABLE" | "API_FAIL";
+interface StatusResponse {
+  /** Mirrors the HTTP status code. */
+  code: number;
+  message: StatusMessage | string;
+  /** `null` when the status could not be retrieved. */
+  tweet: Tweet | null;
+}
+interface UserResponse {
+  /** Mirrors the HTTP status code. */
+  code: number;
+  message: string;
+  /** Omitted entirely when the user could not be retrieved. */
+  user?: User;
+  /** Set to `suspended` when the account is suspended. */
+  reason?: "suspended";
+}
+//#endregion
+//#region src/v1.d.ts
+type FxTwitterV1Options = ClientOptions;
+interface GetStatusOptions {
+  /**
+   * Included in the URL for readability only. The API resolves the status from
+   * `id` alone and never validates this, so a wrong handle still succeeds.
+   */
+  screenName?: string;
+  /**
+   * Language to translate the status into, as an ISO 639-1 code (`es`) or a
+   * locale (`zh-cn`). Adds a `translation` object to the returned status.
+   */
+  translateTo?: string;
+  /** Per-call cancellation, composed with the client-level `timeout`. */
+  signal?: AbortSignal;
+}
+interface GetUserOptions {
+  signal?: AbortSignal;
+}
+/** Client for the FxTwitter v1 API. */
+declare class FxTwitterV1 {
+  private readonly http;
+  constructor(options?: FxTwitterV1Options);
+  /**
+   * Fetches a single status by its snowflake ID.
+   *
+   * `GET /status/:id`, `GET /status/:id/:language`,
+   * `GET /:handle/status/:id`, `GET /:handle/status/:id/:language`
+   */
+  getStatus(id: string, options?: GetStatusOptions): Promise<StatusResponse>;
+  /** Fetches a user profile by handle (`GET /:handle`). */
+  getUser(screenName: string, options?: GetUserOptions): Promise<UserResponse>;
+}
+//#endregion
+export { ClientOptions as A, User as C, Video as D, VerificationType as E, VideoFormat as O, TwitterCard as S, Verification as T, StatusMessage as _, AnyMedia as a, Translation as b, ExternalMedia as c, Photo as d, Poll as f, StatusMedia as g, RepostedBy as h, GetUserOptions as i, Website as k, Facet as l, RawText as m, FxTwitterV1Options as n, Author as o, PollChoice as p, GetStatusOptions as r, CommunityNote as s, FxTwitterV1 as t, MosaicPhoto as u, StatusRawText as v, UserResponse as w, Tweet as x, StatusResponse as y };

package/dist/v1-Da3KbdIz.cjs

@@ -0,0 +1,213 @@
+let defu = require("defu");
+let ofetch = require("ofetch");
+let std_env = require("std-env");
+//#region src/errors.ts
+/** Thrown for any non-2xx response, network failure, timeout, or unparsable body. */
+var FxTwitterError = class extends Error {
+	status;
+	code;
+	body;
+	constructor(message, options = {}) {
+		super(message, options.cause !== void 0 ? { cause: options.cause } : void 0);
+		this.name = "FxTwitterError";
+		this.status = options.status;
+		this.code = options.code;
+		this.body = options.body;
+	}
+};
+//#endregion
+//#region src/user-agent.ts
+/** Reads a version off a runtime global without assuming it exists. */
+function globalVersion(name, path) {
+	let value = globalThis[name];
+	for (const key of path) {
+		if (typeof value !== "object" || value === null) return null;
+		value = value[key];
+	}
+	return typeof value === "string" ? value : null;
+}
+function product(name, version) {
+	return version ? `${name}/${version}` : name;
+}
+/**
+* A `User-Agent` describing the runtime the request is made from, such as
+* `Node.js/22.16.0`, `Bun/1.3.0` or `Cloudflare-Workers`.
+*
+* The API requires callers to identify themselves and answers `401` otherwise.
+* Runtimes that fill the header in do so very tersely — Node sends just `node`
+* — so this states the runtime and version instead. It deliberately says
+* nothing about this package.
+*
+* Returns `null` in browsers, where `User-Agent` is a forbidden header: the
+* request carries the browser's own regardless, and setting it only logs a
+* warning.
+*/
+function environmentUserAgent() {
+	if (std_env.hasWindow) return null;
+	switch (std_env.runtime) {
+		case "node": return product("Node.js", std_env.nodeVersion);
+		case "bun": return product("Bun", globalVersion("Bun", ["version"]));
+		case "deno": return product("Deno", globalVersion("Deno", ["version", "deno"]));
+		case "workerd": return "Cloudflare-Workers";
+		case "edge-light": return "Vercel-Edge";
+		case "fastly": return "Fastly-Compute";
+		case "netlify": return "Netlify-Edge";
+		default: return std_env.runtime || null;
+	}
+}
+/** Header lookup that ignores case, as HTTP header names are case-insensitive. */
+function hasHeader(headers, name) {
+	if (!headers) return false;
+	const wanted = name.toLowerCase();
+	return Object.keys(headers).some((key) => key.toLowerCase() === wanted);
+}
+//#endregion
+//#region src/http.ts
+const DEFAULT_BASE_URL = "https://api.fxtwitter.com";
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+/**
+* Wraps ofetch with the conventions shared by the clients: `null` for 204
+* responses, and `FxTwitterError` for everything that fails.
+*/
+var HttpClient = class {
+	request;
+	constructor(options = {}) {
+		const headers = { ...options.headers };
+		if (!hasHeader(headers, "User-Agent")) {
+			const userAgent = environmentUserAgent();
+			if (userAgent) headers["User-Agent"] = userAgent;
+		}
+		const globalOptions = { defaults: (0, defu.defu)({
+			baseURL: options.baseUrl,
+			headers,
+			timeout: options.timeout,
+			retry: options.retry,
+			retryDelay: options.retryDelay
+		}, { baseURL: DEFAULT_BASE_URL }) };
+		if (options.fetch) globalOptions.fetch = options.fetch;
+		this.request = (0, ofetch.createFetch)(globalOptions);
+	}
+	/** Runs a GET request and returns the parsed JSON body, or `null` on a 204. */
+	async get(options) {
+		let response;
+		try {
+			response = await this.request.raw(options.path, {
+				query: options.query,
+				signal: options.signal
+			});
+		} catch (cause) {
+			throw toFxTwitterError(cause);
+		}
+		if (response.status === 204) return null;
+		const body = response._data;
+		if (!isRecord(body)) throw new FxTwitterError(nonJsonMessage(body, response.status), {
+			status: response.status,
+			body
+		});
+		return body;
+	}
+};
+function nonJsonMessage(body, status) {
+	return `Expected a JSON response but got ${typeof body === "string" ? body.trimStart().startsWith("<") ? "an HTML document" : "a plain text body" : `a ${typeof body} body`} (HTTP ${status}). The endpoint may not exist, or the request was redirected.`;
+}
+/** ofetch wraps aborts in a FetchError, so the original name lives on `cause`. */
+function isAbort(error) {
+	const names = /* @__PURE__ */ new Set(["AbortError", "TimeoutError"]);
+	if (names.has(error.name)) return true;
+	const cause = error.cause;
+	return isRecord(cause) && typeof cause.name === "string" ? names.has(cause.name) : false;
+}
+function toFxTwitterError(cause) {
+	if (cause instanceof FxTwitterError) return cause;
+	if (!(cause instanceof Error)) return new FxTwitterError("Network request failed", { cause });
+	if (isAbort(cause)) return new FxTwitterError("Request aborted or timed out", { cause });
+	if (!(cause instanceof ofetch.FetchError)) return new FxTwitterError(cause.message, { cause });
+	const status = cause.status ?? cause.response?.status;
+	const data = cause.data;
+	if (isRecord(data)) return new FxTwitterError(typeof data.message === "string" ? data.message : typeof data.error === "string" ? data.error : `Request failed with HTTP ${status ?? "error"}`, {
+		status,
+		code: typeof data.code === "number" ? data.code : void 0,
+		body: data,
+		cause
+	});
+	if (data !== void 0 && status !== void 0) return new FxTwitterError(nonJsonMessage(data, status), {
+		status,
+		body: data,
+		cause
+	});
+	return new FxTwitterError(cause.message, {
+		status,
+		body: data,
+		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", {
+	enumerable: true,
+	get: function() {
+		return FxTwitterV1;
+	}
+});

package/dist/v1-KUPCoHD9.mjs

@@ -0,0 +1,202 @@
+import { defu } from "defu";
+import { FetchError, createFetch } from "ofetch";
+import { hasWindow, nodeVersion, runtime } from "std-env";
+//#region src/errors.ts
+/** Thrown for any non-2xx response, network failure, timeout, or unparsable body. */
+var FxTwitterError = class extends Error {
+	status;
+	code;
+	body;
+	constructor(message, options = {}) {
+		super(message, options.cause !== void 0 ? { cause: options.cause } : void 0);
+		this.name = "FxTwitterError";
+		this.status = options.status;
+		this.code = options.code;
+		this.body = options.body;
+	}
+};
+//#endregion
+//#region src/user-agent.ts
+/** Reads a version off a runtime global without assuming it exists. */
+function globalVersion(name, path) {
+	let value = globalThis[name];
+	for (const key of path) {
+		if (typeof value !== "object" || value === null) return null;
+		value = value[key];
+	}
+	return typeof value === "string" ? value : null;
+}
+function product(name, version) {
+	return version ? `${name}/${version}` : name;
+}
+/**
+* A `User-Agent` describing the runtime the request is made from, such as
+* `Node.js/22.16.0`, `Bun/1.3.0` or `Cloudflare-Workers`.
+*
+* The API requires callers to identify themselves and answers `401` otherwise.
+* Runtimes that fill the header in do so very tersely — Node sends just `node`
+* — so this states the runtime and version instead. It deliberately says
+* nothing about this package.
+*
+* Returns `null` in browsers, where `User-Agent` is a forbidden header: the
+* request carries the browser's own regardless, and setting it only logs a
+* warning.
+*/
+function environmentUserAgent() {
+	if (hasWindow) return null;
+	switch (runtime) {
+		case "node": return product("Node.js", nodeVersion);
+		case "bun": return product("Bun", globalVersion("Bun", ["version"]));
+		case "deno": return product("Deno", globalVersion("Deno", ["version", "deno"]));
+		case "workerd": return "Cloudflare-Workers";
+		case "edge-light": return "Vercel-Edge";
+		case "fastly": return "Fastly-Compute";
+		case "netlify": return "Netlify-Edge";
+		default: return runtime || null;
+	}
+}
+/** Header lookup that ignores case, as HTTP header names are case-insensitive. */
+function hasHeader(headers, name) {
+	if (!headers) return false;
+	const wanted = name.toLowerCase();
+	return Object.keys(headers).some((key) => key.toLowerCase() === wanted);
+}
+//#endregion
+//#region src/http.ts
+const DEFAULT_BASE_URL = "https://api.fxtwitter.com";
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+/**
+* Wraps ofetch with the conventions shared by the clients: `null` for 204
+* responses, and `FxTwitterError` for everything that fails.
+*/
+var HttpClient = class {
+	request;
+	constructor(options = {}) {
+		const headers = { ...options.headers };
+		if (!hasHeader(headers, "User-Agent")) {
+			const userAgent = environmentUserAgent();
+			if (userAgent) headers["User-Agent"] = userAgent;
+		}
+		const globalOptions = { defaults: defu({
+			baseURL: options.baseUrl,
+			headers,
+			timeout: options.timeout,
+			retry: options.retry,
+			retryDelay: options.retryDelay
+		}, { baseURL: DEFAULT_BASE_URL }) };
+		if (options.fetch) globalOptions.fetch = options.fetch;
+		this.request = createFetch(globalOptions);
+	}
+	/** Runs a GET request and returns the parsed JSON body, or `null` on a 204. */
+	async get(options) {
+		let response;
+		try {
+			response = await this.request.raw(options.path, {
+				query: options.query,
+				signal: options.signal
+			});
+		} catch (cause) {
+			throw toFxTwitterError(cause);
+		}
+		if (response.status === 204) return null;
+		const body = response._data;
+		if (!isRecord(body)) throw new FxTwitterError(nonJsonMessage(body, response.status), {
+			status: response.status,
+			body
+		});
+		return body;
+	}
+};
+function nonJsonMessage(body, status) {
+	return `Expected a JSON response but got ${typeof body === "string" ? body.trimStart().startsWith("<") ? "an HTML document" : "a plain text body" : `a ${typeof body} body`} (HTTP ${status}). The endpoint may not exist, or the request was redirected.`;
+}
+/** ofetch wraps aborts in a FetchError, so the original name lives on `cause`. */
+function isAbort(error) {
+	const names = /* @__PURE__ */ new Set(["AbortError", "TimeoutError"]);
+	if (names.has(error.name)) return true;
+	const cause = error.cause;
+	return isRecord(cause) && typeof cause.name === "string" ? names.has(cause.name) : false;
+}
+function toFxTwitterError(cause) {
+	if (cause instanceof FxTwitterError) return cause;
+	if (!(cause instanceof Error)) return new FxTwitterError("Network request failed", { cause });
+	if (isAbort(cause)) return new FxTwitterError("Request aborted or timed out", { cause });
+	if (!(cause instanceof FetchError)) return new FxTwitterError(cause.message, { cause });
+	const status = cause.status ?? cause.response?.status;
+	const data = cause.data;
+	if (isRecord(data)) return new FxTwitterError(typeof data.message === "string" ? data.message : typeof data.error === "string" ? data.error : `Request failed with HTTP ${status ?? "error"}`, {
+		status,
+		code: typeof data.code === "number" ? data.code : void 0,
+		body: data,
+		cause
+	});
+	if (data !== void 0 && status !== void 0) return new FxTwitterError(nonJsonMessage(data, status), {
+		status,
+		body: data,
+		cause
+	});
+	return new FxTwitterError(cause.message, {
+		status,
+		body: data,
+		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 };

package/dist/v1.cjs

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_v1 = require("./v1-Da3KbdIz.cjs");
+exports.FxTwitterV1 = require_v1.FxTwitterV1;

package/dist/v1.d.cts

@@ -0,0 +1,2 @@
+import { 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";
+export { type AnyMedia, type Author, type CommunityNote, type ExternalMedia, type Facet, FxTwitterV1, FxTwitterV1Options, GetStatusOptions, 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 };

package/dist/v1.d.mts

@@ -0,0 +1,2 @@
+import { 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";
+export { type AnyMedia, type Author, type CommunityNote, type ExternalMedia, type Facet, FxTwitterV1, FxTwitterV1Options, GetStatusOptions, 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 };

package/dist/v1.mjs

@@ -0,0 +1,2 @@
+import { t as FxTwitterV1 } from "./v1-KUPCoHD9.mjs";
+export { FxTwitterV1 };

package/package.json

@@ -1,19 +1,84 @@
 {
   "name": "fxtwitter",
-  "version": "0.0.0-reserved",
-  "main": "index.js",
-  "scripts": {
-    "help": "node scripts/main.js --help",
-    "reserve": "node scripts/main.js"
+  "version": "1.0.0",
+  "description": "Typed wrapper for the FxTwitter API.",
+  "keywords": [
+    "x",
+    "twitter",
+    "fxtwitter",
+    "wrapper",
+    "api"
+  ],
+  "homepage": "https://github.com/otnc/fxtwitter-wrapper#readme",
+  "bugs": {
+    "url": "https://github.com/otnc/fxtwitter-wrapper/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/otnc/fxtwitter-wrapper.git"
+  },
+  "license": "MIT",
+  "author": "otoneko.",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/index.d.mts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./v1": {
+      "types": {
+        "import": "./dist/v1.d.mts",
+        "require": "./dist/v1.d.cts"
+      },
+      "import": "./dist/v1.mjs",
+      "require": "./dist/v1.cjs"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
-    "index.js"
+    "dist"
   ],
-  "keywords": [],
-  "author": "otoneko.",
-  "description": "[Reserved]",
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "setup": "node scripts/setup.js",
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix .",
+    "check": "prettier --write . && eslint --fix .",
+    "ci": "prettier --check . && eslint .",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "defu": "^6.1.7",
+    "ofetch": "^1.5.1",
+    "std-env": "^4.2.0"
+  },
   "devDependencies": {
-    "consola": "^3.4.2",
-    "dotenv": "^17.3.1"
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.20.1",
+    "@vitest/coverage-v8": "^4.1.10",
+    "eslint": "^10.8.0",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.8.0",
+    "prettier": "^3.9.6",
+    "tsdown": "^0.22.14",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.65.0",
+    "vitest": "^4.1.10"
   }
-}
+}

package/index.js

@@ -1 +0,0 @@
-module.exports = console.log("fxtwitter is reserved for otoneko.");