scavio 0.1.0

package/dist/index.js

@@ -0,0 +1,329 @@
+// src/errors.ts
+var ScavioError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ScavioError";
+  }
+};
+var MissingAPIKeyError = class extends ScavioError {
+  constructor() {
+    super(
+      "No API key provided. Pass apiKey or set the SCAVIO_API_KEY environment variable. Get your free key at https://dashboard.scavio.dev"
+    );
+    this.name = "MissingAPIKeyError";
+  }
+};
+var InvalidAPIKeyError = class extends ScavioError {
+  constructor(message = "Invalid API key") {
+    super(message);
+    this.name = "InvalidAPIKeyError";
+  }
+};
+var InsufficientCreditsError = class extends ScavioError {
+  constructor(message = "Insufficient credits") {
+    super(message);
+    this.name = "InsufficientCreditsError";
+  }
+};
+var BadRequestError = class extends ScavioError {
+  constructor(message = "Bad request") {
+    super(message);
+    this.name = "BadRequestError";
+  }
+};
+var RateLimitError = class extends ScavioError {
+  constructor(message = "Rate limit exceeded") {
+    super(message);
+    this.name = "RateLimitError";
+  }
+};
+var ScavioAPIError = class extends ScavioError {
+  statusCode;
+  constructor(statusCode, message) {
+    super(`API error ${statusCode}: ${message}`);
+    this.name = "ScavioAPIError";
+    this.statusCode = statusCode;
+  }
+};
+
+// src/http.ts
+var BASE_URL = "https://api.scavio.dev";
+var DEFAULT_TIMEOUT = 3e4;
+function buildHeaders(apiKey) {
+  return {
+    Authorization: `Bearer ${apiKey}`,
+    "Content-Type": "application/json",
+    "X-Client-Source": "scavio-js"
+  };
+}
+function stripUndefined(obj) {
+  const result = {};
+  for (const [key, value] of Object.entries(obj)) {
+    if (value !== void 0) {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+function handleError(statusCode, body) {
+  let error = body.error ?? "Unknown error";
+  if (typeof error === "object" && error !== null && "message" in error) {
+    error = error.message;
+  }
+  const msg = String(error);
+  if (statusCode === 400) throw new BadRequestError(msg);
+  if (statusCode === 401) throw new InvalidAPIKeyError(msg);
+  if (statusCode === 402) throw new InsufficientCreditsError(msg);
+  if (statusCode === 429) throw new RateLimitError(msg);
+  throw new ScavioAPIError(statusCode, msg);
+}
+async function request(options) {
+  await options.rateLimiter.wait();
+  const url = `${options.baseUrl}${options.path}`;
+  const headers = buildHeaders(options.apiKey);
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), options.timeout);
+  try {
+    const fetchOptions = {
+      method: options.method,
+      headers,
+      signal: controller.signal
+    };
+    if (options.method === "POST" && options.body) {
+      fetchOptions.body = JSON.stringify(stripUndefined(options.body));
+    }
+    const response = await fetch(url, fetchOptions);
+    if (!response.ok) {
+      let body = {};
+      try {
+        body = await response.json();
+      } catch {
+      }
+      handleError(response.status, body);
+    }
+    return await response.json();
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+
+// src/rate-limiter.ts
+var RateLimiter = class {
+  maxPerSecond;
+  timestamps = [];
+  pending = Promise.resolve();
+  constructor(maxPerSecond) {
+    this.maxPerSecond = maxPerSecond;
+  }
+  async wait() {
+    const ticket = this.pending.then(() => this.acquire());
+    this.pending = ticket;
+    return ticket;
+  }
+  async acquire() {
+    this.cleanup();
+    if (this.timestamps.length >= this.maxPerSecond) {
+      const sleepMs = 1e3 - (Date.now() - this.timestamps[0]);
+      if (sleepMs > 0) {
+        await new Promise((resolve) => setTimeout(resolve, sleepMs));
+      }
+      this.cleanup();
+    }
+    this.timestamps.push(Date.now());
+  }
+  cleanup() {
+    const now = Date.now();
+    while (this.timestamps.length > 0 && now - this.timestamps[0] >= 1e3) {
+      this.timestamps.shift();
+    }
+  }
+};
+
+// src/namespaces/amazon.ts
+var AmazonNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async search(options) {
+    return this.client._post("/api/v1/amazon/search", options);
+  }
+  async product(options) {
+    const { asin, ...rest } = options;
+    return this.client._post("/api/v1/amazon/product", {
+      query: asin,
+      ...rest
+    });
+  }
+};
+
+// src/namespaces/google.ts
+var GoogleNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async search(options) {
+    return this.client._post("/api/v1/google", options);
+  }
+};
+
+// src/namespaces/reddit.ts
+var RedditNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async search(options) {
+    return this.client._post("/api/v1/reddit/search", options);
+  }
+  async post(options) {
+    return this.client._post("/api/v1/reddit/post", options);
+  }
+};
+
+// src/namespaces/tiktok.ts
+var TikTokNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async profile(options) {
+    return this.client._post("/api/v1/tiktok/profile", options);
+  }
+  async userPosts(options) {
+    return this.client._post("/api/v1/tiktok/user/posts", options);
+  }
+  async video(options) {
+    return this.client._post("/api/v1/tiktok/video", options);
+  }
+  async videoComments(options) {
+    return this.client._post("/api/v1/tiktok/video/comments", options);
+  }
+  async commentReplies(options) {
+    return this.client._post("/api/v1/tiktok/video/comments/replies", options);
+  }
+  async searchVideos(options) {
+    return this.client._post("/api/v1/tiktok/search/videos", options);
+  }
+  async searchUsers(options) {
+    return this.client._post("/api/v1/tiktok/search/users", options);
+  }
+  async hashtag(options) {
+    return this.client._post("/api/v1/tiktok/hashtag", options);
+  }
+  async hashtagVideos(options) {
+    return this.client._post("/api/v1/tiktok/hashtag/videos", options);
+  }
+  async userFollowers(options) {
+    return this.client._post("/api/v1/tiktok/user/followers", options);
+  }
+  async userFollowings(options) {
+    return this.client._post("/api/v1/tiktok/user/followings", options);
+  }
+};
+
+// src/namespaces/walmart.ts
+var WalmartNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async search(options) {
+    return this.client._post("/api/v1/walmart/search", options);
+  }
+  async product(options) {
+    return this.client._post("/api/v1/walmart/product", options);
+  }
+};
+
+// src/namespaces/youtube.ts
+var YouTubeNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async search(options) {
+    const { query, ...rest } = options;
+    return this.client._post("/api/v1/youtube/search", {
+      search: query,
+      ...rest
+    });
+  }
+  async metadata(options) {
+    return this.client._post("/api/v1/youtube/metadata", options);
+  }
+};
+
+// src/client.ts
+var Scavio = class {
+  google;
+  amazon;
+  walmart;
+  youtube;
+  reddit;
+  tiktok;
+  apiKey;
+  baseUrl;
+  timeout;
+  rateLimiter;
+  constructor(config) {
+    this.apiKey = config?.apiKey ?? process.env.SCAVIO_API_KEY ?? "";
+    if (!this.apiKey) {
+      throw new MissingAPIKeyError();
+    }
+    this.baseUrl = (config?.baseUrl ?? BASE_URL).replace(/\/+$/, "");
+    this.timeout = config?.timeout ?? DEFAULT_TIMEOUT;
+    const rps = config?.maxRequestsPerSecond ?? 1;
+    if (rps < 1 || rps > 10) {
+      throw new ScavioError("maxRequestsPerSecond must be between 1 and 10");
+    }
+    this.rateLimiter = new RateLimiter(rps);
+    this.google = new GoogleNamespace(this);
+    this.amazon = new AmazonNamespace(this);
+    this.walmart = new WalmartNamespace(this);
+    this.youtube = new YouTubeNamespace(this);
+    this.reddit = new RedditNamespace(this);
+    this.tiktok = new TikTokNamespace(this);
+  }
+  /** @internal */
+  async _post(path, body) {
+    return request({
+      method: "POST",
+      path,
+      apiKey: this.apiKey,
+      baseUrl: this.baseUrl,
+      timeout: this.timeout,
+      rateLimiter: this.rateLimiter,
+      body
+    });
+  }
+  /** @internal */
+  async _get(path) {
+    return request({
+      method: "GET",
+      path,
+      apiKey: this.apiKey,
+      baseUrl: this.baseUrl,
+      timeout: this.timeout,
+      rateLimiter: this.rateLimiter
+    });
+  }
+  async search(options) {
+    return this.google.search(options);
+  }
+  async getUsage() {
+    return this._get("/api/v1/usage");
+  }
+};
+export {
+  BadRequestError,
+  InsufficientCreditsError,
+  InvalidAPIKeyError,
+  MissingAPIKeyError,
+  RateLimitError,
+  Scavio,
+  ScavioAPIError,
+  ScavioError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/rate-limiter.ts","../src/namespaces/amazon.ts","../src/namespaces/google.ts","../src/namespaces/reddit.ts","../src/namespaces/tiktok.ts","../src/namespaces/walmart.ts","../src/namespaces/youtube.ts","../src/client.ts"],"sourcesContent":["export class ScavioError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ScavioError\";\n  }\n}\n\nexport class MissingAPIKeyError extends ScavioError {\n  constructor() {\n    super(\n      \"No API key provided. Pass apiKey or set the SCAVIO_API_KEY \" +\n        \"environment variable. Get your free key at https://dashboard.scavio.dev\",\n    );\n    this.name = \"MissingAPIKeyError\";\n  }\n}\n\nexport class InvalidAPIKeyError extends ScavioError {\n  constructor(message = \"Invalid API key\") {\n    super(message);\n    this.name = \"InvalidAPIKeyError\";\n  }\n}\n\nexport class InsufficientCreditsError extends ScavioError {\n  constructor(message = \"Insufficient credits\") {\n    super(message);\n    this.name = \"InsufficientCreditsError\";\n  }\n}\n\nexport class BadRequestError extends ScavioError {\n  constructor(message = \"Bad request\") {\n    super(message);\n    this.name = \"BadRequestError\";\n  }\n}\n\nexport class RateLimitError extends ScavioError {\n  constructor(message = \"Rate limit exceeded\") {\n    super(message);\n    this.name = \"RateLimitError\";\n  }\n}\n\nexport class ScavioAPIError extends ScavioError {\n  public readonly statusCode: number;\n\n  constructor(statusCode: number, message: string) {\n    super(`API error ${statusCode}: ${message}`);\n    this.name = \"ScavioAPIError\";\n    this.statusCode = statusCode;\n  }\n}\n","import {\n  BadRequestError,\n  InsufficientCreditsError,\n  InvalidAPIKeyError,\n  RateLimitError,\n  ScavioAPIError,\n} from \"./errors.js\";\nimport type { RateLimiter } from \"./rate-limiter.js\";\n\nexport const BASE_URL = \"https://api.scavio.dev\";\nexport const DEFAULT_TIMEOUT = 30_000;\n\nfunction buildHeaders(apiKey: string): Record<string, string> {\n  return {\n    Authorization: `Bearer ${apiKey}`,\n    \"Content-Type\": \"application/json\",\n    \"X-Client-Source\": \"scavio-js\",\n  };\n}\n\nfunction stripUndefined(\n  obj: Record<string, unknown>,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(obj)) {\n    if (value !== undefined) {\n      result[key] = value;\n    }\n  }\n  return result;\n}\n\nfunction handleError(statusCode: number, body: Record<string, unknown>): never {\n  let error = body.error ?? \"Unknown error\";\n  if (typeof error === \"object\" && error !== null && \"message\" in error) {\n    error = (error as { message: string }).message;\n  }\n  const msg = String(error);\n\n  if (statusCode === 400) throw new BadRequestError(msg);\n  if (statusCode === 401) throw new InvalidAPIKeyError(msg);\n  if (statusCode === 402) throw new InsufficientCreditsError(msg);\n  if (statusCode === 429) throw new RateLimitError(msg);\n  throw new ScavioAPIError(statusCode, msg);\n}\n\nexport async function request(options: {\n  method: \"GET\" | \"POST\";\n  path: string;\n  apiKey: string;\n  baseUrl: string;\n  timeout: number;\n  rateLimiter: RateLimiter;\n  body?: Record<string, unknown>;\n}): Promise<Record<string, unknown>> {\n  await options.rateLimiter.wait();\n\n  const url = `${options.baseUrl}${options.path}`;\n  const headers = buildHeaders(options.apiKey);\n\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), options.timeout);\n\n  try {\n    const fetchOptions: RequestInit = {\n      method: options.method,\n      headers,\n      signal: controller.signal,\n    };\n\n    if (options.method === \"POST\" && options.body) {\n      fetchOptions.body = JSON.stringify(stripUndefined(options.body));\n    }\n\n    const response = await fetch(url, fetchOptions);\n\n    if (!response.ok) {\n      let body: Record<string, unknown> = {};\n      try {\n        body = (await response.json()) as Record<string, unknown>;\n      } catch {\n        // ignore parse failures\n      }\n      handleError(response.status, body);\n    }\n\n    return (await response.json()) as Record<string, unknown>;\n  } finally {\n    clearTimeout(timeoutId);\n  }\n}\n","export class RateLimiter {\n  private readonly maxPerSecond: number;\n  private readonly timestamps: number[] = [];\n  private pending: Promise<void> = Promise.resolve();\n\n  constructor(maxPerSecond: number) {\n    this.maxPerSecond = maxPerSecond;\n  }\n\n  async wait(): Promise<void> {\n    const ticket = this.pending.then(() => this.acquire());\n    this.pending = ticket;\n    return ticket;\n  }\n\n  private async acquire(): Promise<void> {\n    this.cleanup();\n    if (this.timestamps.length >= this.maxPerSecond) {\n      const sleepMs = 1000 - (Date.now() - this.timestamps[0]!);\n      if (sleepMs > 0) {\n        await new Promise<void>((resolve) => setTimeout(resolve, sleepMs));\n      }\n      this.cleanup();\n    }\n    this.timestamps.push(Date.now());\n  }\n\n  private cleanup(): void {\n    const now = Date.now();\n    while (this.timestamps.length > 0 && now - this.timestamps[0]! >= 1000) {\n      this.timestamps.shift();\n    }\n  }\n}\n","import type { Scavio } from \"../client.js\";\n\nexport interface AmazonSearchOptions {\n  query: string;\n  domain?: string;\n  country?: string;\n  language?: string;\n  currency?: string;\n  device?: string;\n  sort_by?: string;\n  start_page?: number;\n  pages?: number;\n  category_id?: string;\n  merchant_id?: string;\n  zip_code?: string;\n  autoselect_variant?: boolean;\n}\n\nexport interface AmazonProductOptions {\n  asin: string;\n  domain?: string;\n  country?: string;\n  language?: string;\n  currency?: string;\n  device?: string;\n  zip_code?: string;\n  autoselect_variant?: boolean;\n}\n\nexport class AmazonNamespace {\n  constructor(private client: Scavio) {}\n\n  async search(\n    options: AmazonSearchOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/amazon/search\", options);\n  }\n\n  async product(\n    options: AmazonProductOptions,\n  ): Promise<Record<string, unknown>> {\n    const { asin, ...rest } = options;\n    return this.client._post(\"/api/v1/amazon/product\", {\n      query: asin,\n      ...rest,\n    });\n  }\n}\n","import type { Scavio } from \"../client.js\";\n\nexport interface GoogleSearchOptions {\n  query: string;\n  country_code?: string;\n  language?: string;\n  page?: number;\n  search_type?: string;\n  device?: string;\n  nfpr?: boolean;\n  light_request?: boolean;\n}\n\nexport class GoogleNamespace {\n  constructor(private client: Scavio) {}\n\n  async search(options: GoogleSearchOptions): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/google\", options);\n  }\n}\n","import type { Scavio } from \"../client.js\";\n\nexport interface RedditSearchOptions {\n  query: string;\n  type?: string;\n  sort?: string;\n  cursor?: string;\n}\n\nexport interface RedditPostOptions {\n  url: string;\n}\n\nexport class RedditNamespace {\n  constructor(private client: Scavio) {}\n\n  async search(\n    options: RedditSearchOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/reddit/search\", options);\n  }\n\n  async post(options: RedditPostOptions): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/reddit/post\", options);\n  }\n}\n","import type { Scavio } from \"../client.js\";\n\nexport interface TikTokProfileOptions {\n  username?: string;\n  sec_user_id?: string;\n}\n\nexport interface TikTokUserPostsOptions {\n  sec_user_id: string;\n  cursor?: string;\n  count?: number;\n  sort_type?: string;\n}\n\nexport interface TikTokVideoOptions {\n  video_id: string;\n}\n\nexport interface TikTokVideoCommentsOptions {\n  video_id: string;\n  cursor?: string;\n  count?: number;\n}\n\nexport interface TikTokCommentRepliesOptions {\n  video_id: string;\n  comment_id: string;\n  cursor?: string;\n  count?: number;\n}\n\nexport interface TikTokSearchVideosOptions {\n  keyword: string;\n  cursor?: string;\n  count?: number;\n  sort_type?: string;\n  publish_time?: string;\n}\n\nexport interface TikTokSearchUsersOptions {\n  keyword: string;\n  cursor?: string;\n  count?: number;\n}\n\nexport interface TikTokHashtagOptions {\n  hashtag_name?: string;\n  hashtag_id?: string;\n}\n\nexport interface TikTokHashtagVideosOptions {\n  hashtag_id: string;\n  cursor?: string;\n  count?: number;\n}\n\nexport interface TikTokUserFollowersOptions {\n  sec_user_id: string;\n  count?: number;\n  page_token?: string;\n  min_time?: number;\n}\n\nexport interface TikTokUserFollowingsOptions {\n  sec_user_id: string;\n  count?: number;\n  page_token?: string;\n  min_time?: number;\n}\n\nexport class TikTokNamespace {\n  constructor(private client: Scavio) {}\n\n  async profile(\n    options: TikTokProfileOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/tiktok/profile\", options);\n  }\n\n  async userPosts(\n    options: TikTokUserPostsOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/tiktok/user/posts\", options);\n  }\n\n  async video(\n    options: TikTokVideoOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/tiktok/video\", options);\n  }\n\n  async videoComments(\n    options: TikTokVideoCommentsOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/tiktok/video/comments\", options);\n  }\n\n  async commentReplies(\n    options: TikTokCommentRepliesOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/tiktok/video/comments/replies\", options);\n  }\n\n  async searchVideos(\n    options: TikTokSearchVideosOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/tiktok/search/videos\", options);\n  }\n\n  async searchUsers(\n    options: TikTokSearchUsersOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/tiktok/search/users\", options);\n  }\n\n  async hashtag(\n    options: TikTokHashtagOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/tiktok/hashtag\", options);\n  }\n\n  async hashtagVideos(\n    options: TikTokHashtagVideosOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/tiktok/hashtag/videos\", options);\n  }\n\n  async userFollowers(\n    options: TikTokUserFollowersOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/tiktok/user/followers\", options);\n  }\n\n  async userFollowings(\n    options: TikTokUserFollowingsOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/tiktok/user/followings\", options);\n  }\n}\n","import type { Scavio } from \"../client.js\";\n\nexport interface WalmartSearchOptions {\n  query: string;\n  domain?: string;\n  device?: string;\n  sort_by?: string;\n  start_page?: number;\n  min_price?: number;\n  max_price?: number;\n  fulfillment_speed?: string;\n  fulfillment_type?: string;\n  delivery_zip?: string;\n  store_id?: string;\n}\n\nexport interface WalmartProductOptions {\n  product_id: string;\n  domain?: string;\n  device?: string;\n  delivery_zip?: string;\n  store_id?: string;\n}\n\nexport class WalmartNamespace {\n  constructor(private client: Scavio) {}\n\n  async search(\n    options: WalmartSearchOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/walmart/search\", options);\n  }\n\n  async product(\n    options: WalmartProductOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/walmart/product\", options);\n  }\n}\n","import type { Scavio } from \"../client.js\";\n\nexport interface YouTubeSearchOptions {\n  query: string;\n  upload_date?: string;\n  type?: string;\n  duration?: string;\n  sort_by?: string;\n  hd?: boolean;\n  subtitles?: boolean;\n  creative_commons?: boolean;\n  live?: boolean;\n}\n\nexport interface YouTubeMetadataOptions {\n  video_id: string;\n}\n\nexport class YouTubeNamespace {\n  constructor(private client: Scavio) {}\n\n  async search(\n    options: YouTubeSearchOptions,\n  ): Promise<Record<string, unknown>> {\n    const { query, ...rest } = options;\n    return this.client._post(\"/api/v1/youtube/search\", {\n      search: query,\n      ...rest,\n    });\n  }\n\n  async metadata(\n    options: YouTubeMetadataOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.client._post(\"/api/v1/youtube/metadata\", options);\n  }\n}\n","import { MissingAPIKeyError, ScavioError } from \"./errors.js\";\nimport { BASE_URL, DEFAULT_TIMEOUT, request } from \"./http.js\";\nimport { RateLimiter } from \"./rate-limiter.js\";\nimport { AmazonNamespace } from \"./namespaces/amazon.js\";\nimport type { GoogleSearchOptions } from \"./namespaces/google.js\";\nimport { GoogleNamespace } from \"./namespaces/google.js\";\nimport { RedditNamespace } from \"./namespaces/reddit.js\";\nimport { TikTokNamespace } from \"./namespaces/tiktok.js\";\nimport { WalmartNamespace } from \"./namespaces/walmart.js\";\nimport { YouTubeNamespace } from \"./namespaces/youtube.js\";\n\nexport interface ScavioConfig {\n  apiKey?: string;\n  baseUrl?: string;\n  timeout?: number;\n  maxRequestsPerSecond?: number;\n}\n\nexport class Scavio {\n  readonly google: GoogleNamespace;\n  readonly amazon: AmazonNamespace;\n  readonly walmart: WalmartNamespace;\n  readonly youtube: YouTubeNamespace;\n  readonly reddit: RedditNamespace;\n  readonly tiktok: TikTokNamespace;\n\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n  private readonly rateLimiter: RateLimiter;\n\n  constructor(config?: ScavioConfig) {\n    this.apiKey = config?.apiKey ?? process.env.SCAVIO_API_KEY ?? \"\";\n    if (!this.apiKey) {\n      throw new MissingAPIKeyError();\n    }\n\n    this.baseUrl = (config?.baseUrl ?? BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = config?.timeout ?? DEFAULT_TIMEOUT;\n\n    const rps = config?.maxRequestsPerSecond ?? 1;\n    if (rps < 1 || rps > 10) {\n      throw new ScavioError(\"maxRequestsPerSecond must be between 1 and 10\");\n    }\n    this.rateLimiter = new RateLimiter(rps);\n\n    this.google = new GoogleNamespace(this);\n    this.amazon = new AmazonNamespace(this);\n    this.walmart = new WalmartNamespace(this);\n    this.youtube = new YouTubeNamespace(this);\n    this.reddit = new RedditNamespace(this);\n    this.tiktok = new TikTokNamespace(this);\n  }\n\n  /** @internal */\n  async _post(\n    path: string,\n    body: object,\n  ): Promise<Record<string, unknown>> {\n    return request({\n      method: \"POST\",\n      path,\n      apiKey: this.apiKey,\n      baseUrl: this.baseUrl,\n      timeout: this.timeout,\n      rateLimiter: this.rateLimiter,\n      body: body as Record<string, unknown>,\n    });\n  }\n\n  /** @internal */\n  async _get(path: string): Promise<Record<string, unknown>> {\n    return request({\n      method: \"GET\",\n      path,\n      apiKey: this.apiKey,\n      baseUrl: this.baseUrl,\n      timeout: this.timeout,\n      rateLimiter: this.rateLimiter,\n    });\n  }\n\n  async search(\n    options: GoogleSearchOptions,\n  ): Promise<Record<string, unknown>> {\n    return this.google.search(options);\n  }\n\n  async getUsage(): Promise<Record<string, unknown>> {\n    return this._get(\"/api/v1/usage\");\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "scavio",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Scavio Search API — real-time Google, Amazon, Walmart, YouTube, Reddit, and TikTok data",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "search",
+    "api",
+    "ai",
+    "web-search",
+    "google-search",
+    "amazon",
+    "walmart",
+    "youtube",
+    "reddit",
+    "tiktok",
+    "serp",
+    "scraping"
+  ],
+  "license": "MIT",
+  "author": "Scavio <support@scavio.dev>",
+  "homepage": "https://scavio.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/scavio-ai/scavio-js"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^3.0.0"
+  }
+}