jerrysniffs-node-sdk 1.0.0

package/README.md

@@ -0,0 +1,179 @@
+# jerrysniffs-node-sdk
+
+Official Node.js SDK for the [JerrySniffs](https://jerrysniffs.online) API. 
+
+Provides typed access to web search, Twitter/X search & tweet lookup, Reddit post search, URL-to-Markdown conversion, and API call logs.
+
+For detailed docs, refer [JerrySniffs Docs](https://jerrysniffs.online/docs)
+
+## Install
+
+```bash
+npm install jerrysniffs-node-sdk
+```
+
+## Quick start
+
+```ts
+import JerrySniffs from "jerrysniffs-node-sdk";
+
+const client = new JerrySniffs({ apiKey: "YOUR_API_TOKEN" });
+
+// Web search
+const results = await client.search.search("site:docs.stripe.com webhooks");
+console.log(results.urls);
+
+// Twitter search
+const tweets = await client.twitter.search("openai agents", { limit: 5 });
+console.log(tweets.tweets);
+
+// Tweet lookup
+const tweet = await client.twitter.lookup("1234567890123456789");
+console.log(tweet.tweet);
+
+// Reddit search
+const posts = await client.reddit.searchPosts("best docs search api", {
+  subreddit: "SaaS",
+  sort: "top",
+  time: "month",
+});
+console.log(posts.posts);
+
+// URL to Markdown
+const md = await client.urlToMarkdown.convert("https://example.com");
+console.log(md.markdown);
+
+// Call logs
+const logs = await client.callLogs.list({ page: 1, limit: 10 });
+console.log(logs.rows);
+```
+
+## Authentication
+
+All requests use an API token passed via `Authorization: Bearer`. Create a token in the JerrySniffs dashboard or via the `/api/v1/auth/api-tokens` endpoint.
+
+## Configuration
+
+```ts
+const client = new JerrySniffs({
+  apiKey: "YOUR_API_TOKEN",       // required
+  baseUrl: "https://jerrysniffs.online", // optional, this is the default
+});
+```
+
+## API Reference
+
+### `client.search.search(query, options?)`
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `query` | `string` | Search query (required) |
+| `options.limit` | `number` | Max results (1–50) |
+| `options.country` | `string` | Country code, e.g. `"US"` |
+| `options.page` | `number` | Page number (1-based) |
+| `options.start` | `number` | Result offset |
+| `options.tbs` | `string` | Time-based search filter, e.g. `"qdr:w"` |
+
+Returns `SearchResponse`: `{ ok, query, urls, count }`
+
+---
+
+### `client.twitter.search(query, options?)`
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `query` | `string` | Search query (required) |
+| `options.searchType` | `"Top" \| "Latest"` | Result type |
+| `options.limit` | `number` | Max results (1–50) |
+
+Returns `TwitterSearchResponse`: `{ ok, tweets }` where each tweet is an `ApiTweet`.
+
+### `client.twitter.lookup(id)`
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `id` | `string` | Numeric tweet ID (required) |
+
+Returns `TweetLookupResponse`: `{ ok, tweet }` where tweet is an `ApiTweet`.
+
+---
+
+### `client.reddit.searchPosts(query, options?)`
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `query` | `string` | Search query (required) |
+| `options.subreddit` | `string` | Restrict to subreddit |
+| `options.sort` | `"relevance" \| "hot" \| "top" \| "new" \| "comments"` | Sort order |
+| `options.time` | `"hour" \| "day" \| "week" \| "month" \| "year" \| "all"` | Time range |
+| `options.limit` | `number` | Max results (1–50) |
+
+Returns `RedditSearchPostsResponse`: `{ ok, posts }`
+
+---
+
+### `client.urlToMarkdown.convert(url, options?)`
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `url` | `string` | URL to convert (required). Supports HTML, plain text, PDF, DOC, DOCX |
+| `options.proxy` | `string` | Proxy URL, e.g. `"http://user:pass@proxy:8080"` |
+
+Returns `UrlToMarkdownResponse`: `{ ok, url, markdown, is_proxy_used }`
+
+---
+
+### `client.callLogs.list(options?)`
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `options.q` | `string` | Full-text search across logs |
+| `options.endpoint` | `string` | Filter by endpoint name |
+| `options.status` | `"success" \| "failure"` | Filter by status |
+| `options.page` | `number` | Page number (1-based) |
+| `options.limit` | `number` | Page size |
+| `options.sort_by` | `"created_at" \| "endpoint" \| "status" \| "http_code" \| "duration_ms"` | Sort column |
+| `options.sort_dir` | `"asc" \| "desc"` | Sort direction |
+
+Returns `CallLogsResponse`: `{ rows, page, limit, total, totalPages }`
+
+## Error handling
+
+The SDK throws `ApiError` for non-2xx responses:
+
+```ts
+import { ApiError } from "jerrysniffs-node-sdk";
+
+try {
+  await client.search.search("test");
+} catch (err) {
+  if (err instanceof ApiError) {
+    console.error(err.status); // HTTP status code
+    console.error(err.body);   // Parsed response body
+  }
+}
+```
+
+## TypeScript types
+
+All request options and response types are exported:
+
+```ts
+import type {
+  SearchResponse,
+  ApiTweet,
+  ApiTweetAuthor,
+  ApiTweetMetrics,
+  RedditPost,
+  UrlToMarkdownResponse,
+  CallLogsResponse,
+  Tweet,
+  TweetAuthor,
+  TweetMedia,
+  TweetPublicMetrics,
+} from "jerrysniffs-node-sdk";
+```
+
+## License
+
+ISC

package/dist/client.d.ts

@@ -0,0 +1,15 @@
+import type { JerrySniffsConfig } from "./types.js";
+export declare class ApiError extends Error {
+    status: number;
+    body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+export declare class HttpClient {
+    private apiKey;
+    private baseUrl;
+    constructor(config: JerrySniffsConfig);
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    get<T>(path: string): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD,qBAAa,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;gBAEF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAM3D;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,iBAAiB;IAQ/B,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,CAAC,CAAC;IAgCb,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAGjC"}

package/dist/client.js

@@ -0,0 +1,48 @@
+const DEFAULT_BASE_URL = "https://jerrysniffs.online";
+export class ApiError extends Error {
+    constructor(message, status, body) {
+        super(message);
+        this.name = "ApiError";
+        this.status = status;
+        this.body = body;
+    }
+}
+export class HttpClient {
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new Error("apiKey is required");
+        }
+        this.apiKey = config.apiKey;
+        this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+        };
+        const init = { method, headers };
+        if (body !== undefined) {
+            headers["Content-Type"] = "application/json";
+            init.body = JSON.stringify(body);
+        }
+        const res = await fetch(url, init);
+        if (!res.ok) {
+            let errorBody;
+            try {
+                errorBody = await res.json();
+            }
+            catch {
+                errorBody = await res.text().catch(() => null);
+            }
+            throw new ApiError(`JerrySniffs API error: ${res.status} ${res.statusText}`, res.status, errorBody);
+        }
+        return res.json();
+    }
+    post(path, body) {
+        return this.request("POST", path, body);
+    }
+    get(path) {
+        return this.request("GET", path);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAEtD,MAAM,OAAO,QAAS,SAAQ,KAAK;IAIjC,YAAY,OAAe,EAAE,MAAc,EAAE,IAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,UAAU;IAIrB,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,OAAO,CACX,MAAc,EACd,IAAY,EACZ,IAAc;QAEd,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QACrC,MAAM,OAAO,GAA2B;YACtC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;SACvC,CAAC;QAEF,MAAM,IAAI,GAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAE9C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;YAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAEnC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,SAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,SAAS,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACjD,CAAC;YACD,MAAM,IAAI,QAAQ,CAChB,0BAA0B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,EACxD,GAAG,CAAC,MAAM,EACV,SAAS,CACV,CAAC;QACJ,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;IAClC,CAAC;IAED,IAAI,CAAI,IAAY,EAAE,IAAc;QAClC,OAAO,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,GAAG,CAAI,IAAY;QACjB,OAAO,IAAI,CAAC,OAAO,CAAI,KAAK,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { Search } from "./resources/search.js";
+import { Twitter } from "./resources/twitter.js";
+import { Reddit } from "./resources/reddit.js";
+import { UrlToMarkdown } from "./resources/url-to-markdown.js";
+import { CallLogs } from "./resources/call-logs.js";
+import type { JerrySniffsConfig } from "./types.js";
+export declare class JerrySniffs {
+    readonly search: Search;
+    readonly twitter: Twitter;
+    readonly reddit: Reddit;
+    readonly urlToMarkdown: UrlToMarkdown;
+    readonly callLogs: CallLogs;
+    constructor(config: JerrySniffsConfig);
+}
+export { ApiError } from "./client.js";
+export type { JerrySniffsConfig, SearchResponse, SearchOptions, UrlToMarkdownResponse, UrlToMarkdownOptions, TwitterSearchResponse, TwitterSearchOptions, TweetLookupResponse, RedditSearchPostsResponse, RedditSearchPostsOptions, CallLogsResponse, CallLogsOptions, CallLog, ApiTweet, ApiTweetAuthor, ApiTweetMetrics, ApiTweetMedia, ApiMediaVariant, RedditPost, RedditAuthorInfo, RedditSubreddit, } from "./types.js";
+export type { LanguageCode, SnowflakeId, TwitterDateString, ISODateString, MediaType, ContentType, ReplySettings, TweetType, MediaVariant, TweetMedia, UrlEntity, HashtagEntity, MentionEntity, CashtagEntity, AnnotationEntity, TweetEntities, TweetAuthor, TweetPublicMetrics, TweetNonPublicMetrics, TweetOrganicMetrics, TweetPromotedMetrics, Coordinates, BoundingBox, TweetPlace, ReferencedTweet, ContextAnnotation, PollOption, TweetPoll, WithheldInfo, Tweet, TwitterApiResponse, VideoMedia, PhotoMedia, AnimatedGifMedia, } from "./types.js";
+export { isVideoMedia, isPhotoMedia, isAnimatedGif, getHighestQualityVariant, } from "./types.js";
+export default JerrySniffs;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAEhB,MAAM,EAAE,iBAAiB;CAQtC;AAED,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,EACf,OAAO,EACP,QAAQ,EACR,cAAc,EACd,eAAe,EACf,aAAa,EACb,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,SAAS,EACT,WAAW,EACX,aAAa,EACb,SAAS,EACT,YAAY,EACZ,UAAU,EACV,SAAS,EACT,aAAa,EACb,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,YAAY,EACZ,KAAK,EACL,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,eAAe,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+import { HttpClient } from "./client.js";
+import { Search } from "./resources/search.js";
+import { Twitter } from "./resources/twitter.js";
+import { Reddit } from "./resources/reddit.js";
+import { UrlToMarkdown } from "./resources/url-to-markdown.js";
+import { CallLogs } from "./resources/call-logs.js";
+export class JerrySniffs {
+    constructor(config) {
+        const client = new HttpClient(config);
+        this.search = new Search(client);
+        this.twitter = new Twitter(client);
+        this.reddit = new Reddit(client);
+        this.urlToMarkdown = new UrlToMarkdown(client);
+        this.callLogs = new CallLogs(client);
+    }
+}
+export { ApiError } from "./client.js";
+export { isVideoMedia, isPhotoMedia, isAnimatedGif, getHighestQualityVariant, } from "./types.js";
+export default JerrySniffs;
+//# 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,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD,MAAM,OAAO,WAAW;IAOtB,YAAY,MAAyB;QACnC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;CACF;AAED,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA+DvC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,eAAe,WAAW,CAAC"}

package/dist/resources/call-logs.d.ts

@@ -0,0 +1,14 @@
+import type { HttpClient } from "../client.js";
+import type { CallLogsResponse, CallLogsOptions } from "../types.js";
+export declare class CallLogs {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Search the authenticated user's API invocation logs.
+     *
+     * @param options - Optional filters: q, endpoint, status, page, limit, sort_by, sort_dir
+     * @returns Paginated call log results
+     */
+    list(options?: CallLogsOptions): Promise<CallLogsResponse>;
+}
+//# sourceMappingURL=call-logs.d.ts.map

package/dist/resources/call-logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-logs.d.ts","sourceRoot":"","sources":["../../src/resources/call-logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAErE,qBAAa,QAAQ;IACP,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;;;;OAKG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAajE"}

package/dist/resources/call-logs.js

@@ -0,0 +1,25 @@
+export class CallLogs {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Search the authenticated user's API invocation logs.
+     *
+     * @param options - Optional filters: q, endpoint, status, page, limit, sort_by, sort_dir
+     * @returns Paginated call log results
+     */
+    async list(options) {
+        const params = new URLSearchParams();
+        if (options) {
+            for (const [key, value] of Object.entries(options)) {
+                if (value !== undefined && value !== null) {
+                    params.set(key, String(value));
+                }
+            }
+        }
+        const qs = params.toString();
+        const path = `/api/v1/call_logs${qs ? `?${qs}` : ""}`;
+        return this.client.get(path);
+    }
+}
+//# sourceMappingURL=call-logs.js.map

package/dist/resources/call-logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-logs.js","sourceRoot":"","sources":["../../src/resources/call-logs.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,QAAQ;IACnB,YAAoB,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAE1C;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,OAAyB;QAClC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC1C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAmB,IAAI,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/resources/reddit.d.ts

@@ -0,0 +1,15 @@
+import type { HttpClient } from "../client.js";
+import type { RedditSearchPostsResponse, RedditSearchPostsOptions } from "../types.js";
+export declare class Reddit {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Search Reddit posts matching a query.
+     *
+     * @param query - Search query
+     * @param options - Optional: subreddit, sort, time, limit
+     * @returns Matching Reddit posts
+     */
+    searchPosts(query: string, options?: RedditSearchPostsOptions): Promise<RedditSearchPostsResponse>;
+}
+//# sourceMappingURL=reddit.d.ts.map

package/dist/resources/reddit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reddit.d.ts","sourceRoot":"","sources":["../../src/resources/reddit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAErB,qBAAa,MAAM;IACL,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;;;;;OAMG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,yBAAyB,CAAC;CAYtC"}

package/dist/resources/reddit.js

@@ -0,0 +1,22 @@
+export class Reddit {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Search Reddit posts matching a query.
+     *
+     * @param query - Search query
+     * @param options - Optional: subreddit, sort, time, limit
+     * @returns Matching Reddit posts
+     */
+    async searchPosts(query, options) {
+        return this.client.post("/api/v1/reddit_search_posts", {
+            query,
+            subreddit: options?.subreddit,
+            sort: options?.sort,
+            time: options?.time,
+            limit: options?.limit,
+        });
+    }
+}
+//# sourceMappingURL=reddit.js.map

package/dist/resources/reddit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reddit.js","sourceRoot":"","sources":["../../src/resources/reddit.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,MAAM;IACjB,YAAoB,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAE1C;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CACf,KAAa,EACb,OAAkC;QAElC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CACrB,6BAA6B,EAC7B;YACE,KAAK;YACL,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,IAAI,EAAE,OAAO,EAAE,IAAI;YACnB,IAAI,EAAE,OAAO,EAAE,IAAI;YACnB,KAAK,EAAE,OAAO,EAAE,KAAK;SACtB,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/resources/search.d.ts

@@ -0,0 +1,15 @@
+import type { HttpClient } from "../client.js";
+import type { SearchResponse, SearchOptions } from "../types.js";
+export declare class Search {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Search the web via JerrySniffs.
+     *
+     * @param query - Search query string
+     * @param options - Optional filters (limit, country, page, start, tbs)
+     * @returns Matching URLs and metadata
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResponse>;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/resources/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/resources/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,qBAAa,MAAM;IACL,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CAM9E"}

package/dist/resources/search.js

@@ -0,0 +1,19 @@
+export class Search {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Search the web via JerrySniffs.
+     *
+     * @param query - Search query string
+     * @param options - Optional filters (limit, country, page, start, tbs)
+     * @returns Matching URLs and metadata
+     */
+    async search(query, options) {
+        return this.client.post("/api/v1/search", {
+            query,
+            ...options,
+        });
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/resources/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/resources/search.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,MAAM;IACjB,YAAoB,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAE1C;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAuB;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAiB,gBAAgB,EAAE;YACxD,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/twitter.d.ts

@@ -0,0 +1,22 @@
+import type { HttpClient } from "../client.js";
+import type { TwitterSearchResponse, TwitterSearchOptions, TweetLookupResponse } from "../types.js";
+export declare class Twitter {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Search Twitter/X for tweets matching a query.
+     *
+     * @param query - Search query
+     * @param options - Optional: searchType ("Top" | "Latest"), limit
+     * @returns Matching tweets
+     */
+    search(query: string, options?: TwitterSearchOptions): Promise<TwitterSearchResponse>;
+    /**
+     * Look up a single tweet by its numeric ID.
+     *
+     * @param id - Numeric tweet ID (snowflake)
+     * @returns The tweet object
+     */
+    lookup(id: string): Promise<TweetLookupResponse>;
+}
+//# sourceMappingURL=twitter.d.ts.map

package/dist/resources/twitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitter.d.ts","sourceRoot":"","sources":["../../src/resources/twitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB,qBAAa,OAAO;IACN,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;;;;;OAMG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,qBAAqB,CAAC;IAQjC;;;;;OAKG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAKvD"}

package/dist/resources/twitter.js

@@ -0,0 +1,31 @@
+export class Twitter {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Search Twitter/X for tweets matching a query.
+     *
+     * @param query - Search query
+     * @param options - Optional: searchType ("Top" | "Latest"), limit
+     * @returns Matching tweets
+     */
+    async search(query, options) {
+        return this.client.post("/api/v1/twitter_search", {
+            query,
+            search_type: options?.searchType,
+            limit: options?.limit,
+        });
+    }
+    /**
+     * Look up a single tweet by its numeric ID.
+     *
+     * @param id - Numeric tweet ID (snowflake)
+     * @returns The tweet object
+     */
+    async lookup(id) {
+        return this.client.post("/api/v1/tweet_lookup", {
+            id,
+        });
+    }
+}
+//# sourceMappingURL=twitter.js.map

package/dist/resources/twitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitter.js","sourceRoot":"","sources":["../../src/resources/twitter.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,OAAO;IAClB,YAAoB,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAE1C;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAA8B;QAE9B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAwB,wBAAwB,EAAE;YACvE,KAAK;YACL,WAAW,EAAE,OAAO,EAAE,UAAU;YAChC,KAAK,EAAE,OAAO,EAAE,KAAK;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAsB,sBAAsB,EAAE;YACnE,EAAE;SACH,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/url-to-markdown.d.ts

@@ -0,0 +1,16 @@
+import type { HttpClient } from "../client.js";
+import type { UrlToMarkdownResponse, UrlToMarkdownOptions } from "../types.js";
+export declare class UrlToMarkdown {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Convert a URL to markdown. Supports HTML pages, plain text, PDFs,
+     * DOC, and DOCX files.
+     *
+     * @param url - The URL to convert
+     * @param options - Optional: proxy URL
+     * @returns The extracted markdown content
+     */
+    convert(url: string, options?: UrlToMarkdownOptions): Promise<UrlToMarkdownResponse>;
+}
+//# sourceMappingURL=url-to-markdown.d.ts.map

package/dist/resources/url-to-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-to-markdown.d.ts","sourceRoot":"","sources":["../../src/resources/url-to-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;;;;;;OAOG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,qBAAqB,CAAC;CAMlC"}

package/dist/resources/url-to-markdown.js

@@ -0,0 +1,20 @@
+export class UrlToMarkdown {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Convert a URL to markdown. Supports HTML pages, plain text, PDFs,
+     * DOC, and DOCX files.
+     *
+     * @param url - The URL to convert
+     * @param options - Optional: proxy URL
+     * @returns The extracted markdown content
+     */
+    async convert(url, options) {
+        return this.client.post("/api/v1/url_to_markdown", {
+            url,
+            proxy: options?.proxy,
+        });
+    }
+}
+//# sourceMappingURL=url-to-markdown.js.map

package/dist/resources/url-to-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-to-markdown.js","sourceRoot":"","sources":["../../src/resources/url-to-markdown.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,aAAa;IACxB,YAAoB,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAE1C;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CACX,GAAW,EACX,OAA8B;QAE9B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAwB,yBAAyB,EAAE;YACxE,GAAG;YACH,KAAK,EAAE,OAAO,EAAE,KAAK;SACtB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/twitter-response-types.d.ts

@@ -0,0 +1,371 @@
+/**
+ * TypeScript schema for Twitter/X API response.
+ *
+ * Fields marked [v2] come from the Twitter API v2 spec.
+ * Fields marked [v1.1] come from the legacy REST API spec.
+ * Fields marked [sample] were observed directly in the provided response.
+ */
+/** BCP-47 language tag or "zxx" (no linguistic content) */
+export type LanguageCode = string;
+/** Snowflake ID — always a string to avoid JS integer precision loss */
+export type SnowflakeId = string;
+/** Twitter date string — "Mon Jun 15 08:21:13 +0000 2026" (v1.1 format) */
+export type TwitterDateString = string;
+/** ISO 8601 date string — "2026-06-15T08:21:13.000Z" (v2 format) */
+export type ISODateString = string;
+export type MediaType = "photo" | "video" | "animated_gif";
+export type ContentType = "video/mp4" | "video/ogg" | "video/webm" | "application/x-mpegURL" | "application/dash+xml";
+export type ReplySettings = "everyone" | "mentionedUsers" | "subscribers" | "following";
+export type TweetType = "tweet" | "retweet" | "quote" | "reply";
+export interface MediaVariant {
+    /** Direct URL to this media rendition */
+    url: string;
+    content_type: ContentType;
+    /**
+     * Bitrate in bits per second. Present for non-HLS variants.
+     * 0 for animated_gif MP4 (no audio track, bitrate not meaningful).
+     */
+    bitrate?: number;
+}
+export interface TweetMedia {
+    /** [sample] Media type */
+    type: MediaType;
+    /** [sample] Direct URL — present for photos; absent for video/gif (use variants instead) */
+    url?: string;
+    /** [sample] HLS/MP4 variants with different bitrates/resolutions. Present for video & animated_gif */
+    variants?: MediaVariant[];
+    /** [sample] Duration in milliseconds. Present for video & animated_gif */
+    duration_ms?: number;
+    /** [sample] Thumbnail / poster image URL */
+    thumbnail_url?: string;
+    /** [v2] Unique stable key for this media asset (e.g. "3_123456789") */
+    media_key?: string;
+    /** [v1.1 / v2] Width in pixels */
+    width?: number;
+    /** [v1.1 / v2] Height in pixels */
+    height?: number;
+    /** [v2] Alt text for accessibility */
+    alt_text?: string;
+    /** [v2] Preview image URL (same as thumbnail_url in most cases) */
+    preview_image_url?: string;
+    /** [v2] Source of the media (e.g. tweet, user profile) */
+    source_status_id?: SnowflakeId;
+}
+export interface UrlEntity {
+    /** t.co shortened URL as it appears in tweet text */
+    url: string;
+    /** Fully expanded destination URL */
+    expanded_url: string;
+    /** Human-readable display URL (truncated) */
+    display_url: string;
+    /** [start, end] character indices within the tweet text */
+    indices?: [number, number];
+    /** HTTP status code returned when the URL was last fetched [v2] */
+    status?: number;
+    /** Page title of the linked resource [v2] */
+    title?: string;
+    /** Page description of the linked resource [v2] */
+    description?: string;
+    /** Unwound (final redirect) URL [v2] */
+    unwound_url?: string;
+}
+export interface HashtagEntity {
+    text: string;
+    indices?: [number, number];
+}
+export interface MentionEntity {
+    screen_name: string;
+    name: string;
+    id_str: SnowflakeId;
+    indices?: [number, number];
+}
+export interface CashtagEntity {
+    text: string;
+    indices?: [number, number];
+}
+export interface AnnotationEntity {
+    /** [v2] Named entity type, e.g. "Person", "Organization", "Place", "Product" */
+    type: string;
+    normalized_text: string;
+    probability: number;
+    start: number;
+    end: number;
+}
+export interface TweetEntities {
+    urls?: UrlEntity[];
+    hashtags?: HashtagEntity[];
+    user_mentions?: MentionEntity[];
+    symbols?: CashtagEntity[];
+    annotations?: AnnotationEntity[];
+    media?: Pick<TweetMedia, "media_key" | "url" | "type">[];
+}
+export interface TweetAuthor {
+    /** [sample] Display name */
+    name: string;
+    /** [sample] @handle without the '@' */
+    screen_name: string;
+    /** [sample] Profile picture URL (usually ends in _normal.jpg for 48×48) */
+    avatar: string;
+    /** [sample] Profile bio / description */
+    description: string;
+    /**
+     * [sample] Blue-check verified status.
+     * Note: Twitter v2 distinguishes verified (legacy blue) from verified_type.
+     */
+    verified: boolean;
+    /** [sample] Follower count */
+    followers_count: number;
+    /** [sample] Profile URL (link in bio) */
+    url?: string;
+    /** [sample] Location string (free-text, not geocoded) */
+    location?: string;
+    /** [v1.1] Number of accounts this user follows */
+    friends_count?: number;
+    /** [v1.1] Total tweets + retweets the user has posted */
+    statuses_count?: number;
+    /** [v1.1] Number of public lists the user is a member of */
+    listed_count?: number;
+    /** [v1.1] Number of tweets the user has liked */
+    favourites_count?: number;
+    /** [v1.1 / v2] Account creation timestamp */
+    created_at?: TwitterDateString | ISODateString;
+    /** [v1.1] Whether tweets are protected (private) */
+    protected?: boolean;
+    /** [v1.1] Profile banner/header image URL */
+    profile_banner_url?: string;
+    /** [v1.1] Profile background color (hex without #) */
+    profile_background_color?: string;
+    /** [v2] Unique numeric user ID */
+    id_str?: SnowflakeId;
+    /**
+     * [v2] Granular verification type.
+     * "blue"     → Twitter Blue subscriber
+     * "business" → Gold checkmark (advertiser)
+     * "government" → Grey checkmark
+     * "none"     → No verification
+     */
+    verified_type?: "blue" | "business" | "government" | "none";
+    /** [v2] Whether the authenticated user follows this author */
+    following?: boolean;
+    /** [v2] Whether this author follows the authenticated user */
+    followed_by?: boolean;
+    /** [v2] Whether DMs from authenticated user to this author are restricted */
+    can_dm?: boolean;
+    /** [v2] Pinned tweet ID */
+    pinned_tweet_id?: SnowflakeId;
+}
+export interface TweetPublicMetrics {
+    /** [sample] Total impression count (views) */
+    views: number;
+    /** [sample] Quote tweet count */
+    quotes: number;
+    /** [sample] Reply count */
+    replies: number;
+    /** [sample] Retweet count (not including quotes) */
+    retweets: number;
+    /** [sample] Bookmark count */
+    bookmarks: number;
+    /**
+     * [sample] Like count.
+     * Named "favorites" in v1.1; "like_count" in v2.
+     */
+    favorites: number;
+}
+/** [v2] Non-public metrics — only available for your own tweets via OAuth */
+export interface TweetNonPublicMetrics {
+    impression_count: number;
+    url_link_clicks: number;
+    user_profile_clicks: number;
+}
+/** [v2] Organic (non-promoted) metrics */
+export interface TweetOrganicMetrics extends TweetPublicMetrics {
+    url_link_clicks: number;
+    user_profile_clicks: number;
+}
+/** [v2] Promoted metrics (only if tweet was promoted) */
+export type TweetPromotedMetrics = TweetOrganicMetrics;
+export interface Coordinates {
+    type: "Point";
+    coordinates: [longitude: number, latitude: number];
+}
+export interface BoundingBox {
+    type: "Polygon";
+    /** Array of [longitude, latitude] corners */
+    coordinates: [number, number][][];
+}
+export interface TweetPlace {
+    /** [v2] Place ID (e.g. "01a9a39529b27f36") */
+    id: string;
+    name: string;
+    full_name: string;
+    country: string;
+    country_code: string;
+    place_type: "city" | "admin" | "country" | "neighborhood" | "poi" | "unknown";
+    geo?: BoundingBox;
+    contained_within?: TweetPlace[];
+}
+export interface ReferencedTweet {
+    /** "retweeted" | "quoted" | "replied_to" */
+    type: "retweeted" | "quoted" | "replied_to";
+    id: SnowflakeId;
+    /** Expanded tweet object — present when expansions=referenced_tweets.id is requested */
+    tweet?: Tweet;
+}
+/** [v2] Domain + entity pair for contextual annotations */
+export interface ContextAnnotation {
+    domain: {
+        id: string;
+        name: string;
+        description?: string;
+    };
+    entity: {
+        id: string;
+        name: string;
+        description?: string;
+    };
+}
+export interface PollOption {
+    position: number;
+    label: string;
+    votes: number;
+}
+export interface TweetPoll {
+    id: string;
+    options: PollOption[];
+    /** ISO 8601 expiry datetime */
+    end_datetime: ISODateString;
+    /** ISO 8601 duration string, e.g. "PT24H" */
+    duration_minutes: number;
+    voting_status: "open" | "closed";
+}
+export interface WithheldInfo {
+    /** Whether the entire tweet or only specific fields are withheld */
+    copyright: boolean;
+    /** ISO 3166-1 alpha-2 country codes where this tweet is withheld */
+    country_codes: string[];
+    scope?: "tweet" | "user";
+}
+export interface Tweet {
+    /** [sample] Snowflake ID of the tweet */
+    tweet_id: SnowflakeId;
+    /** [sample] Canonical URL to the tweet */
+    url: string;
+    /** [sample] BCP-47 language code detected for the tweet text */
+    lang: LanguageCode;
+    /** [sample] The @screen_name of the tweet author (denormalized) */
+    screen_name: string;
+    /** [sample] Tweet text (up to 280 chars; 10,000 for Twitter Blue subscribers) */
+    text: string;
+    /** [sample] Creation timestamp in v1.1 date string format */
+    created_at: TwitterDateString;
+    /** [sample] ID of the root tweet in the thread/conversation */
+    conversation_id: SnowflakeId;
+    /** [sample] Expanded URLs extracted from the tweet text */
+    urls: string[];
+    /** [sample] Attached media items */
+    media: TweetMedia[];
+    /** [sample] Author profile */
+    author: TweetAuthor;
+    /** [sample] Engagement & impression metrics */
+    metrics: TweetPublicMetrics;
+    /** [v1.1 / v2] ID of the tweet this is a reply to */
+    in_reply_to_status_id?: SnowflakeId;
+    /** [v1.1] @screen_name of the user being replied to */
+    in_reply_to_screen_name?: string;
+    /** [v1.1 / v2] User ID of the user being replied to */
+    in_reply_to_user_id?: SnowflakeId;
+    /** [v1.1] Whether this tweet is a retweet */
+    retweeted?: boolean;
+    /** [v1.1] The original tweet when this is a retweet */
+    retweeted_status?: Tweet;
+    /** [v2] Referenced tweets (retweets, quotes, reply parents) */
+    referenced_tweets?: ReferencedTweet[];
+    /** [v1.1] Retweet count (denormalized from metrics) */
+    retweet_count?: number;
+    /** [v1.1 / v2] Parsed entities (URLs, mentions, hashtags, etc.) */
+    entities?: TweetEntities;
+    /** [v2] Named entity + topic annotations */
+    context_annotations?: ContextAnnotation[];
+    /**
+     * [v1.1] If the tweet text was truncated due to legacy 140-char limit.
+     * Always false for tweets > 2014 and for v2.
+     */
+    truncated?: boolean;
+    /**
+     * [v1.1] Extended tweet object present when tweet exceeds old 140-char limit.
+     * Only relevant for v1.1 compat layer.
+     */
+    extended_tweet?: {
+        full_text: string;
+        display_text_range: [number, number];
+        entities: TweetEntities;
+    };
+    /** [v2] Character range [start, end] of the actual tweet text to display */
+    display_text_range?: [number, number];
+    /** [v1.1] Exact coordinates if geotagged */
+    coordinates?: Coordinates;
+    /** [v1.1 / v2] Named place associated with the tweet */
+    place?: TweetPlace;
+    /** [v2] Poll attached to the tweet */
+    poll?: TweetPoll;
+    /** [v1.1] HTML anchor tag identifying the client used to post */
+    source?: string;
+    /** [v2] Who can reply to this tweet */
+    reply_settings?: ReplySettings;
+    /** [v1.1] Whether the tweet is flagged as potentially sensitive */
+    possibly_sensitive?: boolean;
+    /** [v2] Countries/reasons for content withholding */
+    withheld?: WithheldInfo;
+    /** [v2] Impressions & click metrics — only for authenticated author */
+    non_public_metrics?: TweetNonPublicMetrics;
+    /** [v2] Organic engagement breakdown */
+    organic_metrics?: TweetOrganicMetrics;
+    /** [v2] Promoted post metrics */
+    promoted_metrics?: TweetPromotedMetrics;
+}
+export interface TwitterApiResponse {
+    /** [sample] Whether the request succeeded */
+    ok: boolean;
+    /** [sample] List of tweets returned */
+    tweets: Tweet[];
+    /** [v2] Pagination token for the next page */
+    next_token?: string;
+    /** [v2] Pagination token for the previous page */
+    previous_token?: string;
+    /** [v2] Total count of results matching the query (not just this page) */
+    result_count?: number;
+    /** [v2] Newest tweet ID in the result set */
+    newest_id?: SnowflakeId;
+    /** [v2] Oldest tweet ID in the result set */
+    oldest_id?: SnowflakeId;
+}
+/** Narrows a TweetMedia to a video with guaranteed variants */
+export type VideoMedia = TweetMedia & {
+    type: "video";
+    variants: MediaVariant[];
+    duration_ms: number;
+    thumbnail_url: string;
+};
+/** Narrows a TweetMedia to a photo */
+export type PhotoMedia = TweetMedia & {
+    type: "photo";
+    url: string;
+};
+/** Narrows a TweetMedia to an animated GIF */
+export type AnimatedGifMedia = TweetMedia & {
+    type: "animated_gif";
+    variants: MediaVariant[];
+    thumbnail_url: string;
+};
+/** Type guard: is this media a video? */
+export declare function isVideoMedia(media: TweetMedia): media is VideoMedia;
+/** Type guard: is this media a photo? */
+export declare function isPhotoMedia(media: TweetMedia): media is PhotoMedia;
+/** Type guard: is this media an animated GIF? */
+export declare function isAnimatedGif(media: TweetMedia): media is AnimatedGifMedia;
+/**
+ * Returns the highest-bitrate MP4 variant from a video media item.
+ * Useful for downloading or embedding at max quality.
+ */
+export declare function getHighestQualityVariant(media: VideoMedia): MediaVariant | undefined;
+//# sourceMappingURL=twitter-response-types.d.ts.map

package/dist/twitter-response-types.d.ts.map

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

package/dist/twitter-response-types.js

@@ -0,0 +1,29 @@
+/**
+ * TypeScript schema for Twitter/X API response.
+ *
+ * Fields marked [v2] come from the Twitter API v2 spec.
+ * Fields marked [v1.1] come from the legacy REST API spec.
+ * Fields marked [sample] were observed directly in the provided response.
+ */
+/** Type guard: is this media a video? */
+export function isVideoMedia(media) {
+    return media.type === "video";
+}
+/** Type guard: is this media a photo? */
+export function isPhotoMedia(media) {
+    return media.type === "photo";
+}
+/** Type guard: is this media an animated GIF? */
+export function isAnimatedGif(media) {
+    return media.type === "animated_gif";
+}
+/**
+ * Returns the highest-bitrate MP4 variant from a video media item.
+ * Useful for downloading or embedding at max quality.
+ */
+export function getHighestQualityVariant(media) {
+    return media.variants
+        .filter((v) => v.content_type === "video/mp4")
+        .sort((a, b) => (b.bitrate ?? 0) - (a.bitrate ?? 0))[0];
+}
+//# sourceMappingURL=twitter-response-types.js.map

package/dist/twitter-response-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitter-response-types.js","sourceRoot":"","sources":["../src/twitter-response-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2hBH,yCAAyC;AACzC,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,OAAO,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAiB;IACxD,OAAO,KAAK,CAAC,QAAQ;SAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,WAAW,CAAC;SAC7C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,153 @@
+export type { LanguageCode, SnowflakeId, TwitterDateString, ISODateString, MediaType, ContentType, ReplySettings, TweetType, MediaVariant, TweetMedia, UrlEntity, HashtagEntity, MentionEntity, CashtagEntity, AnnotationEntity, TweetEntities, TweetAuthor, TweetPublicMetrics, TweetNonPublicMetrics, TweetOrganicMetrics, TweetPromotedMetrics, Coordinates, BoundingBox, TweetPlace, ReferencedTweet, ContextAnnotation, PollOption, TweetPoll, WithheldInfo, Tweet, TwitterApiResponse, VideoMedia, PhotoMedia, AnimatedGifMedia, } from "./twitter-response-types.js";
+export { isVideoMedia, isPhotoMedia, isAnimatedGif, getHighestQualityVariant, } from "./twitter-response-types.js";
+export interface ApiTweetAuthor {
+    screen_name: string | null;
+    name: string | null;
+    verified: boolean | null;
+    verified_type: string | null;
+    followers_count: number | null;
+    description: string | null;
+    url: string | null;
+    avatar: string | null;
+    [key: string]: unknown;
+}
+export interface ApiTweetMetrics {
+    views: number | null;
+    bookmarks: number | null;
+    favorites: number | null;
+    quotes: number | null;
+    replies: number | null;
+    retweets: number | null;
+    [key: string]: unknown;
+}
+export interface ApiTweetMedia {
+    type: "photo" | "video" | "animated_gif";
+    url?: string | null;
+    thumbnail_url?: string | null;
+    duration_ms?: number | null;
+    variants?: ApiMediaVariant[] | null;
+    width?: number | null;
+    height?: number | null;
+    [key: string]: unknown;
+}
+export interface ApiMediaVariant {
+    url: string;
+    content_type: string;
+    bitrate?: number | null;
+}
+export interface ApiTweet {
+    tweet_id: string | null;
+    url: string | null;
+    screen_name: string | null;
+    created_at: string | null;
+    text: string | null;
+    display_text: string | null;
+    lang: string | null;
+    conversation_id: string | null;
+    reply_to: string | null;
+    in_reply_to_screen_name: string | null;
+    in_reply_to_status_id: string | null;
+    in_reply_to_user_id: string | null;
+    sensitive: boolean | null;
+    status: string | null;
+    author: ApiTweetAuthor;
+    metrics: ApiTweetMetrics;
+    urls: string[] | null;
+    media: ApiTweetMedia[];
+    [key: string]: unknown;
+}
+export interface RedditAuthorInfo {
+    id: string | null;
+    name: string | null;
+}
+export interface RedditSubreddit {
+    name: string | null;
+    subscribersCount: number | null;
+}
+export interface RedditPost {
+    id: string | null;
+    createdAt: number | null;
+    postTitle: string | null;
+    url: string | null;
+    content: string | null;
+    score: number | null;
+    commentCount: number | null;
+    authorInfo: RedditAuthorInfo;
+    upvoteRatio: number | null;
+    subreddit: RedditSubreddit;
+}
+export interface CallLog {
+    id: string;
+    endpoint: string;
+    status: "success" | "failure";
+    http_code: number | null;
+    duration_ms: number | null;
+    error_message: string | null;
+    created_at: string;
+    [key: string]: unknown;
+}
+export interface SearchResponse {
+    ok: boolean;
+    query: string;
+    urls: string[];
+    count: number;
+}
+export interface UrlToMarkdownResponse {
+    ok: boolean;
+    url: string;
+    markdown: string;
+    is_proxy_used: boolean;
+}
+export interface TwitterSearchResponse {
+    ok: boolean;
+    tweets: ApiTweet[];
+}
+export interface TweetLookupResponse {
+    ok: boolean;
+    tweet: ApiTweet;
+}
+export interface RedditSearchPostsResponse {
+    ok: boolean;
+    posts: RedditPost[];
+}
+export interface CallLogsResponse {
+    rows: CallLog[];
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+}
+export interface SearchOptions {
+    limit?: number;
+    country?: string;
+    page?: number;
+    start?: number;
+    tbs?: string;
+}
+export interface UrlToMarkdownOptions {
+    proxy?: string;
+}
+export interface TwitterSearchOptions {
+    searchType?: "Top" | "Latest";
+    limit?: number;
+}
+export interface RedditSearchPostsOptions {
+    subreddit?: string;
+    sort?: "relevance" | "hot" | "top" | "new" | "comments";
+    time?: "hour" | "day" | "week" | "month" | "year" | "all";
+    limit?: number;
+}
+export interface CallLogsOptions {
+    q?: string;
+    endpoint?: string;
+    status?: "success" | "failure";
+    page?: number;
+    limit?: number;
+    sort_by?: "created_at" | "endpoint" | "status" | "http_code" | "duration_ms";
+    sort_dir?: "asc" | "desc";
+}
+export interface JerrySniffsConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,4 @@
+// ── Twitter types (from TWITTER_RESPONSE_TYPES.js) ──────────────────────────
+// Re-exported for consumers who need the full rich Tweet shape.
+export { isVideoMedia, isPhotoMedia, isAnimatedGif, getHighestQualityVariant, } from "./twitter-response-types.js";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gEAAgE;AAuChE,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,wBAAwB,GACzB,MAAM,6BAA6B,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "jerrysniffs-node-sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Official Node.js SDK for the JerrySniffs API",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "jerrysniffs",
+    "twitter",
+    "reddit",
+    "search",
+    "scraping",
+    "api",
+    "sdk"
+  ],
+  "author": "JerrySniffs",
+  "license": "ISC",
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "@types/node": "^20.14.0"
+  }
+}