@search1api/client 0.1.0

package/dist/index.js

@@ -0,0 +1,425 @@
+// src/errors.ts
+var Search1APIError = class extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = new.target.name;
+  }
+};
+var Search1APIConfigurationError = class extends Search1APIError {
+};
+var APIConnectionError = class extends Search1APIError {
+};
+var APITimeoutError = class extends APIConnectionError {
+};
+var APIStatusError = class extends Search1APIError {
+  body;
+  headers;
+  requestId;
+  status;
+  constructor(message, status, headers, body) {
+    super(message);
+    this.status = status;
+    this.headers = headers;
+    this.body = body;
+    this.requestId = headers.get("x-request-id") ?? void 0;
+  }
+};
+var BadRequestError = class extends APIStatusError {
+};
+var AuthenticationError = class extends APIStatusError {
+};
+var PaymentRequiredError = class extends APIStatusError {
+};
+var NotFoundError = class extends APIStatusError {
+};
+var UnprocessableEntityError = class extends APIStatusError {
+};
+var RateLimitError = class extends APIStatusError {
+};
+var InternalServerError = class extends APIStatusError {
+};
+var DeepcrawlFailedError = class extends Search1APIError {
+  response;
+  constructor(response) {
+    super(
+      response.error || response.message || `Deepcrawl task ${response.taskId} failed`
+    );
+    this.response = response;
+  }
+};
+var DeepcrawlTimeoutError = class extends Search1APIError {
+  taskId;
+  constructor(taskId, timeoutMs) {
+    super(`Deepcrawl task ${taskId} did not finish within ${timeoutMs}ms`);
+    this.taskId = taskId;
+  }
+};
+function apiStatusError(status, headers, body) {
+  const message = body?.message || body?.detail || body?.error || body?.title || `Search1API request failed with status ${status}`;
+  const ErrorClass = status === 400 ? BadRequestError : status === 401 ? AuthenticationError : status === 402 ? PaymentRequiredError : status === 404 ? NotFoundError : status === 422 ? UnprocessableEntityError : status === 429 ? RateLimitError : status >= 500 ? InternalServerError : APIStatusError;
+  return new ErrorClass(message, status, headers, body);
+}
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.search1api.com";
+var DEFAULT_TIMEOUT_MS = 3e4;
+var DEFAULT_MAX_RETRIES = 2;
+var DEFAULT_RETRY_DELAY_MS = 500;
+var DEFAULT_DEEPCRAWL_POLL_INTERVAL_MS = 2e3;
+var DEFAULT_DEEPCRAWL_TIMEOUT_MS = 3e5;
+function environmentApiKey() {
+  const processLike = globalThis;
+  return processLike.process?.env?.SEARCH1API_API_KEY;
+}
+function compact(value) {
+  return Object.fromEntries(
+    Object.entries(value).filter(([, item]) => item !== void 0)
+  );
+}
+function searchBody(query, options) {
+  return compact({
+    query,
+    search_service: options.searchService,
+    max_results: options.maxResults,
+    crawl_results: options.crawlResults,
+    image: options.image,
+    include_sites: options.includeSites,
+    exclude_sites: options.excludeSites,
+    language: options.language,
+    time_range: options.timeRange
+  });
+}
+function newsBody(query, options) {
+  return compact({
+    query,
+    search_service: options.searchService,
+    max_results: options.maxResults,
+    crawl_results: options.crawlResults,
+    image: options.image,
+    include_sites: options.includeSites,
+    exclude_sites: options.excludeSites,
+    language: options.language,
+    time_range: options.timeRange
+  });
+}
+function retryAfterMs(response) {
+  const value = response.headers.get("retry-after");
+  if (!value) return void 0;
+  const seconds = Number(value);
+  if (Number.isFinite(seconds)) return Math.max(0, seconds * 1e3);
+  const date = Date.parse(value);
+  if (Number.isNaN(date)) return void 0;
+  return Math.max(0, date - Date.now());
+}
+function shouldRetry(status) {
+  return status === 429 || status >= 500;
+}
+function validateRequestLimits(timeoutMs, maxRetries) {
+  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+    throw new Search1APIConfigurationError("timeoutMs must be positive");
+  }
+  if (!Number.isInteger(maxRetries) || maxRetries < 0) {
+    throw new Search1APIConfigurationError(
+      "maxRetries must be a non-negative integer"
+    );
+  }
+}
+function sleep(ms, signal) {
+  if (signal?.aborted) {
+    return Promise.reject(
+      new APIConnectionError("Search1API request was aborted")
+    );
+  }
+  if (ms <= 0) return Promise.resolve();
+  return new Promise((resolve, reject) => {
+    const timeout = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(timeout);
+      reject(new APIConnectionError("Search1API request was aborted"));
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+async function errorBody(response) {
+  const text = await response.text();
+  if (!text) return void 0;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return { message: text };
+  }
+}
+var Search1API = class {
+  apiKey;
+  baseUrl;
+  maxRetries;
+  timeoutMs;
+  defaultHeaders;
+  fetchClient;
+  retryDelayMs;
+  constructor(options = {}) {
+    const normalized = typeof options === "string" ? { apiKey: options } : options;
+    const apiKey = normalized.apiKey || environmentApiKey();
+    if (!apiKey) {
+      throw new Search1APIConfigurationError(
+        "Missing API key. Pass apiKey or set SEARCH1API_API_KEY."
+      );
+    }
+    const fetchClient = normalized.fetch || globalThis.fetch;
+    if (!fetchClient) {
+      throw new Search1APIConfigurationError(
+        "No fetch implementation is available. Search1API requires Node.js 18+ or a custom fetch."
+      );
+    }
+    this.apiKey = apiKey;
+    this.baseUrl = (normalized.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.fetchClient = fetchClient;
+    this.timeoutMs = normalized.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.maxRetries = normalized.maxRetries ?? DEFAULT_MAX_RETRIES;
+    this.retryDelayMs = normalized.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
+    validateRequestLimits(this.timeoutMs, this.maxRetries);
+    if (!Number.isFinite(this.retryDelayMs) || this.retryDelayMs < 0) {
+      throw new Search1APIConfigurationError(
+        "retryDelayMs must be non-negative"
+      );
+    }
+    this.defaultHeaders = normalized.headers ?? {};
+  }
+  async search(query, options = {}, requestOptions = {}) {
+    return this.requestJson("/search", {
+      ...requestOptions,
+      method: "POST",
+      body: searchBody(query, options)
+    });
+  }
+  async searchBatch(requests, requestOptions = {}) {
+    return this.requestJson("/search", {
+      ...requestOptions,
+      method: "POST",
+      body: requests.map(({ query, ...options }) => searchBody(query, options))
+    });
+  }
+  async news(query, options = {}, requestOptions = {}) {
+    return this.requestJson("/news", {
+      ...requestOptions,
+      method: "POST",
+      body: newsBody(query, options)
+    });
+  }
+  async newsBatch(requests, requestOptions = {}) {
+    return this.requestJson("/news", {
+      ...requestOptions,
+      method: "POST",
+      body: requests.map(({ query, ...options }) => newsBody(query, options))
+    });
+  }
+  async crawl(url, options = {}, requestOptions = {}) {
+    return this.requestJson("/crawl", {
+      ...requestOptions,
+      method: "POST",
+      body: compact({ url, enableFallback: options.enableFallback })
+    });
+  }
+  async crawlBatch(requests, requestOptions = {}) {
+    return this.requestJson("/crawl", {
+      ...requestOptions,
+      method: "POST",
+      body: requests.map(
+        ({ url, enableFallback }) => compact({ url, enableFallback })
+      )
+    });
+  }
+  async sitemap(url, options = {}, requestOptions = {}) {
+    return this.requestJson("/sitemap", {
+      ...requestOptions,
+      method: "POST",
+      body: compact({ url, type: options.type })
+    });
+  }
+  async trending(searchService, options = {}, requestOptions = {}) {
+    return this.requestJson("/trending", {
+      ...requestOptions,
+      method: "POST",
+      body: compact({
+        search_service: searchService,
+        max_results: options.maxResults
+      })
+    });
+  }
+  async extract(url, options = {}, requestOptions = {}) {
+    return this.requestJson("/extract", {
+      ...requestOptions,
+      method: "POST",
+      body: compact({
+        url,
+        prompt: options.prompt,
+        response_format: options.responseFormat
+      })
+    });
+  }
+  async startDeepcrawl(url, options = {}, requestOptions = {}) {
+    return this.requestJson("/deepcrawl", {
+      ...requestOptions,
+      // Starting a task is not idempotent. A lost response could otherwise
+      // enqueue and charge a duplicate crawl.
+      maxRetries: requestOptions.maxRetries ?? 0,
+      method: "POST",
+      body: compact({ url, type: options.type })
+    });
+  }
+  async getDeepcrawlStatus(taskId, requestOptions = {}) {
+    return this.requestJson(
+      `/deepcrawl/status/${encodeURIComponent(taskId)}`,
+      requestOptions
+    );
+  }
+  async waitForDeepcrawl(taskId, options = {}) {
+    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_DEEPCRAWL_POLL_INTERVAL_MS;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_DEEPCRAWL_TIMEOUT_MS;
+    const deadline = Date.now() + timeoutMs;
+    while (true) {
+      const response = await this.getDeepcrawlStatus(taskId, {
+        signal: options.signal
+      });
+      if (response.success === true || response.status === "completed") {
+        return response;
+      }
+      if (response.success === false || response.status === "failed" || response.status === "not_found") {
+        throw new DeepcrawlFailedError(response);
+      }
+      if (Date.now() + pollIntervalMs > deadline) {
+        throw new DeepcrawlTimeoutError(taskId, timeoutMs);
+      }
+      await sleep(pollIntervalMs, options.signal);
+    }
+  }
+  async deepcrawl(url, options = {}, waitOptions = {}, requestOptions = {}) {
+    const task = await this.startDeepcrawl(url, options, requestOptions);
+    return this.waitForDeepcrawl(task.taskId, waitOptions);
+  }
+  async usage(period, requestOptions = {}) {
+    return this.requestJson("/usage", {
+      ...requestOptions,
+      query: { period }
+    });
+  }
+  async health(requestOptions = {}) {
+    return this.requestJson("/health", requestOptions);
+  }
+  async requestJson(path, options = {}) {
+    const response = await this.request(path, options);
+    const text = await response.text();
+    try {
+      return JSON.parse(text);
+    } catch (error) {
+      throw new Search1APIError(
+        `Search1API returned invalid JSON for ${path}`,
+        { cause: error }
+      );
+    }
+  }
+  async request(path, options = {}) {
+    const maxRetries = options.maxRetries ?? this.maxRetries;
+    validateRequestLimits(options.timeoutMs ?? this.timeoutMs, maxRetries);
+    const url = new URL(`${this.baseUrl}${path}`);
+    for (const [name, value] of Object.entries(options.query || {})) {
+      if (value !== void 0) url.searchParams.set(name, value);
+    }
+    for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
+      let response;
+      try {
+        response = await this.fetchOnce(url, options);
+      } catch (error) {
+        if (attempt < maxRetries && !options.signal?.aborted && (error instanceof APIConnectionError || error instanceof APITimeoutError)) {
+          await sleep(this.retryDelay(attempt), options.signal);
+          continue;
+        }
+        throw error;
+      }
+      if (response.ok) return response;
+      if (attempt < maxRetries && shouldRetry(response.status)) {
+        await sleep(
+          retryAfterMs(response) ?? this.retryDelay(attempt),
+          options.signal
+        );
+        continue;
+      }
+      throw apiStatusError(
+        response.status,
+        response.headers,
+        await errorBody(response)
+      );
+    }
+    throw new Search1APIError("Search1API request exhausted its retry budget");
+  }
+  async fetchOnce(url, options) {
+    const controller = new AbortController();
+    let timedOut = false;
+    const timeout = setTimeout(() => {
+      timedOut = true;
+      controller.abort();
+    }, options.timeoutMs ?? this.timeoutMs);
+    const onAbort = () => controller.abort(options.signal?.reason);
+    options.signal?.addEventListener("abort", onAbort, { once: true });
+    const headers = new Headers({
+      Accept: "application/json",
+      Authorization: `Bearer ${this.apiKey}`,
+      "X-Search1API-Client": "typescript/0.1.0",
+      ...this.defaultHeaders,
+      ...options.headers
+    });
+    if (options.body !== void 0)
+      headers.set("Content-Type", "application/json");
+    try {
+      return await this.fetchClient(url, {
+        method: options.method || "GET",
+        headers,
+        body: options.body === void 0 ? void 0 : JSON.stringify(options.body),
+        signal: controller.signal
+      });
+    } catch (error) {
+      if (timedOut) {
+        throw new APITimeoutError(
+          `Search1API request timed out after ${options.timeoutMs ?? this.timeoutMs}ms`,
+          { cause: error }
+        );
+      }
+      if (options.signal?.aborted) {
+        throw new APIConnectionError("Search1API request was aborted", {
+          cause: error
+        });
+      }
+      throw new APIConnectionError("Unable to connect to Search1API", {
+        cause: error
+      });
+    } finally {
+      clearTimeout(timeout);
+      options.signal?.removeEventListener("abort", onAbort);
+    }
+  }
+  retryDelay(attempt) {
+    const base = this.retryDelayMs * 2 ** attempt;
+    return base + Math.floor(Math.random() * base * 0.25);
+  }
+};
+export {
+  APIConnectionError,
+  APIStatusError,
+  APITimeoutError,
+  AuthenticationError,
+  BadRequestError,
+  DeepcrawlFailedError,
+  DeepcrawlTimeoutError,
+  InternalServerError,
+  NotFoundError,
+  PaymentRequiredError,
+  RateLimitError,
+  Search1API,
+  Search1APIConfigurationError,
+  Search1APIError,
+  UnprocessableEntityError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/errors.ts", "../src/client.ts"],
+  "sourcesContent": ["import type { ApiErrorBody, DeepcrawlStatusResponse } from './types.js';\n\nexport class Search1APIError extends Error {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = new.target.name;\n  }\n}\n\nexport class Search1APIConfigurationError extends Search1APIError {}\n\nexport class APIConnectionError extends Search1APIError {}\n\nexport class APITimeoutError extends APIConnectionError {}\n\nexport class APIStatusError extends Search1APIError {\n  readonly body?: ApiErrorBody;\n  readonly headers: Headers;\n  readonly requestId?: string;\n  readonly status: number;\n\n  constructor(\n    message: string,\n    status: number,\n    headers: Headers,\n    body?: ApiErrorBody\n  ) {\n    super(message);\n    this.status = status;\n    this.headers = headers;\n    this.body = body;\n    this.requestId = headers.get('x-request-id') ?? undefined;\n  }\n}\n\nexport class BadRequestError extends APIStatusError {}\nexport class AuthenticationError extends APIStatusError {}\nexport class PaymentRequiredError extends APIStatusError {}\nexport class NotFoundError extends APIStatusError {}\nexport class UnprocessableEntityError extends APIStatusError {}\nexport class RateLimitError extends APIStatusError {}\nexport class InternalServerError extends APIStatusError {}\n\nexport class DeepcrawlFailedError extends Search1APIError {\n  readonly response: DeepcrawlStatusResponse;\n\n  constructor(response: DeepcrawlStatusResponse) {\n    super(\n      response.error ||\n        response.message ||\n        `Deepcrawl task ${response.taskId} failed`\n    );\n    this.response = response;\n  }\n}\n\nexport class DeepcrawlTimeoutError extends Search1APIError {\n  readonly taskId: string;\n\n  constructor(taskId: string, timeoutMs: number) {\n    super(`Deepcrawl task ${taskId} did not finish within ${timeoutMs}ms`);\n    this.taskId = taskId;\n  }\n}\n\nexport function apiStatusError(\n  status: number,\n  headers: Headers,\n  body?: ApiErrorBody\n): APIStatusError {\n  const message =\n    body?.message ||\n    body?.detail ||\n    body?.error ||\n    body?.title ||\n    `Search1API request failed with status ${status}`;\n  const ErrorClass =\n    status === 400\n      ? BadRequestError\n      : status === 401\n        ? AuthenticationError\n        : status === 402\n          ? PaymentRequiredError\n          : status === 404\n            ? NotFoundError\n            : status === 422\n              ? UnprocessableEntityError\n              : status === 429\n                ? RateLimitError\n                : status >= 500\n                  ? InternalServerError\n                  : APIStatusError;\n\n  return new ErrorClass(message, status, headers, body);\n}\n", "import {\n  APIConnectionError,\n  APITimeoutError,\n  DeepcrawlFailedError,\n  DeepcrawlTimeoutError,\n  Search1APIConfigurationError,\n  Search1APIError,\n  apiStatusError,\n} from './errors.js';\nimport type {\n  ApiErrorBody,\n  BatchResponse,\n  CrawlOptions,\n  CrawlRequest,\n  CrawlResponse,\n  DeepcrawlAcceptedResponse,\n  DeepcrawlOptions,\n  DeepcrawlStatusResponse,\n  ExtractOptions,\n  ExtractResponse,\n  HealthResponse,\n  JsonValue,\n  NewsOptions,\n  NewsRequest,\n  NewsResponse,\n  RequestOptions,\n  Search1APIOptions,\n  SearchOptions,\n  SearchRequest,\n  SearchResponse,\n  SitemapOptions,\n  SitemapResponse,\n  TimeRange,\n  TrendingOptions,\n  TrendingResponse,\n  UsageResponse,\n  WaitForDeepcrawlOptions,\n} from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://api.search1api.com';\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst DEFAULT_MAX_RETRIES = 2;\nconst DEFAULT_RETRY_DELAY_MS = 500;\nconst DEFAULT_DEEPCRAWL_POLL_INTERVAL_MS = 2_000;\nconst DEFAULT_DEEPCRAWL_TIMEOUT_MS = 300_000;\n\ntype RequestBody = JsonValue | Record<string, unknown> | unknown[];\n\ninterface InternalRequestOptions extends RequestOptions {\n  body?: RequestBody;\n  method?: 'GET' | 'POST';\n  query?: Record<string, string | undefined>;\n}\n\nfunction environmentApiKey(): string | undefined {\n  const processLike = globalThis as typeof globalThis & {\n    process?: { env?: Record<string, string | undefined> };\n  };\n  return processLike.process?.env?.SEARCH1API_API_KEY;\n}\n\nfunction compact<T extends Record<string, unknown>>(value: T): Partial<T> {\n  return Object.fromEntries(\n    Object.entries(value).filter(([, item]) => item !== undefined)\n  ) as Partial<T>;\n}\n\nfunction searchBody(query: string, options: SearchOptions) {\n  return compact({\n    query,\n    search_service: options.searchService,\n    max_results: options.maxResults,\n    crawl_results: options.crawlResults,\n    image: options.image,\n    include_sites: options.includeSites,\n    exclude_sites: options.excludeSites,\n    language: options.language,\n    time_range: options.timeRange,\n  });\n}\n\nfunction newsBody(query: string, options: NewsOptions) {\n  return compact({\n    query,\n    search_service: options.searchService,\n    max_results: options.maxResults,\n    crawl_results: options.crawlResults,\n    image: options.image,\n    include_sites: options.includeSites,\n    exclude_sites: options.excludeSites,\n    language: options.language,\n    time_range: options.timeRange,\n  });\n}\n\nfunction retryAfterMs(response: Response): number | undefined {\n  const value = response.headers.get('retry-after');\n  if (!value) return undefined;\n\n  const seconds = Number(value);\n  if (Number.isFinite(seconds)) return Math.max(0, seconds * 1_000);\n\n  const date = Date.parse(value);\n  if (Number.isNaN(date)) return undefined;\n  return Math.max(0, date - Date.now());\n}\n\nfunction shouldRetry(status: number): boolean {\n  return status === 429 || status >= 500;\n}\n\nfunction validateRequestLimits(timeoutMs: number, maxRetries: number): void {\n  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n    throw new Search1APIConfigurationError('timeoutMs must be positive');\n  }\n  if (!Number.isInteger(maxRetries) || maxRetries < 0) {\n    throw new Search1APIConfigurationError(\n      'maxRetries must be a non-negative integer'\n    );\n  }\n}\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  if (signal?.aborted) {\n    return Promise.reject(\n      new APIConnectionError('Search1API request was aborted')\n    );\n  }\n  if (ms <= 0) return Promise.resolve();\n\n  return new Promise((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(timeout);\n      reject(new APIConnectionError('Search1API request was aborted'));\n    };\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n\nasync function errorBody(\n  response: Response\n): Promise<ApiErrorBody | undefined> {\n  const text = await response.text();\n  if (!text) return undefined;\n  try {\n    return JSON.parse(text) as ApiErrorBody;\n  } catch {\n    return { message: text };\n  }\n}\n\nexport class Search1API {\n  readonly apiKey: string;\n  readonly baseUrl: string;\n  readonly maxRetries: number;\n  readonly timeoutMs: number;\n\n  private readonly defaultHeaders: Record<string, string>;\n  private readonly fetchClient: typeof fetch;\n  private readonly retryDelayMs: number;\n\n  constructor(options: Search1APIOptions | string = {}) {\n    const normalized =\n      typeof options === 'string' ? { apiKey: options } : options;\n    const apiKey = normalized.apiKey || environmentApiKey();\n    if (!apiKey) {\n      throw new Search1APIConfigurationError(\n        'Missing API key. Pass apiKey or set SEARCH1API_API_KEY.'\n      );\n    }\n\n    const fetchClient = normalized.fetch || globalThis.fetch;\n    if (!fetchClient) {\n      throw new Search1APIConfigurationError(\n        'No fetch implementation is available. Search1API requires Node.js 18+ or a custom fetch.'\n      );\n    }\n\n    this.apiKey = apiKey;\n    this.baseUrl = (normalized.baseUrl || DEFAULT_BASE_URL).replace(/\\/+$/, '');\n    this.fetchClient = fetchClient;\n    this.timeoutMs = normalized.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    this.maxRetries = normalized.maxRetries ?? DEFAULT_MAX_RETRIES;\n    this.retryDelayMs = normalized.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;\n    validateRequestLimits(this.timeoutMs, this.maxRetries);\n    if (!Number.isFinite(this.retryDelayMs) || this.retryDelayMs < 0) {\n      throw new Search1APIConfigurationError(\n        'retryDelayMs must be non-negative'\n      );\n    }\n    this.defaultHeaders = normalized.headers ?? {};\n  }\n\n  async search(\n    query: string,\n    options: SearchOptions = {},\n    requestOptions: RequestOptions = {}\n  ): Promise<SearchResponse> {\n    return this.requestJson<SearchResponse>('/search', {\n      ...requestOptions,\n      method: 'POST',\n      body: searchBody(query, options),\n    });\n  }\n\n  async searchBatch(\n    requests: SearchRequest[],\n    requestOptions: RequestOptions = {}\n  ): Promise<BatchResponse<SearchResponse>> {\n    return this.requestJson<BatchResponse<SearchResponse>>('/search', {\n      ...requestOptions,\n      method: 'POST',\n      body: requests.map(({ query, ...options }) => searchBody(query, options)),\n    });\n  }\n\n  async news(\n    query: string,\n    options: NewsOptions = {},\n    requestOptions: RequestOptions = {}\n  ): Promise<NewsResponse> {\n    return this.requestJson<NewsResponse>('/news', {\n      ...requestOptions,\n      method: 'POST',\n      body: newsBody(query, options),\n    });\n  }\n\n  async newsBatch(\n    requests: NewsRequest[],\n    requestOptions: RequestOptions = {}\n  ): Promise<BatchResponse<NewsResponse>> {\n    return this.requestJson<BatchResponse<NewsResponse>>('/news', {\n      ...requestOptions,\n      method: 'POST',\n      body: requests.map(({ query, ...options }) => newsBody(query, options)),\n    });\n  }\n\n  async crawl(\n    url: string,\n    options: CrawlOptions = {},\n    requestOptions: RequestOptions = {}\n  ): Promise<CrawlResponse> {\n    return this.requestJson<CrawlResponse>('/crawl', {\n      ...requestOptions,\n      method: 'POST',\n      body: compact({ url, enableFallback: options.enableFallback }),\n    });\n  }\n\n  async crawlBatch(\n    requests: CrawlRequest[],\n    requestOptions: RequestOptions = {}\n  ): Promise<CrawlResponse[]> {\n    return this.requestJson<CrawlResponse[]>('/crawl', {\n      ...requestOptions,\n      method: 'POST',\n      body: requests.map(({ url, enableFallback }) =>\n        compact({ url, enableFallback })\n      ),\n    });\n  }\n\n  async sitemap(\n    url: string,\n    options: SitemapOptions = {},\n    requestOptions: RequestOptions = {}\n  ): Promise<SitemapResponse> {\n    return this.requestJson<SitemapResponse>('/sitemap', {\n      ...requestOptions,\n      method: 'POST',\n      body: compact({ url, type: options.type }),\n    });\n  }\n\n  async trending(\n    searchService: string,\n    options: TrendingOptions = {},\n    requestOptions: RequestOptions = {}\n  ): Promise<TrendingResponse> {\n    return this.requestJson<TrendingResponse>('/trending', {\n      ...requestOptions,\n      method: 'POST',\n      body: compact({\n        search_service: searchService,\n        max_results: options.maxResults,\n      }),\n    });\n  }\n\n  async extract<T = JsonValue>(\n    url: string,\n    options: ExtractOptions = {},\n    requestOptions: RequestOptions = {}\n  ): Promise<ExtractResponse<T>> {\n    return this.requestJson<ExtractResponse<T>>('/extract', {\n      ...requestOptions,\n      method: 'POST',\n      body: compact({\n        url,\n        prompt: options.prompt,\n        response_format: options.responseFormat,\n      }),\n    });\n  }\n\n  async startDeepcrawl(\n    url: string,\n    options: DeepcrawlOptions = {},\n    requestOptions: RequestOptions = {}\n  ): Promise<DeepcrawlAcceptedResponse> {\n    return this.requestJson<DeepcrawlAcceptedResponse>('/deepcrawl', {\n      ...requestOptions,\n      // Starting a task is not idempotent. A lost response could otherwise\n      // enqueue and charge a duplicate crawl.\n      maxRetries: requestOptions.maxRetries ?? 0,\n      method: 'POST',\n      body: compact({ url, type: options.type }),\n    });\n  }\n\n  async getDeepcrawlStatus(\n    taskId: string,\n    requestOptions: RequestOptions = {}\n  ): Promise<DeepcrawlStatusResponse> {\n    return this.requestJson<DeepcrawlStatusResponse>(\n      `/deepcrawl/status/${encodeURIComponent(taskId)}`,\n      requestOptions\n    );\n  }\n\n  async waitForDeepcrawl(\n    taskId: string,\n    options: WaitForDeepcrawlOptions = {}\n  ): Promise<DeepcrawlStatusResponse> {\n    const pollIntervalMs =\n      options.pollIntervalMs ?? DEFAULT_DEEPCRAWL_POLL_INTERVAL_MS;\n    const timeoutMs = options.timeoutMs ?? DEFAULT_DEEPCRAWL_TIMEOUT_MS;\n    const deadline = Date.now() + timeoutMs;\n\n    while (true) {\n      const response = await this.getDeepcrawlStatus(taskId, {\n        signal: options.signal,\n      });\n      if (response.success === true || response.status === 'completed') {\n        return response;\n      }\n      if (\n        response.success === false ||\n        response.status === 'failed' ||\n        response.status === 'not_found'\n      ) {\n        throw new DeepcrawlFailedError(response);\n      }\n      if (Date.now() + pollIntervalMs > deadline) {\n        throw new DeepcrawlTimeoutError(taskId, timeoutMs);\n      }\n      await sleep(pollIntervalMs, options.signal);\n    }\n  }\n\n  async deepcrawl(\n    url: string,\n    options: DeepcrawlOptions = {},\n    waitOptions: WaitForDeepcrawlOptions = {},\n    requestOptions: RequestOptions = {}\n  ): Promise<DeepcrawlStatusResponse> {\n    const task = await this.startDeepcrawl(url, options, requestOptions);\n    return this.waitForDeepcrawl(task.taskId, waitOptions);\n  }\n\n  async usage(\n    period?: TimeRange,\n    requestOptions: RequestOptions = {}\n  ): Promise<UsageResponse> {\n    return this.requestJson<UsageResponse>('/usage', {\n      ...requestOptions,\n      query: { period },\n    });\n  }\n\n  async health(requestOptions: RequestOptions = {}): Promise<HealthResponse> {\n    return this.requestJson<HealthResponse>('/health', requestOptions);\n  }\n\n  private async requestJson<T>(\n    path: string,\n    options: InternalRequestOptions = {}\n  ): Promise<T> {\n    const response = await this.request(path, options);\n    const text = await response.text();\n    try {\n      return JSON.parse(text) as T;\n    } catch (error) {\n      throw new Search1APIError(\n        `Search1API returned invalid JSON for ${path}`,\n        { cause: error }\n      );\n    }\n  }\n\n  private async request(\n    path: string,\n    options: InternalRequestOptions = {}\n  ): Promise<Response> {\n    const maxRetries = options.maxRetries ?? this.maxRetries;\n    validateRequestLimits(options.timeoutMs ?? this.timeoutMs, maxRetries);\n    const url = new URL(`${this.baseUrl}${path}`);\n    for (const [name, value] of Object.entries(options.query || {})) {\n      if (value !== undefined) url.searchParams.set(name, value);\n    }\n\n    for (let attempt = 0; attempt <= maxRetries; attempt += 1) {\n      let response: Response;\n      try {\n        response = await this.fetchOnce(url, options);\n      } catch (error) {\n        if (\n          attempt < maxRetries &&\n          !options.signal?.aborted &&\n          (error instanceof APIConnectionError ||\n            error instanceof APITimeoutError)\n        ) {\n          await sleep(this.retryDelay(attempt), options.signal);\n          continue;\n        }\n        throw error;\n      }\n\n      if (response.ok) return response;\n      if (attempt < maxRetries && shouldRetry(response.status)) {\n        await sleep(\n          retryAfterMs(response) ?? this.retryDelay(attempt),\n          options.signal\n        );\n        continue;\n      }\n\n      throw apiStatusError(\n        response.status,\n        response.headers,\n        await errorBody(response)\n      );\n    }\n\n    throw new Search1APIError('Search1API request exhausted its retry budget');\n  }\n\n  private async fetchOnce(\n    url: URL,\n    options: InternalRequestOptions\n  ): Promise<Response> {\n    const controller = new AbortController();\n    let timedOut = false;\n    const timeout = setTimeout(() => {\n      timedOut = true;\n      controller.abort();\n    }, options.timeoutMs ?? this.timeoutMs);\n    const onAbort = () => controller.abort(options.signal?.reason);\n    options.signal?.addEventListener('abort', onAbort, { once: true });\n\n    const headers = new Headers({\n      Accept: 'application/json',\n      Authorization: `Bearer ${this.apiKey}`,\n      'X-Search1API-Client': 'typescript/0.1.0',\n      ...this.defaultHeaders,\n      ...options.headers,\n    });\n    if (options.body !== undefined)\n      headers.set('Content-Type', 'application/json');\n\n    try {\n      return await this.fetchClient(url, {\n        method: options.method || 'GET',\n        headers,\n        body:\n          options.body === undefined ? undefined : JSON.stringify(options.body),\n        signal: controller.signal,\n      });\n    } catch (error) {\n      if (timedOut) {\n        throw new APITimeoutError(\n          `Search1API request timed out after ${options.timeoutMs ?? this.timeoutMs}ms`,\n          { cause: error }\n        );\n      }\n      if (options.signal?.aborted) {\n        throw new APIConnectionError('Search1API request was aborted', {\n          cause: error,\n        });\n      }\n      throw new APIConnectionError('Unable to connect to Search1API', {\n        cause: error,\n      });\n    } finally {\n      clearTimeout(timeout);\n      options.signal?.removeEventListener('abort', onAbort);\n    }\n  }\n\n  private retryDelay(attempt: number): number {\n    const base = this.retryDelayMs * 2 ** attempt;\n    return base + Math.floor(Math.random() * base * 0.25);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/types.d.ts

@@ -0,0 +1,199 @@
+export type JsonPrimitive = boolean | number | string | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type TimeRange = 'day' | 'week' | 'month' | 'year';
+export type SearchEngine = 'google' | 'bing' | 'duckduckgo' | 'yahoo' | 'youtube' | 'x' | 'reddit' | 'github' | 'arxiv' | 'wechat' | 'bilibili' | 'imdb' | 'wikipedia' | 'sogou' | 'baidu' | '360' | 'quark';
+export type NewsEngine = 'google' | 'bing' | 'duckduckgo' | 'yahoo' | 'hackernews' | 'reuters';
+export interface SearchOptions {
+    searchService?: SearchEngine;
+    maxResults?: number;
+    crawlResults?: number;
+    image?: boolean;
+    includeSites?: string[];
+    excludeSites?: string[];
+    language?: string;
+    timeRange?: TimeRange;
+}
+export interface SearchRequest extends SearchOptions {
+    query: string;
+}
+export interface NewsOptions {
+    searchService?: NewsEngine;
+    maxResults?: number;
+    crawlResults?: number;
+    image?: boolean;
+    includeSites?: string[];
+    excludeSites?: string[];
+    language?: string;
+    timeRange?: TimeRange;
+}
+export interface NewsRequest extends NewsOptions {
+    query: string;
+}
+export interface SearchParameters {
+    query: string;
+    search_service?: SearchEngine;
+    max_results: number;
+    crawl_results: number;
+    image: boolean;
+    include_sites: string[];
+    exclude_sites: string[];
+    language?: string;
+    time_range?: TimeRange;
+}
+export interface NewsParameters extends Omit<SearchParameters, 'search_service'> {
+    search_service?: NewsEngine;
+}
+export interface SearchResult {
+    title: string;
+    link: string;
+    snippet: string;
+    content?: string;
+    [key: string]: unknown;
+}
+export interface SearchResponse {
+    searchParameters: SearchParameters;
+    results: SearchResult[];
+    images?: string[];
+}
+export interface NewsResponse {
+    searchParameters: NewsParameters;
+    results: SearchResult[];
+    images?: string[];
+}
+export interface BatchItem<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        message: string;
+        statusCode: number;
+    };
+    cost: number;
+}
+export interface BatchSummary {
+    total: number;
+    successful: number;
+    failed: number;
+    totalCost: number;
+}
+export interface BatchResponse<T> {
+    results: BatchItem<T>[];
+    summary: BatchSummary;
+}
+export interface CrawlOptions {
+    enableFallback?: boolean;
+}
+export interface CrawlRequest extends CrawlOptions {
+    url: string;
+}
+export interface CrawlResult {
+    title: string;
+    link: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface CrawlResponse {
+    crawlParameters: {
+        url: string;
+    };
+    results: CrawlResult;
+}
+export interface SitemapOptions {
+    type?: 'sitemap' | 'all';
+}
+export interface SitemapResponse {
+    links: string[];
+}
+export interface TrendingOptions {
+    maxResults?: number;
+}
+export interface TrendingResult {
+    title: string;
+    url: string;
+    description?: string | null;
+}
+export interface TrendingResponse {
+    trendingParameters: {
+        search_service: string;
+        max_results?: number;
+    };
+    results: TrendingResult[];
+}
+export interface ExtractOptions {
+    prompt?: string;
+    responseFormat?: Record<string, JsonValue>;
+}
+export interface ExtractResponse<T = JsonValue> {
+    success: true;
+    extractParameters: {
+        url: string;
+    };
+    results: T;
+}
+export interface DeepcrawlOptions {
+    type?: 'sitemap' | 'all';
+}
+export interface DeepcrawlAcceptedResponse {
+    taskId: string;
+    status: 'queued' | string;
+}
+export type DeepcrawlStatus = 'queued' | 'waiting' | 'processing' | 'completed' | 'failed' | 'not_found';
+export interface DeepcrawlStatusResponse {
+    taskId: string;
+    status?: DeepcrawlStatus | string;
+    success?: boolean;
+    message?: string;
+    error?: string | null;
+    r2Key?: string;
+    zipUrl?: string | null;
+    [key: string]: unknown;
+}
+export interface WaitForDeepcrawlOptions {
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface UsageResponse {
+    usage: number;
+    user_id: string | null;
+    credential_type: 'api_key' | 'oauth' | string;
+    client_id: string | null;
+}
+export interface HealthResponse {
+    status: string;
+    timestamp?: string;
+    version?: string;
+}
+export interface RequestOptions {
+    headers?: Record<string, string>;
+    maxRetries?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+export interface Search1APIOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    headers?: Record<string, string>;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    timeoutMs?: number;
+}
+export interface ApiErrorBody {
+    ok?: false;
+    error?: string;
+    message?: string;
+    errors?: Array<{
+        field?: string;
+        message: string;
+        code?: string;
+    }>;
+    type?: string;
+    title?: string;
+    status?: number;
+    detail?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map