@openserp/sdk 0.1.1 → 0.1.3

package/README.md

@@ -4,9 +4,37 @@
 [![npm downloads](https://img.shields.io/npm/dm/@openserp/sdk.svg)](https://www.npmjs.com/package/@openserp/sdk)
 [![license](https://img.shields.io/npm/l/@openserp/sdk.svg)](https://github.com/karust/openserp/blob/master/LICENSE)
 
+```bash
+npm install @openserp/sdk
+```
+
+Cloud:
+
+```ts
+import { OpenSERP } from "@openserp/sdk";
+
+const client = new OpenSERP({ apiKey: process.env.OPENSERP_KEY });
+const { results } = await client.search({ engine: "google", text: "openserp" });
+
+console.log(results[0]?.title, results[0]?.url);
+```
+
+Self-hosted:
+
+```ts
+import { OpenSERP } from "@openserp/sdk";
+
+const client = new OpenSERP({ baseUrl: "http://localhost:7000" });
+const { results } = await client.search({ engine: "bing", text: "openserp" });
+
+console.log(results[0]?.title, results[0]?.url);
+```
+
 Universal TypeScript / JavaScript SDK for the **OpenSERP** multi-engine SERP API — Google, Bing, Yandex, Baidu, DuckDuckGo, and Ecosia results in a single call. Works against the self-hosted [open source server](https://github.com/karust/openserp) and against [OpenSERP Cloud](https://openserp.org/cloud) with the same code.
 
-Use it for AI grounding, RAG pipelines, LLM tool use, SEO monitoring, competitor analysis, and search-powered automations. Open-source alternative to SerpAPI and DataForSEO.
+Use it for AI grounding, RAG pipelines, LLM tool use, agent tool use, LangChain / LlamaIndex integrations, SEO rank tracking, competitor analysis, and search-powered automations. Open-source alternative to SerpAPI, DataForSEO, ScrapingBee, Bright Data SERP, Oxylabs SERP, and Zenserp.
+
+> Also available for Python: [`openserp`](https://pypi.org/project/openserp/) ([source](https://github.com/karust/openserp/tree/master/integrations/sdk-python)).
 
 > **Alpha — the API may change before `1.0.0`.** Pin a version in production.
 
@@ -22,7 +50,6 @@ Use it for AI grounding, RAG pipelines, LLM tool use, SEO monitoring, competitor
 - [Telemetry](#telemetry)
 - [Error handling](#error-handling)
 - [Retry hook](#retry-hook)
-- [Edge runtimes](#edge-runtimes)
 - [Use cases](#use-cases)
 - [Development](#development)
 
@@ -162,11 +189,7 @@ await client.enginesStatus();
 await client.enginesCapabilities();
 ```
 
-The backend is inferred from `baseUrl` and `apiKey`. Override explicitly when needed:
-
-```ts
-client.config.backend = "oss";
-```
+The backend is inferred from `baseUrl` and `apiKey`. Pass `backend: "oss"` or `backend: "cloud"` to the constructor to override.
 
 ## Telemetry
 
@@ -204,10 +227,19 @@ try {
 The SDK does not apply a retry policy. Provide a hook when you want one:
 
 ```ts
+import { OpenSERP, SERPError } from "@openserp/sdk";
+
+const RETRYABLE = new Set([408, 429, 500, 502, 503]);
+
 const client = new OpenSERP({
-  baseUrl: "http://localhost:7000",
-  retry: (err, attempt) => {
-    return err instanceof SERPError && err.status >= 500 && attempt < 2;
+  apiKey: process.env.OPENSERP_KEY,
+  retry: async (err, attempt) => {
+    if (attempt >= 2 || !(err instanceof SERPError) || !RETRYABLE.has(err.status)) {
+      return false;
+    }
+    const wait = Math.min(2 ** attempt * 250, 8_000) + Math.random() * 250;
+    await new Promise((r) => setTimeout(r, wait));
+    return true;
   },
 });
 ```
@@ -218,20 +250,18 @@ const client = new OpenSERP({
 - **LLM tool use** — expose `client.search` as a tool to your agent.
 - **SEO monitoring** — daily rank tracking across multiple engines and regions, export to Sheets or Notion.
 - **Competitor analysis** — weekly diff of top-10 results for a keyword set.
-- **Automations**
 - **Data pipelines** — stream SERPs to ClickHouse, BigQuery, or a DataFrame for NLP on snippets.
 
 ## Development
 
 ```bash
-corepack enable
-corepack pnpm install
-corepack pnpm test
-corepack pnpm build
+pnpm install
+pnpm test
+pnpm build
 ```
 
 Regenerate OSS API types after changing `openserp/docs/openapi.yaml`:
 
 ```bash
-corepack pnpm generate:types
+pnpm generate:types
 ```

package/dist/index.cjs

@@ -147,6 +147,80 @@ function isErrorResponse(body) {
   return typeof body === "object" && body !== null && "error" in body;
 }
 
+// src/debug.ts
+var NO_OP = {
+  level: "off",
+  emit() {
+  }
+};
+function resolveDebug(config) {
+  const setting = config.debug ?? envDebug();
+  if (!setting) {
+    return NO_OP;
+  }
+  if (typeof setting === "function") {
+    return { level: "verbose", emit: guard(setting) };
+  }
+  const level = setting === "verbose" ? "verbose" : "info";
+  return { level, emit: consoleSink };
+}
+function envDebug() {
+  const value = typeof process !== "undefined" ? process.env?.OPENSERP_DEBUG : void 0;
+  if (!value) {
+    return void 0;
+  }
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "verbose") {
+    return "verbose";
+  }
+  if (normalized === "1" || normalized === "true") {
+    return true;
+  }
+  return void 0;
+}
+function guard(sink) {
+  return (event) => {
+    try {
+      sink(event);
+    } catch {
+    }
+  };
+}
+var consoleSink = (event) => {
+  switch (event.type) {
+    case "request":
+      console.error(`[openserp] \u2192 ${event.method} ${event.url}`);
+      if (event.headers) {
+        console.error("[openserp]   headers:", event.headers);
+      }
+      break;
+    case "response": {
+      const engine = event.engineUsed ? ` engine=${event.engineUsed}` : "";
+      const reqId = event.requestId ? ` request-id=${event.requestId}` : "";
+      console.error(
+        `[openserp] \u2190 ${event.status} ${event.method} ${event.url} (${event.durationMs}ms)${engine}${reqId}`
+      );
+      if (event.headers) {
+        console.error("[openserp]   headers:", event.headers);
+      }
+      break;
+    }
+    case "error":
+      console.error(
+        `[openserp] \u2715 ${event.method} ${event.url} (${event.durationMs}ms):`,
+        event.error
+      );
+      break;
+  }
+};
+function dumpHeaders(headers) {
+  const out = {};
+  for (const [key, value] of headers) {
+    out[key] = key.toLowerCase() === "authorization" ? "Bearer ***" : value;
+  }
+  return out;
+}
+
 // src/request.ts
 async function request(context, options) {
   let attempt = 0;
@@ -176,13 +250,24 @@ async function requestOnce({ baseUrl, config, setLastResponse }, options) {
   for (const [key, value] of new Headers(options.headers)) {
     headers.set(key, value);
   }
+  const debug = resolveDebug(config);
+  const method = options.method ?? "GET";
+  if (debug.level !== "off") {
+    debug.emit({
+      type: "request",
+      method,
+      url: url.toString(),
+      ...debug.level === "verbose" ? { headers: dumpHeaders(headers) } : {}
+    });
+  }
   const timeoutMs = config.timeoutMs ?? 3e4;
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeoutMs);
+  const startedAt = Date.now();
   let response;
   try {
     const init = {
-      method: options.method ?? "GET",
+      method,
       headers,
       signal: controller.signal
     };
@@ -191,14 +276,34 @@ async function requestOnce({ baseUrl, config, setLastResponse }, options) {
     }
     response = await fetchImpl(url, init);
   } catch (err) {
-    if (isAbortError(err)) {
-      throw new TimeoutError(timeoutMs, err);
+    const error = isAbortError(err) ? new TimeoutError(timeoutMs, err) : err;
+    if (debug.level !== "off") {
+      debug.emit({
+        type: "error",
+        method,
+        url: url.toString(),
+        durationMs: Date.now() - startedAt,
+        error
+      });
     }
-    throw err;
+    throw error;
   } finally {
     clearTimeout(timer);
   }
-  setLastResponse(readLastResponse(response));
+  const last = readLastResponse(response);
+  setLastResponse(last);
+  if (debug.level !== "off") {
+    debug.emit({
+      type: "response",
+      method,
+      url: url.toString(),
+      status: response.status,
+      engineUsed: last.engineUsed,
+      requestId: last.requestId,
+      durationMs: Date.now() - startedAt,
+      ...debug.level === "verbose" ? { headers: dumpHeaders(response.headers) } : {}
+    });
+  }
   const body = await readBody(response, options.format);
   if (!response.ok) {
     throw errorFromResponse(response.status, body, response.headers.get("x-request-id") ?? void 0);

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/backend.ts","../src/errors.ts","../src/request.ts","../src/client.ts"],"sourcesContent":["export { OpenSERP } from \"./client\";\nexport {\n  CLOUD_BASE_URL,\n  OSS_BASE_URL,\n  inferBackend,\n  normalizeBaseUrl,\n  resolveBaseUrl,\n} from \"./backend\";\nexport {\n  CaptchaError,\n  CloudOnlyError,\n  OssOnlyError,\n  RateLimitError,\n  SERPError,\n  TimeoutError,\n} from \"./errors\";\nexport type {\n  Backend,\n  CacheStats,\n  CircuitBreakerStatsResponse,\n  Engine,\n  ErrorResponse,\n  HealthStatus,\n  ImageEnvelope,\n  ImageParams,\n  LastResponse,\n  MegaEnginesResponse,\n  MegaImageParams,\n  MegaMode,\n  MegaSearchEnvelope,\n  MegaSearchParams,\n  OpenSERPConfig,\n  ParseParams,\n  ProxyStats,\n  ReadinessStatus,\n  ResponseFormat,\n  SearchEnvelope,\n  SearchParams,\n  StatsResponse,\n} from \"./types/public\";\nexport type {\n  CloudAccount,\n  CreditInfo,\n  EngineCapability,\n  EngineStatus,\n  EnginesCapabilities,\n  EnginesStatus,\n  ModeCapability,\n  OverallStatus,\n  Price,\n  Pricing,\n} from \"./types/cloud\";\n","import type { Backend, OpenSERPConfig } from \"./types/public\";\n\nexport const OSS_BASE_URL = \"http://localhost:7000\";\nexport const CLOUD_BASE_URL = \"https://api.openserp.org/v1\";\n\nexport function normalizeBaseUrl(baseUrl: string): string {\n  return baseUrl.replace(/\\/+$/, \"\");\n}\n\nexport function resolveBaseUrl(config: OpenSERPConfig): string {\n  if (config.baseUrl) {\n    return normalizeBaseUrl(config.baseUrl);\n  }\n\n  if (config.apiKey) {\n    return CLOUD_BASE_URL;\n  }\n\n  return OSS_BASE_URL;\n}\n\nexport function inferBackend(config: Pick<OpenSERPConfig, \"apiKey\" | \"baseUrl\" | \"backend\">): Backend {\n  if (config.backend) {\n    return config.backend;\n  }\n\n  if (config.baseUrl) {\n    try {\n      if (new URL(config.baseUrl).hostname === \"api.openserp.org\") {\n        return \"cloud\";\n      }\n    } catch {\n      if (config.baseUrl.includes(\"api.openserp.org\")) {\n        return \"cloud\";\n      }\n    }\n  }\n\n  if (config.apiKey) {\n    return \"cloud\";\n  }\n\n  return \"oss\";\n}\n","import type { ErrorResponse } from \"./types/public\";\n\nexport class SERPError extends Error {\n  readonly status: number;\n  readonly code?: string | undefined;\n  readonly reason?: string | undefined;\n  readonly requestId?: string | undefined;\n  readonly meta?: Record<string, unknown> | undefined;\n  readonly response?: ErrorResponse | unknown | undefined;\n\n  constructor(message: string, options: {\n    status?: number | undefined;\n    code?: string | undefined;\n    reason?: string | undefined;\n    requestId?: string | undefined;\n    meta?: Record<string, unknown> | undefined;\n    response?: ErrorResponse | unknown | undefined;\n    cause?: unknown | undefined;\n  } = {}) {\n    super(message, { cause: options.cause });\n    this.name = \"SERPError\";\n    this.status = options.status ?? 0;\n    this.code = options.code;\n    this.reason = options.reason;\n    this.requestId = options.requestId;\n    this.meta = options.meta;\n    this.response = options.response;\n  }\n}\n\nexport class RateLimitError extends SERPError {\n  constructor(message: string, options: ConstructorParameters<typeof SERPError>[1] = {}) {\n    super(message, options);\n    this.name = \"RateLimitError\";\n  }\n}\n\nexport class CaptchaError extends SERPError {\n  constructor(message: string, options: ConstructorParameters<typeof SERPError>[1] = {}) {\n    super(message, options);\n    this.name = \"CaptchaError\";\n  }\n}\n\nexport class CloudOnlyError extends SERPError {\n  constructor(method: string) {\n    super(`${method} is only available against OpenSERP Cloud. Configure apiKey/baseUrl for https://api.openserp.org/v1 or set client.config.backend = \"cloud\".`);\n    this.name = \"CloudOnlyError\";\n  }\n}\n\nexport class OssOnlyError extends SERPError {\n  constructor(method: string) {\n    super(`${method} is only available against a self-hosted OpenSERP server. Configure baseUrl for your OSS server or set client.config.backend = \"oss\".`);\n    this.name = \"OssOnlyError\";\n  }\n}\n\nexport class TimeoutError extends SERPError {\n  constructor(timeoutMs: number, cause?: unknown) {\n    super(`OpenSERP request timed out after ${timeoutMs}ms`, {\n      code: \"request_timeout\",\n      cause,\n    });\n    this.name = \"TimeoutError\";\n  }\n}\n\nexport function errorFromResponse(status: number, body: unknown, requestId?: string): SERPError {\n  const data = isErrorResponse(body) ? body : undefined;\n  const code = data?.error;\n  const message = data?.message ?? `OpenSERP request failed with status ${status}`;\n  const options = {\n    status,\n    code,\n    reason: data?.reason,\n    requestId: data?.request_id ?? requestId,\n    meta: data?.meta as Record<string, unknown> | undefined,\n    response: body,\n  };\n\n  if (status === 429 || code === \"rate_limited\") {\n    return new RateLimitError(message, options);\n  }\n\n  if (code === \"captcha_detected\") {\n    return new CaptchaError(message, options);\n  }\n\n  return new SERPError(message, options);\n}\n\nfunction isErrorResponse(body: unknown): body is ErrorResponse {\n  return typeof body === \"object\" && body !== null && \"error\" in body;\n}\n","import { TimeoutError, errorFromResponse } from \"./errors\";\nimport type { LastResponse, OpenSERPConfig, ResponseFormat } from \"./types/public\";\n\nexport type QueryValue =\n  | string\n  | number\n  | boolean\n  | readonly string[]\n  | undefined\n  | null;\n\nexport interface RequestOptions {\n  method?: \"GET\" | \"POST\" | undefined;\n  path: string;\n  query?: Record<string, QueryValue> | undefined;\n  headers?: HeadersInit | undefined;\n  body?: BodyInit | null | undefined;\n  format?: ResponseFormat | undefined;\n}\n\nexport interface RequestContext {\n  baseUrl: string;\n  config: OpenSERPConfig;\n  setLastResponse(response: LastResponse): void;\n}\n\nexport async function request<T>(\n  context: RequestContext,\n  options: RequestOptions,\n): Promise<T> {\n  let attempt = 0;\n\n  for (;;) {\n    try {\n      return await requestOnce<T>(context, options);\n    } catch (err) {\n      const shouldRetry = await context.config.retry?.(err, attempt);\n      if (!shouldRetry) {\n        throw err;\n      }\n      attempt += 1;\n    }\n  }\n}\n\nasync function requestOnce<T>(\n  { baseUrl, config, setLastResponse }: RequestContext,\n  options: RequestOptions,\n): Promise<T> {\n  const fetchImpl = config.fetch ?? globalThis.fetch;\n  if (!fetchImpl) {\n    throw new TypeError(\"OpenSERP SDK requires a fetch implementation.\");\n  }\n\n  const url = new URL(`${baseUrl}${options.path}`);\n  appendQuery(url, options.query);\n\n  const headers = new Headers(config.headers);\n  if (config.apiKey) {\n    headers.set(\"Authorization\", `Bearer ${config.apiKey}`);\n  }\n  for (const [key, value] of new Headers(options.headers)) {\n    headers.set(key, value);\n  }\n\n  const timeoutMs = config.timeoutMs ?? 30_000;\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n\n  let response: Response;\n  try {\n    const init: RequestInit = {\n      method: options.method ?? \"GET\",\n      headers,\n      signal: controller.signal,\n    };\n    if (options.body !== undefined) {\n      init.body = options.body;\n    }\n\n    response = await fetchImpl(url, init);\n  } catch (err) {\n    if (isAbortError(err)) {\n      throw new TimeoutError(timeoutMs, err);\n    }\n    throw err;\n  } finally {\n    clearTimeout(timer);\n  }\n\n  setLastResponse(readLastResponse(response));\n\n  const body = await readBody(response, options.format);\n  if (!response.ok) {\n    throw errorFromResponse(response.status, body, response.headers.get(\"x-request-id\") ?? undefined);\n  }\n\n  return body as T;\n}\n\nfunction appendQuery(url: URL, query: Record<string, QueryValue> | undefined): void {\n  if (!query) {\n    return;\n  }\n\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined || value === null) {\n      continue;\n    }\n    const encoded = Array.isArray(value) ? value.join(\",\") : String(value);\n    url.searchParams.set(key, encoded);\n  }\n}\n\nasync function readBody(response: Response, format?: ResponseFormat): Promise<unknown> {\n  if (response.status === 204) {\n    return undefined;\n  }\n\n  if (format && format !== \"json\") {\n    return response.text();\n  }\n\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n  if (contentType.includes(\"application/json\")) {\n    return response.json();\n  }\n\n  const text = await response.text();\n  if (!text) {\n    return undefined;\n  }\n\n  try {\n    return JSON.parse(text);\n  } catch {\n    return text;\n  }\n}\n\nfunction readLastResponse(response: Response): LastResponse {\n  const credits = {\n    used: numberHeader(response.headers, \"x-credits-used\"),\n    remaining: numberHeader(response.headers, \"x-credits-remaining\"),\n  };\n  const hasCredits = credits.used !== undefined || credits.remaining !== undefined;\n\n  return {\n    status: response.status,\n    requestId: response.headers.get(\"x-request-id\") ?? undefined,\n    credits: hasCredits ? credits : undefined,\n    engineUsed: response.headers.get(\"x-engine-used\") ?? undefined,\n    fallbackEngine: response.headers.get(\"x-fallback-engine\") ?? undefined,\n    cache: response.headers.get(\"x-cache\") ?? undefined,\n    proxyMode: response.headers.get(\"x-proxy-mode\") ?? undefined,\n    proxyTag: response.headers.get(\"x-proxy-tag\") ?? undefined,\n    proxyUsed: response.headers.get(\"x-proxy-used\") ?? undefined,\n    networkBytes: numberHeader(response.headers, \"x-network-bytes\"),\n    browserProfileId: response.headers.get(\"x-browser-profile-id\") ?? undefined,\n    headers: response.headers,\n  };\n}\n\nfunction numberHeader(headers: Headers, name: string): number | undefined {\n  const value = headers.get(name);\n  if (value === null || value === \"\") {\n    return undefined;\n  }\n  const parsed = Number(value);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction isAbortError(err: unknown): boolean {\n  return err instanceof DOMException && err.name === \"AbortError\";\n}\n","import { inferBackend, resolveBaseUrl } from \"./backend\";\nimport { CloudOnlyError, OssOnlyError } from \"./errors\";\nimport { request, type QueryValue } from \"./request\";\nimport type {\n  CacheStats,\n  CircuitBreakerStatsResponse,\n  HealthStatus,\n  ImageEnvelope,\n  ImageParams,\n  LastResponse,\n  MegaEnginesResponse,\n  MegaImageParams,\n  MegaSearchEnvelope,\n  MegaSearchParams,\n  OpenSERPConfig,\n  ParseParams,\n  ReadinessStatus,\n  SearchEnvelope,\n  SearchParams,\n  StatsResponse,\n  ProxyStats,\n} from \"./types/public\";\nimport type {\n  CloudAccount,\n  EnginesCapabilities,\n  EnginesStatus,\n  Pricing,\n} from \"./types/cloud\";\n\nexport class OpenSERP {\n  readonly config: OpenSERPConfig;\n  lastResponse?: LastResponse;\n\n  constructor(config: OpenSERPConfig = {}) {\n    this.config = { ...config };\n  }\n\n  get backend() {\n    return inferBackend(this.config);\n  }\n\n  get baseUrl() {\n    return resolveBaseUrl(this.config);\n  }\n\n  search(params: SearchParams): Promise<SearchEnvelope | string> {\n    const { engine, format, ...query } = params;\n    return this.get<SearchEnvelope | string>(`/${engine}/search`, query, format);\n  }\n\n  image(params: ImageParams): Promise<ImageEnvelope | string> {\n    const { engine, format, ...query } = params;\n    return this.get<ImageEnvelope | string>(`/${engine}/image`, query, format);\n  }\n\n  megaSearch(params: MegaSearchParams): Promise<MegaSearchEnvelope | string> {\n    const { format, ...query } = params;\n    return this.get<MegaSearchEnvelope | string>(\"/mega/search\", query, format);\n  }\n\n  fastSearch(params: Omit<MegaSearchParams, \"mode\">): Promise<MegaSearchEnvelope | string> {\n    return this.megaSearch({ ...params, mode: \"fast\" });\n  }\n\n  anySearch(params: Omit<MegaSearchParams, \"mode\">): Promise<MegaSearchEnvelope | string> {\n    return this.megaSearch({ ...params, mode: \"any\" });\n  }\n\n  megaImage(params: MegaImageParams): Promise<ImageEnvelope | string> {\n    const { format, ...query } = params;\n    return this.get<ImageEnvelope | string>(\"/mega/image\", query, format);\n  }\n\n  fastImage(params: Omit<MegaImageParams, \"mode\">): Promise<ImageEnvelope | string> {\n    return this.megaImage({ ...params, mode: \"fast\" });\n  }\n\n  anyImage(params: Omit<MegaImageParams, \"mode\">): Promise<ImageEnvelope | string> {\n    return this.megaImage({ ...params, mode: \"any\" });\n  }\n\n  parseGoogle(params: ParseParams): Promise<SearchEnvelope | string> {\n    this.assertOss(\"parseGoogle\");\n    return this.parse(\"/google/parse\", params);\n  }\n\n  parseBing(params: ParseParams): Promise<SearchEnvelope | string> {\n    this.assertOss(\"parseBing\");\n    return this.parse(\"/bing/parse\", params);\n  }\n\n  health(): Promise<HealthStatus> {\n    this.assertOss(\"health\");\n    return this.get<HealthStatus>(\"/health\");\n  }\n\n  ready(): Promise<ReadinessStatus> {\n    this.assertOss(\"ready\");\n    return this.get<ReadinessStatus>(\"/ready\");\n  }\n\n  stats(): Promise<StatsResponse> {\n    this.assertOss(\"stats\");\n    return this.get<StatsResponse>(\"/stats\");\n  }\n\n  cacheStats(): Promise<CacheStats> {\n    this.assertOss(\"cacheStats\");\n    return this.get<CacheStats>(\"/stats/cache\");\n  }\n\n  proxyStats(): Promise<ProxyStats> {\n    this.assertOss(\"proxyStats\");\n    return this.get<ProxyStats>(\"/stats/proxy\");\n  }\n\n  circuitBreakerStats(): Promise<CircuitBreakerStatsResponse> {\n    this.assertOss(\"circuitBreakerStats\");\n    return this.get<CircuitBreakerStatsResponse>(\"/stats/cb\");\n  }\n\n  engines(): Promise<MegaEnginesResponse> {\n    this.assertOss(\"engines\");\n    return this.get<MegaEnginesResponse>(\"/mega/engines\");\n  }\n\n  me(): Promise<CloudAccount> {\n    this.assertCloud(\"me\");\n    return this.get<CloudAccount>(\"/me\");\n  }\n\n  pricing(): Promise<Pricing> {\n    this.assertCloud(\"pricing\");\n    return this.get<Pricing>(\"/pricing\");\n  }\n\n  enginesStatus(): Promise<EnginesStatus> {\n    this.assertCloud(\"enginesStatus\");\n    return this.get<EnginesStatus>(\"/engines/status\");\n  }\n\n  enginesCapabilities(): Promise<EnginesCapabilities> {\n    this.assertCloud(\"enginesCapabilities\");\n    return this.get<EnginesCapabilities>(\"/engines/capabilities\");\n  }\n\n  private parse(path: string, params: ParseParams): Promise<SearchEnvelope | string> {\n    return request<SearchEnvelope | string>(this.requestContext(), {\n      method: \"POST\",\n      path,\n      query: params.format ? { format: params.format } : undefined,\n      headers: {\n        \"Content-Type\": \"text/html; charset=utf-8\",\n      },\n      body: params.html,\n      format: params.format,\n    });\n  }\n\n  private get<T>(\n    path: string,\n    query?: Record<string, QueryValue>,\n    format?: SearchParams[\"format\"],\n  ): Promise<T> {\n    const { query: cleanQuery, headers } = splitQueryAndHeaders({\n      ...query,\n      format,\n    });\n\n    return request<T>(this.requestContext(), {\n      path,\n      query: cleanQuery,\n      headers,\n      format,\n    });\n  }\n\n  private requestContext() {\n    return {\n      baseUrl: this.baseUrl,\n      config: this.config,\n      setLastResponse: (response: LastResponse) => {\n        this.lastResponse = response;\n      },\n    };\n  }\n\n  private assertCloud(method: string): void {\n    if (this.backend !== \"cloud\") {\n      throw new CloudOnlyError(method);\n    }\n  }\n\n  private assertOss(method: string): void {\n    if (this.backend !== \"oss\") {\n      throw new OssOnlyError(method);\n    }\n  }\n}\n\nfunction splitQueryAndHeaders(query: Record<string, QueryValue>): {\n  query: Record<string, QueryValue>;\n  headers: HeadersInit;\n} {\n  const {\n    useProxy,\n    proxyUrl,\n    proxyCountry,\n    proxyClass,\n    proxyProvider,\n    proxySessionId,\n    tenant,\n    ...cleanQuery\n  } = query;\n  const headers: Record<string, string> = {};\n\n  addHeader(headers, \"X-Use-Proxy\", useProxy);\n  addHeader(headers, \"X-Proxy-URL\", proxyUrl);\n  addHeader(headers, \"X-Proxy-Country\", proxyCountry);\n  addHeader(headers, \"X-Proxy-Class\", proxyClass);\n  addHeader(headers, \"X-Proxy-Provider\", proxyProvider);\n  addHeader(headers, \"X-Proxy-Session-ID\", proxySessionId);\n  addHeader(headers, \"X-Tenant\", tenant);\n\n  return { query: cleanQuery, headers };\n}\n\nfunction addHeader(headers: Record<string, string>, name: string, value: QueryValue): void {\n  if (value === undefined || value === null) {\n    return;\n  }\n  headers[name] = Array.isArray(value) ? value.join(\",\") : String(value);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/backend.ts","../src/errors.ts","../src/debug.ts","../src/request.ts","../src/client.ts"],"sourcesContent":["export { OpenSERP } from \"./client\";\nexport {\n  CLOUD_BASE_URL,\n  OSS_BASE_URL,\n  inferBackend,\n  normalizeBaseUrl,\n  resolveBaseUrl,\n} from \"./backend\";\nexport {\n  CaptchaError,\n  CloudOnlyError,\n  OssOnlyError,\n  RateLimitError,\n  SERPError,\n  TimeoutError,\n} from \"./errors\";\nexport type {\n  Backend,\n  CacheStats,\n  CircuitBreakerStatsResponse,\n  DebugEvent,\n  Engine,\n  ErrorResponse,\n  HealthStatus,\n  ImageEnvelope,\n  ImageParams,\n  LastResponse,\n  MegaEnginesResponse,\n  MegaImageParams,\n  MegaMode,\n  MegaSearchEnvelope,\n  MegaSearchParams,\n  OpenSERPConfig,\n  ParseParams,\n  ProxyStats,\n  ReadinessStatus,\n  ResponseFormat,\n  SearchEnvelope,\n  SearchParams,\n  StatsResponse,\n} from \"./types/public\";\nexport type {\n  CloudAccount,\n  CreditInfo,\n  EngineCapability,\n  EngineStatus,\n  EnginesCapabilities,\n  EnginesStatus,\n  ModeCapability,\n  OverallStatus,\n  Price,\n  Pricing,\n} from \"./types/cloud\";\n","import type { Backend, OpenSERPConfig } from \"./types/public\";\n\nexport const OSS_BASE_URL = \"http://localhost:7000\";\nexport const CLOUD_BASE_URL = \"https://api.openserp.org/v1\";\n\nexport function normalizeBaseUrl(baseUrl: string): string {\n  return baseUrl.replace(/\\/+$/, \"\");\n}\n\nexport function resolveBaseUrl(config: OpenSERPConfig): string {\n  if (config.baseUrl) {\n    return normalizeBaseUrl(config.baseUrl);\n  }\n\n  if (config.apiKey) {\n    return CLOUD_BASE_URL;\n  }\n\n  return OSS_BASE_URL;\n}\n\nexport function inferBackend(config: Pick<OpenSERPConfig, \"apiKey\" | \"baseUrl\" | \"backend\">): Backend {\n  if (config.backend) {\n    return config.backend;\n  }\n\n  if (config.baseUrl) {\n    try {\n      if (new URL(config.baseUrl).hostname === \"api.openserp.org\") {\n        return \"cloud\";\n      }\n    } catch {\n      if (config.baseUrl.includes(\"api.openserp.org\")) {\n        return \"cloud\";\n      }\n    }\n  }\n\n  if (config.apiKey) {\n    return \"cloud\";\n  }\n\n  return \"oss\";\n}\n","import type { ErrorResponse } from \"./types/public\";\n\nexport class SERPError extends Error {\n  readonly status: number;\n  readonly code?: string | undefined;\n  readonly reason?: string | undefined;\n  readonly requestId?: string | undefined;\n  readonly meta?: Record<string, unknown> | undefined;\n  readonly response?: ErrorResponse | unknown | undefined;\n\n  constructor(message: string, options: {\n    status?: number | undefined;\n    code?: string | undefined;\n    reason?: string | undefined;\n    requestId?: string | undefined;\n    meta?: Record<string, unknown> | undefined;\n    response?: ErrorResponse | unknown | undefined;\n    cause?: unknown | undefined;\n  } = {}) {\n    super(message, { cause: options.cause });\n    this.name = \"SERPError\";\n    this.status = options.status ?? 0;\n    this.code = options.code;\n    this.reason = options.reason;\n    this.requestId = options.requestId;\n    this.meta = options.meta;\n    this.response = options.response;\n  }\n}\n\nexport class RateLimitError extends SERPError {\n  constructor(message: string, options: ConstructorParameters<typeof SERPError>[1] = {}) {\n    super(message, options);\n    this.name = \"RateLimitError\";\n  }\n}\n\nexport class CaptchaError extends SERPError {\n  constructor(message: string, options: ConstructorParameters<typeof SERPError>[1] = {}) {\n    super(message, options);\n    this.name = \"CaptchaError\";\n  }\n}\n\nexport class CloudOnlyError extends SERPError {\n  constructor(method: string) {\n    super(`${method} is only available against OpenSERP Cloud. Configure apiKey/baseUrl for https://api.openserp.org/v1 or set client.config.backend = \"cloud\".`);\n    this.name = \"CloudOnlyError\";\n  }\n}\n\nexport class OssOnlyError extends SERPError {\n  constructor(method: string) {\n    super(`${method} is only available against a self-hosted OpenSERP server. Configure baseUrl for your OSS server or set client.config.backend = \"oss\".`);\n    this.name = \"OssOnlyError\";\n  }\n}\n\nexport class TimeoutError extends SERPError {\n  constructor(timeoutMs: number, cause?: unknown) {\n    super(`OpenSERP request timed out after ${timeoutMs}ms`, {\n      code: \"request_timeout\",\n      cause,\n    });\n    this.name = \"TimeoutError\";\n  }\n}\n\nexport function errorFromResponse(status: number, body: unknown, requestId?: string): SERPError {\n  const data = isErrorResponse(body) ? body : undefined;\n  const code = data?.error;\n  const message = data?.message ?? `OpenSERP request failed with status ${status}`;\n  const options = {\n    status,\n    code,\n    reason: data?.reason,\n    requestId: data?.request_id ?? requestId,\n    meta: data?.meta as Record<string, unknown> | undefined,\n    response: body,\n  };\n\n  if (status === 429 || code === \"rate_limited\") {\n    return new RateLimitError(message, options);\n  }\n\n  if (code === \"captcha_detected\") {\n    return new CaptchaError(message, options);\n  }\n\n  return new SERPError(message, options);\n}\n\nfunction isErrorResponse(body: unknown): body is ErrorResponse {\n  return typeof body === \"object\" && body !== null && \"error\" in body;\n}\n","import type { DebugEvent, OpenSERPConfig } from \"./types/public\";\n\nexport type DebugLevel = \"off\" | \"info\" | \"verbose\";\n\ntype DebugSink = (event: DebugEvent) => void;\n\n/** Resolved debug configuration: the active level and where events go. */\nexport interface DebugReporter {\n  level: DebugLevel;\n  emit(event: DebugEvent): void;\n}\n\nconst NO_OP: DebugReporter = {\n  level: \"off\",\n  emit() {},\n};\n\n/**\n * Resolves the effective debug behaviour from config (falling back to the\n * OPENSERP_DEBUG env var). Returns a no-op reporter when debugging is off so\n * callers can emit unconditionally without a hot-path branch of their own.\n */\nexport function resolveDebug(config: OpenSERPConfig): DebugReporter {\n  const setting = config.debug ?? envDebug();\n\n  if (!setting) {\n    return NO_OP;\n  }\n\n  if (typeof setting === \"function\") {\n    // A custom sink always sees verbose detail; it decides what to keep.\n    return { level: \"verbose\", emit: guard(setting) };\n  }\n\n  const level: DebugLevel = setting === \"verbose\" ? \"verbose\" : \"info\";\n  return { level, emit: consoleSink };\n}\n\nfunction envDebug(): boolean | \"verbose\" | undefined {\n  // Guarded so the SDK still works in browsers / runtimes without `process`.\n  const value =\n    typeof process !== \"undefined\" ? process.env?.OPENSERP_DEBUG : undefined;\n  if (!value) {\n    return undefined;\n  }\n  const normalized = value.trim().toLowerCase();\n  if (normalized === \"verbose\") {\n    return \"verbose\";\n  }\n  if (normalized === \"1\" || normalized === \"true\") {\n    return true;\n  }\n  return undefined;\n}\n\n/** Wraps a user-provided sink so a thrown logger never breaks a request. */\nfunction guard(sink: DebugSink): DebugSink {\n  return (event) => {\n    try {\n      sink(event);\n    } catch {\n      // A broken debug logger must not take down the actual request.\n    }\n  };\n}\n\nconst consoleSink: DebugSink = (event) => {\n  switch (event.type) {\n    case \"request\":\n      console.error(`[openserp] → ${event.method} ${event.url}`);\n      if (event.headers) {\n        console.error(\"[openserp]   headers:\", event.headers);\n      }\n      break;\n    case \"response\": {\n      const engine = event.engineUsed ? ` engine=${event.engineUsed}` : \"\";\n      const reqId = event.requestId ? ` request-id=${event.requestId}` : \"\";\n      console.error(\n        `[openserp] ← ${event.status} ${event.method} ${event.url} (${event.durationMs}ms)${engine}${reqId}`,\n      );\n      if (event.headers) {\n        console.error(\"[openserp]   headers:\", event.headers);\n      }\n      break;\n    }\n    case \"error\":\n      console.error(\n        `[openserp] ✕ ${event.method} ${event.url} (${event.durationMs}ms):`,\n        event.error,\n      );\n      break;\n  }\n};\n\n/** Snapshots headers into a plain object, redacting Authorization. */\nexport function dumpHeaders(headers: Headers): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const [key, value] of headers) {\n    out[key] = key.toLowerCase() === \"authorization\" ? \"Bearer ***\" : value;\n  }\n  return out;\n}\n","import { dumpHeaders, resolveDebug } from \"./debug\";\nimport { TimeoutError, errorFromResponse } from \"./errors\";\nimport type { LastResponse, OpenSERPConfig, ResponseFormat } from \"./types/public\";\n\nexport type QueryValue =\n  | string\n  | number\n  | boolean\n  | readonly string[]\n  | undefined\n  | null;\n\nexport interface RequestOptions {\n  method?: \"GET\" | \"POST\" | undefined;\n  path: string;\n  query?: Record<string, QueryValue> | undefined;\n  headers?: HeadersInit | undefined;\n  body?: BodyInit | null | undefined;\n  format?: ResponseFormat | undefined;\n}\n\nexport interface RequestContext {\n  baseUrl: string;\n  config: OpenSERPConfig;\n  setLastResponse(response: LastResponse): void;\n}\n\nexport async function request<T>(\n  context: RequestContext,\n  options: RequestOptions,\n): Promise<T> {\n  let attempt = 0;\n\n  for (;;) {\n    try {\n      return await requestOnce<T>(context, options);\n    } catch (err) {\n      const shouldRetry = await context.config.retry?.(err, attempt);\n      if (!shouldRetry) {\n        throw err;\n      }\n      attempt += 1;\n    }\n  }\n}\n\nasync function requestOnce<T>(\n  { baseUrl, config, setLastResponse }: RequestContext,\n  options: RequestOptions,\n): Promise<T> {\n  const fetchImpl = config.fetch ?? globalThis.fetch;\n  if (!fetchImpl) {\n    throw new TypeError(\"OpenSERP SDK requires a fetch implementation.\");\n  }\n\n  const url = new URL(`${baseUrl}${options.path}`);\n  appendQuery(url, options.query);\n\n  const headers = new Headers(config.headers);\n  if (config.apiKey) {\n    headers.set(\"Authorization\", `Bearer ${config.apiKey}`);\n  }\n  for (const [key, value] of new Headers(options.headers)) {\n    headers.set(key, value);\n  }\n\n  const debug = resolveDebug(config);\n  const method = options.method ?? \"GET\";\n  if (debug.level !== \"off\") {\n    debug.emit({\n      type: \"request\",\n      method,\n      url: url.toString(),\n      ...(debug.level === \"verbose\" ? { headers: dumpHeaders(headers) } : {}),\n    });\n  }\n\n  const timeoutMs = config.timeoutMs ?? 30_000;\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  const startedAt = Date.now();\n\n  let response: Response;\n  try {\n    const init: RequestInit = {\n      method,\n      headers,\n      signal: controller.signal,\n    };\n    if (options.body !== undefined) {\n      init.body = options.body;\n    }\n\n    response = await fetchImpl(url, init);\n  } catch (err) {\n    const error = isAbortError(err) ? new TimeoutError(timeoutMs, err) : err;\n    if (debug.level !== \"off\") {\n      debug.emit({\n        type: \"error\",\n        method,\n        url: url.toString(),\n        durationMs: Date.now() - startedAt,\n        error,\n      });\n    }\n    throw error;\n  } finally {\n    clearTimeout(timer);\n  }\n\n  const last = readLastResponse(response);\n  setLastResponse(last);\n  if (debug.level !== \"off\") {\n    debug.emit({\n      type: \"response\",\n      method,\n      url: url.toString(),\n      status: response.status,\n      engineUsed: last.engineUsed,\n      requestId: last.requestId,\n      durationMs: Date.now() - startedAt,\n      ...(debug.level === \"verbose\" ? { headers: dumpHeaders(response.headers) } : {}),\n    });\n  }\n\n  const body = await readBody(response, options.format);\n  if (!response.ok) {\n    throw errorFromResponse(response.status, body, response.headers.get(\"x-request-id\") ?? undefined);\n  }\n\n  return body as T;\n}\n\nfunction appendQuery(url: URL, query: Record<string, QueryValue> | undefined): void {\n  if (!query) {\n    return;\n  }\n\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined || value === null) {\n      continue;\n    }\n    const encoded = Array.isArray(value) ? value.join(\",\") : String(value);\n    url.searchParams.set(key, encoded);\n  }\n}\n\nasync function readBody(response: Response, format?: ResponseFormat): Promise<unknown> {\n  if (response.status === 204) {\n    return undefined;\n  }\n\n  if (format && format !== \"json\") {\n    return response.text();\n  }\n\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n  if (contentType.includes(\"application/json\")) {\n    return response.json();\n  }\n\n  const text = await response.text();\n  if (!text) {\n    return undefined;\n  }\n\n  try {\n    return JSON.parse(text);\n  } catch {\n    return text;\n  }\n}\n\nfunction readLastResponse(response: Response): LastResponse {\n  const credits = {\n    used: numberHeader(response.headers, \"x-credits-used\"),\n    remaining: numberHeader(response.headers, \"x-credits-remaining\"),\n  };\n  const hasCredits = credits.used !== undefined || credits.remaining !== undefined;\n\n  return {\n    status: response.status,\n    requestId: response.headers.get(\"x-request-id\") ?? undefined,\n    credits: hasCredits ? credits : undefined,\n    engineUsed: response.headers.get(\"x-engine-used\") ?? undefined,\n    fallbackEngine: response.headers.get(\"x-fallback-engine\") ?? undefined,\n    cache: response.headers.get(\"x-cache\") ?? undefined,\n    proxyMode: response.headers.get(\"x-proxy-mode\") ?? undefined,\n    proxyTag: response.headers.get(\"x-proxy-tag\") ?? undefined,\n    proxyUsed: response.headers.get(\"x-proxy-used\") ?? undefined,\n    networkBytes: numberHeader(response.headers, \"x-network-bytes\"),\n    browserProfileId: response.headers.get(\"x-browser-profile-id\") ?? undefined,\n    headers: response.headers,\n  };\n}\n\nfunction numberHeader(headers: Headers, name: string): number | undefined {\n  const value = headers.get(name);\n  if (value === null || value === \"\") {\n    return undefined;\n  }\n  const parsed = Number(value);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction isAbortError(err: unknown): boolean {\n  return err instanceof DOMException && err.name === \"AbortError\";\n}\n","import { inferBackend, resolveBaseUrl } from \"./backend\";\nimport { CloudOnlyError, OssOnlyError } from \"./errors\";\nimport { request, type QueryValue } from \"./request\";\nimport type {\n  CacheStats,\n  CircuitBreakerStatsResponse,\n  HealthStatus,\n  ImageEnvelope,\n  ImageParams,\n  LastResponse,\n  MegaEnginesResponse,\n  MegaImageParams,\n  MegaSearchEnvelope,\n  MegaSearchParams,\n  OpenSERPConfig,\n  ParseParams,\n  ReadinessStatus,\n  SearchEnvelope,\n  SearchParams,\n  StatsResponse,\n  ProxyStats,\n} from \"./types/public\";\nimport type {\n  CloudAccount,\n  EnginesCapabilities,\n  EnginesStatus,\n  Pricing,\n} from \"./types/cloud\";\n\nexport class OpenSERP {\n  readonly config: OpenSERPConfig;\n  lastResponse?: LastResponse;\n\n  constructor(config: OpenSERPConfig = {}) {\n    this.config = { ...config };\n  }\n\n  get backend() {\n    return inferBackend(this.config);\n  }\n\n  get baseUrl() {\n    return resolveBaseUrl(this.config);\n  }\n\n  search(params: SearchParams): Promise<SearchEnvelope | string> {\n    const { engine, format, ...query } = params;\n    return this.get<SearchEnvelope | string>(`/${engine}/search`, query, format);\n  }\n\n  image(params: ImageParams): Promise<ImageEnvelope | string> {\n    const { engine, format, ...query } = params;\n    return this.get<ImageEnvelope | string>(`/${engine}/image`, query, format);\n  }\n\n  megaSearch(params: MegaSearchParams): Promise<MegaSearchEnvelope | string> {\n    const { format, ...query } = params;\n    return this.get<MegaSearchEnvelope | string>(\"/mega/search\", query, format);\n  }\n\n  fastSearch(params: Omit<MegaSearchParams, \"mode\">): Promise<MegaSearchEnvelope | string> {\n    return this.megaSearch({ ...params, mode: \"fast\" });\n  }\n\n  anySearch(params: Omit<MegaSearchParams, \"mode\">): Promise<MegaSearchEnvelope | string> {\n    return this.megaSearch({ ...params, mode: \"any\" });\n  }\n\n  megaImage(params: MegaImageParams): Promise<ImageEnvelope | string> {\n    const { format, ...query } = params;\n    return this.get<ImageEnvelope | string>(\"/mega/image\", query, format);\n  }\n\n  fastImage(params: Omit<MegaImageParams, \"mode\">): Promise<ImageEnvelope | string> {\n    return this.megaImage({ ...params, mode: \"fast\" });\n  }\n\n  anyImage(params: Omit<MegaImageParams, \"mode\">): Promise<ImageEnvelope | string> {\n    return this.megaImage({ ...params, mode: \"any\" });\n  }\n\n  parseGoogle(params: ParseParams): Promise<SearchEnvelope | string> {\n    this.assertOss(\"parseGoogle\");\n    return this.parse(\"/google/parse\", params);\n  }\n\n  parseBing(params: ParseParams): Promise<SearchEnvelope | string> {\n    this.assertOss(\"parseBing\");\n    return this.parse(\"/bing/parse\", params);\n  }\n\n  health(): Promise<HealthStatus> {\n    this.assertOss(\"health\");\n    return this.get<HealthStatus>(\"/health\");\n  }\n\n  ready(): Promise<ReadinessStatus> {\n    this.assertOss(\"ready\");\n    return this.get<ReadinessStatus>(\"/ready\");\n  }\n\n  stats(): Promise<StatsResponse> {\n    this.assertOss(\"stats\");\n    return this.get<StatsResponse>(\"/stats\");\n  }\n\n  cacheStats(): Promise<CacheStats> {\n    this.assertOss(\"cacheStats\");\n    return this.get<CacheStats>(\"/stats/cache\");\n  }\n\n  proxyStats(): Promise<ProxyStats> {\n    this.assertOss(\"proxyStats\");\n    return this.get<ProxyStats>(\"/stats/proxy\");\n  }\n\n  circuitBreakerStats(): Promise<CircuitBreakerStatsResponse> {\n    this.assertOss(\"circuitBreakerStats\");\n    return this.get<CircuitBreakerStatsResponse>(\"/stats/cb\");\n  }\n\n  engines(): Promise<MegaEnginesResponse> {\n    this.assertOss(\"engines\");\n    return this.get<MegaEnginesResponse>(\"/mega/engines\");\n  }\n\n  me(): Promise<CloudAccount> {\n    this.assertCloud(\"me\");\n    return this.get<CloudAccount>(\"/me\");\n  }\n\n  pricing(): Promise<Pricing> {\n    this.assertCloud(\"pricing\");\n    return this.get<Pricing>(\"/pricing\");\n  }\n\n  enginesStatus(): Promise<EnginesStatus> {\n    this.assertCloud(\"enginesStatus\");\n    return this.get<EnginesStatus>(\"/engines/status\");\n  }\n\n  enginesCapabilities(): Promise<EnginesCapabilities> {\n    this.assertCloud(\"enginesCapabilities\");\n    return this.get<EnginesCapabilities>(\"/engines/capabilities\");\n  }\n\n  private parse(path: string, params: ParseParams): Promise<SearchEnvelope | string> {\n    return request<SearchEnvelope | string>(this.requestContext(), {\n      method: \"POST\",\n      path,\n      query: params.format ? { format: params.format } : undefined,\n      headers: {\n        \"Content-Type\": \"text/html; charset=utf-8\",\n      },\n      body: params.html,\n      format: params.format,\n    });\n  }\n\n  private get<T>(\n    path: string,\n    query?: Record<string, QueryValue>,\n    format?: SearchParams[\"format\"],\n  ): Promise<T> {\n    const { query: cleanQuery, headers } = splitQueryAndHeaders({\n      ...query,\n      format,\n    });\n\n    return request<T>(this.requestContext(), {\n      path,\n      query: cleanQuery,\n      headers,\n      format,\n    });\n  }\n\n  private requestContext() {\n    return {\n      baseUrl: this.baseUrl,\n      config: this.config,\n      setLastResponse: (response: LastResponse) => {\n        this.lastResponse = response;\n      },\n    };\n  }\n\n  private assertCloud(method: string): void {\n    if (this.backend !== \"cloud\") {\n      throw new CloudOnlyError(method);\n    }\n  }\n\n  private assertOss(method: string): void {\n    if (this.backend !== \"oss\") {\n      throw new OssOnlyError(method);\n    }\n  }\n}\n\nfunction splitQueryAndHeaders(query: Record<string, QueryValue>): {\n  query: Record<string, QueryValue>;\n  headers: HeadersInit;\n} {\n  const {\n    useProxy,\n    proxyUrl,\n    proxyCountry,\n    proxyClass,\n    proxyProvider,\n    proxySessionId,\n    tenant,\n    ...cleanQuery\n  } = query;\n  const headers: Record<string, string> = {};\n\n  addHeader(headers, \"X-Use-Proxy\", useProxy);\n  addHeader(headers, \"X-Proxy-URL\", proxyUrl);\n  addHeader(headers, \"X-Proxy-Country\", proxyCountry);\n  addHeader(headers, \"X-Proxy-Class\", proxyClass);\n  addHeader(headers, \"X-Proxy-Provider\", proxyProvider);\n  addHeader(headers, \"X-Proxy-Session-ID\", proxySessionId);\n  addHeader(headers, \"X-Tenant\", tenant);\n\n  return { query: cleanQuery, headers };\n}\n\nfunction addHeader(headers: Record<string, string>, name: string, value: QueryValue): void {\n  if (value === undefined || value === null) {\n    return;\n  }\n  headers[name] = Array.isArray(value) ? value.join(\",\") : String(value);\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -77,7 +77,44 @@ interface OpenSERPConfig {
     fetch?: typeof fetch | undefined;
     headers?: HeadersInit | undefined;
     retry?: ((err: unknown, attempt: number) => boolean | Promise<boolean>) | undefined;
-}
+    /**
+     * Logs each request and response to help debug what the SDK actually sends.
+     * - `true` / `"info"`: logs method, URL (with query string), and response
+     *   status / engine-used / request-id via `console.error`.
+     * - `"verbose"`: additionally logs request and response headers
+     *   (the `Authorization` header is redacted).
+     * - A function: receives a structured {@link DebugEvent} so you can route it
+     *   to your own logger instead of the console.
+     *
+     * Defaults to off. The `OPENSERP_DEBUG` env var (`1`/`true`/`verbose`) enables
+     * it when this option is left unset and `process` is available.
+     */
+    debug?: boolean | "info" | "verbose" | ((event: DebugEvent) => void) | undefined;
+}
+/** A single request/response lifecycle event emitted when debug is enabled. */
+type DebugEvent = {
+    type: "request";
+    method: string;
+    url: string;
+    /** Present only at "verbose" level. Authorization is redacted. */
+    headers?: Record<string, string>;
+} | {
+    type: "response";
+    method: string;
+    url: string;
+    status: number;
+    engineUsed?: string | undefined;
+    requestId?: string | undefined;
+    durationMs: number;
+    /** Present only at "verbose" level. */
+    headers?: Record<string, string>;
+} | {
+    type: "error";
+    method: string;
+    url: string;
+    durationMs: number;
+    error: unknown;
+};
 interface LastResponse {
     status: number;
     requestId?: string | undefined;
@@ -199,4 +236,4 @@ declare class TimeoutError extends SERPError {
     constructor(timeoutMs: number, cause?: unknown);
 }
 
-export { type Backend, CLOUD_BASE_URL, type CacheStats, CaptchaError, type CircuitBreakerStatsResponse, type CloudAccount, CloudOnlyError, type CreditInfo, type Engine, type EngineCapability, type EngineStatus, type EnginesCapabilities, type EnginesStatus, type ErrorResponse, type HealthStatus, type ImageEnvelope, type ImageParams, type LastResponse, type MegaEnginesResponse, type MegaImageParams, type MegaMode, type MegaSearchEnvelope, type MegaSearchParams, type ModeCapability, OSS_BASE_URL, OpenSERP, type OpenSERPConfig, OssOnlyError, type OverallStatus, type ParseParams, type Price, type Pricing, type ProxyStats, RateLimitError, type ReadinessStatus, type ResponseFormat, SERPError, type SearchEnvelope, type SearchParams, type StatsResponse, TimeoutError, inferBackend, normalizeBaseUrl, resolveBaseUrl };
+export { type Backend, CLOUD_BASE_URL, type CacheStats, CaptchaError, type CircuitBreakerStatsResponse, type CloudAccount, CloudOnlyError, type CreditInfo, type DebugEvent, type Engine, type EngineCapability, type EngineStatus, type EnginesCapabilities, type EnginesStatus, type ErrorResponse, type HealthStatus, type ImageEnvelope, type ImageParams, type LastResponse, type MegaEnginesResponse, type MegaImageParams, type MegaMode, type MegaSearchEnvelope, type MegaSearchParams, type ModeCapability, OSS_BASE_URL, OpenSERP, type OpenSERPConfig, OssOnlyError, type OverallStatus, type ParseParams, type Price, type Pricing, type ProxyStats, RateLimitError, type ReadinessStatus, type ResponseFormat, SERPError, type SearchEnvelope, type SearchParams, type StatsResponse, TimeoutError, inferBackend, normalizeBaseUrl, resolveBaseUrl };

package/dist/index.d.ts

@@ -77,7 +77,44 @@ interface OpenSERPConfig {
     fetch?: typeof fetch | undefined;
     headers?: HeadersInit | undefined;
     retry?: ((err: unknown, attempt: number) => boolean | Promise<boolean>) | undefined;
-}
+    /**
+     * Logs each request and response to help debug what the SDK actually sends.
+     * - `true` / `"info"`: logs method, URL (with query string), and response
+     *   status / engine-used / request-id via `console.error`.
+     * - `"verbose"`: additionally logs request and response headers
+     *   (the `Authorization` header is redacted).
+     * - A function: receives a structured {@link DebugEvent} so you can route it
+     *   to your own logger instead of the console.
+     *
+     * Defaults to off. The `OPENSERP_DEBUG` env var (`1`/`true`/`verbose`) enables
+     * it when this option is left unset and `process` is available.
+     */
+    debug?: boolean | "info" | "verbose" | ((event: DebugEvent) => void) | undefined;
+}
+/** A single request/response lifecycle event emitted when debug is enabled. */
+type DebugEvent = {
+    type: "request";
+    method: string;
+    url: string;
+    /** Present only at "verbose" level. Authorization is redacted. */
+    headers?: Record<string, string>;
+} | {
+    type: "response";
+    method: string;
+    url: string;
+    status: number;
+    engineUsed?: string | undefined;
+    requestId?: string | undefined;
+    durationMs: number;
+    /** Present only at "verbose" level. */
+    headers?: Record<string, string>;
+} | {
+    type: "error";
+    method: string;
+    url: string;
+    durationMs: number;
+    error: unknown;
+};
 interface LastResponse {
     status: number;
     requestId?: string | undefined;
@@ -199,4 +236,4 @@ declare class TimeoutError extends SERPError {
     constructor(timeoutMs: number, cause?: unknown);
 }
 
-export { type Backend, CLOUD_BASE_URL, type CacheStats, CaptchaError, type CircuitBreakerStatsResponse, type CloudAccount, CloudOnlyError, type CreditInfo, type Engine, type EngineCapability, type EngineStatus, type EnginesCapabilities, type EnginesStatus, type ErrorResponse, type HealthStatus, type ImageEnvelope, type ImageParams, type LastResponse, type MegaEnginesResponse, type MegaImageParams, type MegaMode, type MegaSearchEnvelope, type MegaSearchParams, type ModeCapability, OSS_BASE_URL, OpenSERP, type OpenSERPConfig, OssOnlyError, type OverallStatus, type ParseParams, type Price, type Pricing, type ProxyStats, RateLimitError, type ReadinessStatus, type ResponseFormat, SERPError, type SearchEnvelope, type SearchParams, type StatsResponse, TimeoutError, inferBackend, normalizeBaseUrl, resolveBaseUrl };
+export { type Backend, CLOUD_BASE_URL, type CacheStats, CaptchaError, type CircuitBreakerStatsResponse, type CloudAccount, CloudOnlyError, type CreditInfo, type DebugEvent, type Engine, type EngineCapability, type EngineStatus, type EnginesCapabilities, type EnginesStatus, type ErrorResponse, type HealthStatus, type ImageEnvelope, type ImageParams, type LastResponse, type MegaEnginesResponse, type MegaImageParams, type MegaMode, type MegaSearchEnvelope, type MegaSearchParams, type ModeCapability, OSS_BASE_URL, OpenSERP, type OpenSERPConfig, OssOnlyError, type OverallStatus, type ParseParams, type Price, type Pricing, type ProxyStats, RateLimitError, type ReadinessStatus, type ResponseFormat, SERPError, type SearchEnvelope, type SearchParams, type StatsResponse, TimeoutError, inferBackend, normalizeBaseUrl, resolveBaseUrl };

package/dist/index.js

@@ -110,6 +110,80 @@ function isErrorResponse(body) {
   return typeof body === "object" && body !== null && "error" in body;
 }
 
+// src/debug.ts
+var NO_OP = {
+  level: "off",
+  emit() {
+  }
+};
+function resolveDebug(config) {
+  const setting = config.debug ?? envDebug();
+  if (!setting) {
+    return NO_OP;
+  }
+  if (typeof setting === "function") {
+    return { level: "verbose", emit: guard(setting) };
+  }
+  const level = setting === "verbose" ? "verbose" : "info";
+  return { level, emit: consoleSink };
+}
+function envDebug() {
+  const value = typeof process !== "undefined" ? process.env?.OPENSERP_DEBUG : void 0;
+  if (!value) {
+    return void 0;
+  }
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "verbose") {
+    return "verbose";
+  }
+  if (normalized === "1" || normalized === "true") {
+    return true;
+  }
+  return void 0;
+}
+function guard(sink) {
+  return (event) => {
+    try {
+      sink(event);
+    } catch {
+    }
+  };
+}
+var consoleSink = (event) => {
+  switch (event.type) {
+    case "request":
+      console.error(`[openserp] \u2192 ${event.method} ${event.url}`);
+      if (event.headers) {
+        console.error("[openserp]   headers:", event.headers);
+      }
+      break;
+    case "response": {
+      const engine = event.engineUsed ? ` engine=${event.engineUsed}` : "";
+      const reqId = event.requestId ? ` request-id=${event.requestId}` : "";
+      console.error(
+        `[openserp] \u2190 ${event.status} ${event.method} ${event.url} (${event.durationMs}ms)${engine}${reqId}`
+      );
+      if (event.headers) {
+        console.error("[openserp]   headers:", event.headers);
+      }
+      break;
+    }
+    case "error":
+      console.error(
+        `[openserp] \u2715 ${event.method} ${event.url} (${event.durationMs}ms):`,
+        event.error
+      );
+      break;
+  }
+};
+function dumpHeaders(headers) {
+  const out = {};
+  for (const [key, value] of headers) {
+    out[key] = key.toLowerCase() === "authorization" ? "Bearer ***" : value;
+  }
+  return out;
+}
+
 // src/request.ts
 async function request(context, options) {
   let attempt = 0;
@@ -139,13 +213,24 @@ async function requestOnce({ baseUrl, config, setLastResponse }, options) {
   for (const [key, value] of new Headers(options.headers)) {
     headers.set(key, value);
   }
+  const debug = resolveDebug(config);
+  const method = options.method ?? "GET";
+  if (debug.level !== "off") {
+    debug.emit({
+      type: "request",
+      method,
+      url: url.toString(),
+      ...debug.level === "verbose" ? { headers: dumpHeaders(headers) } : {}
+    });
+  }
   const timeoutMs = config.timeoutMs ?? 3e4;
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeoutMs);
+  const startedAt = Date.now();
   let response;
   try {
     const init = {
-      method: options.method ?? "GET",
+      method,
       headers,
       signal: controller.signal
     };
@@ -154,14 +239,34 @@ async function requestOnce({ baseUrl, config, setLastResponse }, options) {
     }
     response = await fetchImpl(url, init);
   } catch (err) {
-    if (isAbortError(err)) {
-      throw new TimeoutError(timeoutMs, err);
+    const error = isAbortError(err) ? new TimeoutError(timeoutMs, err) : err;
+    if (debug.level !== "off") {
+      debug.emit({
+        type: "error",
+        method,
+        url: url.toString(),
+        durationMs: Date.now() - startedAt,
+        error
+      });
     }
-    throw err;
+    throw error;
   } finally {
     clearTimeout(timer);
   }
-  setLastResponse(readLastResponse(response));
+  const last = readLastResponse(response);
+  setLastResponse(last);
+  if (debug.level !== "off") {
+    debug.emit({
+      type: "response",
+      method,
+      url: url.toString(),
+      status: response.status,
+      engineUsed: last.engineUsed,
+      requestId: last.requestId,
+      durationMs: Date.now() - startedAt,
+      ...debug.level === "verbose" ? { headers: dumpHeaders(response.headers) } : {}
+    });
+  }
   const body = await readBody(response, options.format);
   if (!response.ok) {
     throw errorFromResponse(response.status, body, response.headers.get("x-request-id") ?? void 0);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/backend.ts","../src/errors.ts","../src/request.ts","../src/client.ts"],"sourcesContent":["import type { Backend, OpenSERPConfig } from \"./types/public\";\n\nexport const OSS_BASE_URL = \"http://localhost:7000\";\nexport const CLOUD_BASE_URL = \"https://api.openserp.org/v1\";\n\nexport function normalizeBaseUrl(baseUrl: string): string {\n  return baseUrl.replace(/\\/+$/, \"\");\n}\n\nexport function resolveBaseUrl(config: OpenSERPConfig): string {\n  if (config.baseUrl) {\n    return normalizeBaseUrl(config.baseUrl);\n  }\n\n  if (config.apiKey) {\n    return CLOUD_BASE_URL;\n  }\n\n  return OSS_BASE_URL;\n}\n\nexport function inferBackend(config: Pick<OpenSERPConfig, \"apiKey\" | \"baseUrl\" | \"backend\">): Backend {\n  if (config.backend) {\n    return config.backend;\n  }\n\n  if (config.baseUrl) {\n    try {\n      if (new URL(config.baseUrl).hostname === \"api.openserp.org\") {\n        return \"cloud\";\n      }\n    } catch {\n      if (config.baseUrl.includes(\"api.openserp.org\")) {\n        return \"cloud\";\n      }\n    }\n  }\n\n  if (config.apiKey) {\n    return \"cloud\";\n  }\n\n  return \"oss\";\n}\n","import type { ErrorResponse } from \"./types/public\";\n\nexport class SERPError extends Error {\n  readonly status: number;\n  readonly code?: string | undefined;\n  readonly reason?: string | undefined;\n  readonly requestId?: string | undefined;\n  readonly meta?: Record<string, unknown> | undefined;\n  readonly response?: ErrorResponse | unknown | undefined;\n\n  constructor(message: string, options: {\n    status?: number | undefined;\n    code?: string | undefined;\n    reason?: string | undefined;\n    requestId?: string | undefined;\n    meta?: Record<string, unknown> | undefined;\n    response?: ErrorResponse | unknown | undefined;\n    cause?: unknown | undefined;\n  } = {}) {\n    super(message, { cause: options.cause });\n    this.name = \"SERPError\";\n    this.status = options.status ?? 0;\n    this.code = options.code;\n    this.reason = options.reason;\n    this.requestId = options.requestId;\n    this.meta = options.meta;\n    this.response = options.response;\n  }\n}\n\nexport class RateLimitError extends SERPError {\n  constructor(message: string, options: ConstructorParameters<typeof SERPError>[1] = {}) {\n    super(message, options);\n    this.name = \"RateLimitError\";\n  }\n}\n\nexport class CaptchaError extends SERPError {\n  constructor(message: string, options: ConstructorParameters<typeof SERPError>[1] = {}) {\n    super(message, options);\n    this.name = \"CaptchaError\";\n  }\n}\n\nexport class CloudOnlyError extends SERPError {\n  constructor(method: string) {\n    super(`${method} is only available against OpenSERP Cloud. Configure apiKey/baseUrl for https://api.openserp.org/v1 or set client.config.backend = \"cloud\".`);\n    this.name = \"CloudOnlyError\";\n  }\n}\n\nexport class OssOnlyError extends SERPError {\n  constructor(method: string) {\n    super(`${method} is only available against a self-hosted OpenSERP server. Configure baseUrl for your OSS server or set client.config.backend = \"oss\".`);\n    this.name = \"OssOnlyError\";\n  }\n}\n\nexport class TimeoutError extends SERPError {\n  constructor(timeoutMs: number, cause?: unknown) {\n    super(`OpenSERP request timed out after ${timeoutMs}ms`, {\n      code: \"request_timeout\",\n      cause,\n    });\n    this.name = \"TimeoutError\";\n  }\n}\n\nexport function errorFromResponse(status: number, body: unknown, requestId?: string): SERPError {\n  const data = isErrorResponse(body) ? body : undefined;\n  const code = data?.error;\n  const message = data?.message ?? `OpenSERP request failed with status ${status}`;\n  const options = {\n    status,\n    code,\n    reason: data?.reason,\n    requestId: data?.request_id ?? requestId,\n    meta: data?.meta as Record<string, unknown> | undefined,\n    response: body,\n  };\n\n  if (status === 429 || code === \"rate_limited\") {\n    return new RateLimitError(message, options);\n  }\n\n  if (code === \"captcha_detected\") {\n    return new CaptchaError(message, options);\n  }\n\n  return new SERPError(message, options);\n}\n\nfunction isErrorResponse(body: unknown): body is ErrorResponse {\n  return typeof body === \"object\" && body !== null && \"error\" in body;\n}\n","import { TimeoutError, errorFromResponse } from \"./errors\";\nimport type { LastResponse, OpenSERPConfig, ResponseFormat } from \"./types/public\";\n\nexport type QueryValue =\n  | string\n  | number\n  | boolean\n  | readonly string[]\n  | undefined\n  | null;\n\nexport interface RequestOptions {\n  method?: \"GET\" | \"POST\" | undefined;\n  path: string;\n  query?: Record<string, QueryValue> | undefined;\n  headers?: HeadersInit | undefined;\n  body?: BodyInit | null | undefined;\n  format?: ResponseFormat | undefined;\n}\n\nexport interface RequestContext {\n  baseUrl: string;\n  config: OpenSERPConfig;\n  setLastResponse(response: LastResponse): void;\n}\n\nexport async function request<T>(\n  context: RequestContext,\n  options: RequestOptions,\n): Promise<T> {\n  let attempt = 0;\n\n  for (;;) {\n    try {\n      return await requestOnce<T>(context, options);\n    } catch (err) {\n      const shouldRetry = await context.config.retry?.(err, attempt);\n      if (!shouldRetry) {\n        throw err;\n      }\n      attempt += 1;\n    }\n  }\n}\n\nasync function requestOnce<T>(\n  { baseUrl, config, setLastResponse }: RequestContext,\n  options: RequestOptions,\n): Promise<T> {\n  const fetchImpl = config.fetch ?? globalThis.fetch;\n  if (!fetchImpl) {\n    throw new TypeError(\"OpenSERP SDK requires a fetch implementation.\");\n  }\n\n  const url = new URL(`${baseUrl}${options.path}`);\n  appendQuery(url, options.query);\n\n  const headers = new Headers(config.headers);\n  if (config.apiKey) {\n    headers.set(\"Authorization\", `Bearer ${config.apiKey}`);\n  }\n  for (const [key, value] of new Headers(options.headers)) {\n    headers.set(key, value);\n  }\n\n  const timeoutMs = config.timeoutMs ?? 30_000;\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n\n  let response: Response;\n  try {\n    const init: RequestInit = {\n      method: options.method ?? \"GET\",\n      headers,\n      signal: controller.signal,\n    };\n    if (options.body !== undefined) {\n      init.body = options.body;\n    }\n\n    response = await fetchImpl(url, init);\n  } catch (err) {\n    if (isAbortError(err)) {\n      throw new TimeoutError(timeoutMs, err);\n    }\n    throw err;\n  } finally {\n    clearTimeout(timer);\n  }\n\n  setLastResponse(readLastResponse(response));\n\n  const body = await readBody(response, options.format);\n  if (!response.ok) {\n    throw errorFromResponse(response.status, body, response.headers.get(\"x-request-id\") ?? undefined);\n  }\n\n  return body as T;\n}\n\nfunction appendQuery(url: URL, query: Record<string, QueryValue> | undefined): void {\n  if (!query) {\n    return;\n  }\n\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined || value === null) {\n      continue;\n    }\n    const encoded = Array.isArray(value) ? value.join(\",\") : String(value);\n    url.searchParams.set(key, encoded);\n  }\n}\n\nasync function readBody(response: Response, format?: ResponseFormat): Promise<unknown> {\n  if (response.status === 204) {\n    return undefined;\n  }\n\n  if (format && format !== \"json\") {\n    return response.text();\n  }\n\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n  if (contentType.includes(\"application/json\")) {\n    return response.json();\n  }\n\n  const text = await response.text();\n  if (!text) {\n    return undefined;\n  }\n\n  try {\n    return JSON.parse(text);\n  } catch {\n    return text;\n  }\n}\n\nfunction readLastResponse(response: Response): LastResponse {\n  const credits = {\n    used: numberHeader(response.headers, \"x-credits-used\"),\n    remaining: numberHeader(response.headers, \"x-credits-remaining\"),\n  };\n  const hasCredits = credits.used !== undefined || credits.remaining !== undefined;\n\n  return {\n    status: response.status,\n    requestId: response.headers.get(\"x-request-id\") ?? undefined,\n    credits: hasCredits ? credits : undefined,\n    engineUsed: response.headers.get(\"x-engine-used\") ?? undefined,\n    fallbackEngine: response.headers.get(\"x-fallback-engine\") ?? undefined,\n    cache: response.headers.get(\"x-cache\") ?? undefined,\n    proxyMode: response.headers.get(\"x-proxy-mode\") ?? undefined,\n    proxyTag: response.headers.get(\"x-proxy-tag\") ?? undefined,\n    proxyUsed: response.headers.get(\"x-proxy-used\") ?? undefined,\n    networkBytes: numberHeader(response.headers, \"x-network-bytes\"),\n    browserProfileId: response.headers.get(\"x-browser-profile-id\") ?? undefined,\n    headers: response.headers,\n  };\n}\n\nfunction numberHeader(headers: Headers, name: string): number | undefined {\n  const value = headers.get(name);\n  if (value === null || value === \"\") {\n    return undefined;\n  }\n  const parsed = Number(value);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction isAbortError(err: unknown): boolean {\n  return err instanceof DOMException && err.name === \"AbortError\";\n}\n","import { inferBackend, resolveBaseUrl } from \"./backend\";\nimport { CloudOnlyError, OssOnlyError } from \"./errors\";\nimport { request, type QueryValue } from \"./request\";\nimport type {\n  CacheStats,\n  CircuitBreakerStatsResponse,\n  HealthStatus,\n  ImageEnvelope,\n  ImageParams,\n  LastResponse,\n  MegaEnginesResponse,\n  MegaImageParams,\n  MegaSearchEnvelope,\n  MegaSearchParams,\n  OpenSERPConfig,\n  ParseParams,\n  ReadinessStatus,\n  SearchEnvelope,\n  SearchParams,\n  StatsResponse,\n  ProxyStats,\n} from \"./types/public\";\nimport type {\n  CloudAccount,\n  EnginesCapabilities,\n  EnginesStatus,\n  Pricing,\n} from \"./types/cloud\";\n\nexport class OpenSERP {\n  readonly config: OpenSERPConfig;\n  lastResponse?: LastResponse;\n\n  constructor(config: OpenSERPConfig = {}) {\n    this.config = { ...config };\n  }\n\n  get backend() {\n    return inferBackend(this.config);\n  }\n\n  get baseUrl() {\n    return resolveBaseUrl(this.config);\n  }\n\n  search(params: SearchParams): Promise<SearchEnvelope | string> {\n    const { engine, format, ...query } = params;\n    return this.get<SearchEnvelope | string>(`/${engine}/search`, query, format);\n  }\n\n  image(params: ImageParams): Promise<ImageEnvelope | string> {\n    const { engine, format, ...query } = params;\n    return this.get<ImageEnvelope | string>(`/${engine}/image`, query, format);\n  }\n\n  megaSearch(params: MegaSearchParams): Promise<MegaSearchEnvelope | string> {\n    const { format, ...query } = params;\n    return this.get<MegaSearchEnvelope | string>(\"/mega/search\", query, format);\n  }\n\n  fastSearch(params: Omit<MegaSearchParams, \"mode\">): Promise<MegaSearchEnvelope | string> {\n    return this.megaSearch({ ...params, mode: \"fast\" });\n  }\n\n  anySearch(params: Omit<MegaSearchParams, \"mode\">): Promise<MegaSearchEnvelope | string> {\n    return this.megaSearch({ ...params, mode: \"any\" });\n  }\n\n  megaImage(params: MegaImageParams): Promise<ImageEnvelope | string> {\n    const { format, ...query } = params;\n    return this.get<ImageEnvelope | string>(\"/mega/image\", query, format);\n  }\n\n  fastImage(params: Omit<MegaImageParams, \"mode\">): Promise<ImageEnvelope | string> {\n    return this.megaImage({ ...params, mode: \"fast\" });\n  }\n\n  anyImage(params: Omit<MegaImageParams, \"mode\">): Promise<ImageEnvelope | string> {\n    return this.megaImage({ ...params, mode: \"any\" });\n  }\n\n  parseGoogle(params: ParseParams): Promise<SearchEnvelope | string> {\n    this.assertOss(\"parseGoogle\");\n    return this.parse(\"/google/parse\", params);\n  }\n\n  parseBing(params: ParseParams): Promise<SearchEnvelope | string> {\n    this.assertOss(\"parseBing\");\n    return this.parse(\"/bing/parse\", params);\n  }\n\n  health(): Promise<HealthStatus> {\n    this.assertOss(\"health\");\n    return this.get<HealthStatus>(\"/health\");\n  }\n\n  ready(): Promise<ReadinessStatus> {\n    this.assertOss(\"ready\");\n    return this.get<ReadinessStatus>(\"/ready\");\n  }\n\n  stats(): Promise<StatsResponse> {\n    this.assertOss(\"stats\");\n    return this.get<StatsResponse>(\"/stats\");\n  }\n\n  cacheStats(): Promise<CacheStats> {\n    this.assertOss(\"cacheStats\");\n    return this.get<CacheStats>(\"/stats/cache\");\n  }\n\n  proxyStats(): Promise<ProxyStats> {\n    this.assertOss(\"proxyStats\");\n    return this.get<ProxyStats>(\"/stats/proxy\");\n  }\n\n  circuitBreakerStats(): Promise<CircuitBreakerStatsResponse> {\n    this.assertOss(\"circuitBreakerStats\");\n    return this.get<CircuitBreakerStatsResponse>(\"/stats/cb\");\n  }\n\n  engines(): Promise<MegaEnginesResponse> {\n    this.assertOss(\"engines\");\n    return this.get<MegaEnginesResponse>(\"/mega/engines\");\n  }\n\n  me(): Promise<CloudAccount> {\n    this.assertCloud(\"me\");\n    return this.get<CloudAccount>(\"/me\");\n  }\n\n  pricing(): Promise<Pricing> {\n    this.assertCloud(\"pricing\");\n    return this.get<Pricing>(\"/pricing\");\n  }\n\n  enginesStatus(): Promise<EnginesStatus> {\n    this.assertCloud(\"enginesStatus\");\n    return this.get<EnginesStatus>(\"/engines/status\");\n  }\n\n  enginesCapabilities(): Promise<EnginesCapabilities> {\n    this.assertCloud(\"enginesCapabilities\");\n    return this.get<EnginesCapabilities>(\"/engines/capabilities\");\n  }\n\n  private parse(path: string, params: ParseParams): Promise<SearchEnvelope | string> {\n    return request<SearchEnvelope | string>(this.requestContext(), {\n      method: \"POST\",\n      path,\n      query: params.format ? { format: params.format } : undefined,\n      headers: {\n        \"Content-Type\": \"text/html; charset=utf-8\",\n      },\n      body: params.html,\n      format: params.format,\n    });\n  }\n\n  private get<T>(\n    path: string,\n    query?: Record<string, QueryValue>,\n    format?: SearchParams[\"format\"],\n  ): Promise<T> {\n    const { query: cleanQuery, headers } = splitQueryAndHeaders({\n      ...query,\n      format,\n    });\n\n    return request<T>(this.requestContext(), {\n      path,\n      query: cleanQuery,\n      headers,\n      format,\n    });\n  }\n\n  private requestContext() {\n    return {\n      baseUrl: this.baseUrl,\n      config: this.config,\n      setLastResponse: (response: LastResponse) => {\n        this.lastResponse = response;\n      },\n    };\n  }\n\n  private assertCloud(method: string): void {\n    if (this.backend !== \"cloud\") {\n      throw new CloudOnlyError(method);\n    }\n  }\n\n  private assertOss(method: string): void {\n    if (this.backend !== \"oss\") {\n      throw new OssOnlyError(method);\n    }\n  }\n}\n\nfunction splitQueryAndHeaders(query: Record<string, QueryValue>): {\n  query: Record<string, QueryValue>;\n  headers: HeadersInit;\n} {\n  const {\n    useProxy,\n    proxyUrl,\n    proxyCountry,\n    proxyClass,\n    proxyProvider,\n    proxySessionId,\n    tenant,\n    ...cleanQuery\n  } = query;\n  const headers: Record<string, string> = {};\n\n  addHeader(headers, \"X-Use-Proxy\", useProxy);\n  addHeader(headers, \"X-Proxy-URL\", proxyUrl);\n  addHeader(headers, \"X-Proxy-Country\", proxyCountry);\n  addHeader(headers, \"X-Proxy-Class\", proxyClass);\n  addHeader(headers, \"X-Proxy-Provider\", proxyProvider);\n  addHeader(headers, \"X-Proxy-Session-ID\", proxySessionId);\n  addHeader(headers, \"X-Tenant\", tenant);\n\n  return { query: cleanQuery, headers };\n}\n\nfunction addHeader(headers: Record<string, string>, name: string, value: QueryValue): void {\n  if (value === undefined || value === null) {\n    return;\n  }\n  headers[name] = Array.isArray(value) ? value.join(\",\") : String(value);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/backend.ts","../src/errors.ts","../src/debug.ts","../src/request.ts","../src/client.ts"],"sourcesContent":["import type { Backend, OpenSERPConfig } from \"./types/public\";\n\nexport const OSS_BASE_URL = \"http://localhost:7000\";\nexport const CLOUD_BASE_URL = \"https://api.openserp.org/v1\";\n\nexport function normalizeBaseUrl(baseUrl: string): string {\n  return baseUrl.replace(/\\/+$/, \"\");\n}\n\nexport function resolveBaseUrl(config: OpenSERPConfig): string {\n  if (config.baseUrl) {\n    return normalizeBaseUrl(config.baseUrl);\n  }\n\n  if (config.apiKey) {\n    return CLOUD_BASE_URL;\n  }\n\n  return OSS_BASE_URL;\n}\n\nexport function inferBackend(config: Pick<OpenSERPConfig, \"apiKey\" | \"baseUrl\" | \"backend\">): Backend {\n  if (config.backend) {\n    return config.backend;\n  }\n\n  if (config.baseUrl) {\n    try {\n      if (new URL(config.baseUrl).hostname === \"api.openserp.org\") {\n        return \"cloud\";\n      }\n    } catch {\n      if (config.baseUrl.includes(\"api.openserp.org\")) {\n        return \"cloud\";\n      }\n    }\n  }\n\n  if (config.apiKey) {\n    return \"cloud\";\n  }\n\n  return \"oss\";\n}\n","import type { ErrorResponse } from \"./types/public\";\n\nexport class SERPError extends Error {\n  readonly status: number;\n  readonly code?: string | undefined;\n  readonly reason?: string | undefined;\n  readonly requestId?: string | undefined;\n  readonly meta?: Record<string, unknown> | undefined;\n  readonly response?: ErrorResponse | unknown | undefined;\n\n  constructor(message: string, options: {\n    status?: number | undefined;\n    code?: string | undefined;\n    reason?: string | undefined;\n    requestId?: string | undefined;\n    meta?: Record<string, unknown> | undefined;\n    response?: ErrorResponse | unknown | undefined;\n    cause?: unknown | undefined;\n  } = {}) {\n    super(message, { cause: options.cause });\n    this.name = \"SERPError\";\n    this.status = options.status ?? 0;\n    this.code = options.code;\n    this.reason = options.reason;\n    this.requestId = options.requestId;\n    this.meta = options.meta;\n    this.response = options.response;\n  }\n}\n\nexport class RateLimitError extends SERPError {\n  constructor(message: string, options: ConstructorParameters<typeof SERPError>[1] = {}) {\n    super(message, options);\n    this.name = \"RateLimitError\";\n  }\n}\n\nexport class CaptchaError extends SERPError {\n  constructor(message: string, options: ConstructorParameters<typeof SERPError>[1] = {}) {\n    super(message, options);\n    this.name = \"CaptchaError\";\n  }\n}\n\nexport class CloudOnlyError extends SERPError {\n  constructor(method: string) {\n    super(`${method} is only available against OpenSERP Cloud. Configure apiKey/baseUrl for https://api.openserp.org/v1 or set client.config.backend = \"cloud\".`);\n    this.name = \"CloudOnlyError\";\n  }\n}\n\nexport class OssOnlyError extends SERPError {\n  constructor(method: string) {\n    super(`${method} is only available against a self-hosted OpenSERP server. Configure baseUrl for your OSS server or set client.config.backend = \"oss\".`);\n    this.name = \"OssOnlyError\";\n  }\n}\n\nexport class TimeoutError extends SERPError {\n  constructor(timeoutMs: number, cause?: unknown) {\n    super(`OpenSERP request timed out after ${timeoutMs}ms`, {\n      code: \"request_timeout\",\n      cause,\n    });\n    this.name = \"TimeoutError\";\n  }\n}\n\nexport function errorFromResponse(status: number, body: unknown, requestId?: string): SERPError {\n  const data = isErrorResponse(body) ? body : undefined;\n  const code = data?.error;\n  const message = data?.message ?? `OpenSERP request failed with status ${status}`;\n  const options = {\n    status,\n    code,\n    reason: data?.reason,\n    requestId: data?.request_id ?? requestId,\n    meta: data?.meta as Record<string, unknown> | undefined,\n    response: body,\n  };\n\n  if (status === 429 || code === \"rate_limited\") {\n    return new RateLimitError(message, options);\n  }\n\n  if (code === \"captcha_detected\") {\n    return new CaptchaError(message, options);\n  }\n\n  return new SERPError(message, options);\n}\n\nfunction isErrorResponse(body: unknown): body is ErrorResponse {\n  return typeof body === \"object\" && body !== null && \"error\" in body;\n}\n","import type { DebugEvent, OpenSERPConfig } from \"./types/public\";\n\nexport type DebugLevel = \"off\" | \"info\" | \"verbose\";\n\ntype DebugSink = (event: DebugEvent) => void;\n\n/** Resolved debug configuration: the active level and where events go. */\nexport interface DebugReporter {\n  level: DebugLevel;\n  emit(event: DebugEvent): void;\n}\n\nconst NO_OP: DebugReporter = {\n  level: \"off\",\n  emit() {},\n};\n\n/**\n * Resolves the effective debug behaviour from config (falling back to the\n * OPENSERP_DEBUG env var). Returns a no-op reporter when debugging is off so\n * callers can emit unconditionally without a hot-path branch of their own.\n */\nexport function resolveDebug(config: OpenSERPConfig): DebugReporter {\n  const setting = config.debug ?? envDebug();\n\n  if (!setting) {\n    return NO_OP;\n  }\n\n  if (typeof setting === \"function\") {\n    // A custom sink always sees verbose detail; it decides what to keep.\n    return { level: \"verbose\", emit: guard(setting) };\n  }\n\n  const level: DebugLevel = setting === \"verbose\" ? \"verbose\" : \"info\";\n  return { level, emit: consoleSink };\n}\n\nfunction envDebug(): boolean | \"verbose\" | undefined {\n  // Guarded so the SDK still works in browsers / runtimes without `process`.\n  const value =\n    typeof process !== \"undefined\" ? process.env?.OPENSERP_DEBUG : undefined;\n  if (!value) {\n    return undefined;\n  }\n  const normalized = value.trim().toLowerCase();\n  if (normalized === \"verbose\") {\n    return \"verbose\";\n  }\n  if (normalized === \"1\" || normalized === \"true\") {\n    return true;\n  }\n  return undefined;\n}\n\n/** Wraps a user-provided sink so a thrown logger never breaks a request. */\nfunction guard(sink: DebugSink): DebugSink {\n  return (event) => {\n    try {\n      sink(event);\n    } catch {\n      // A broken debug logger must not take down the actual request.\n    }\n  };\n}\n\nconst consoleSink: DebugSink = (event) => {\n  switch (event.type) {\n    case \"request\":\n      console.error(`[openserp] → ${event.method} ${event.url}`);\n      if (event.headers) {\n        console.error(\"[openserp]   headers:\", event.headers);\n      }\n      break;\n    case \"response\": {\n      const engine = event.engineUsed ? ` engine=${event.engineUsed}` : \"\";\n      const reqId = event.requestId ? ` request-id=${event.requestId}` : \"\";\n      console.error(\n        `[openserp] ← ${event.status} ${event.method} ${event.url} (${event.durationMs}ms)${engine}${reqId}`,\n      );\n      if (event.headers) {\n        console.error(\"[openserp]   headers:\", event.headers);\n      }\n      break;\n    }\n    case \"error\":\n      console.error(\n        `[openserp] ✕ ${event.method} ${event.url} (${event.durationMs}ms):`,\n        event.error,\n      );\n      break;\n  }\n};\n\n/** Snapshots headers into a plain object, redacting Authorization. */\nexport function dumpHeaders(headers: Headers): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const [key, value] of headers) {\n    out[key] = key.toLowerCase() === \"authorization\" ? \"Bearer ***\" : value;\n  }\n  return out;\n}\n","import { dumpHeaders, resolveDebug } from \"./debug\";\nimport { TimeoutError, errorFromResponse } from \"./errors\";\nimport type { LastResponse, OpenSERPConfig, ResponseFormat } from \"./types/public\";\n\nexport type QueryValue =\n  | string\n  | number\n  | boolean\n  | readonly string[]\n  | undefined\n  | null;\n\nexport interface RequestOptions {\n  method?: \"GET\" | \"POST\" | undefined;\n  path: string;\n  query?: Record<string, QueryValue> | undefined;\n  headers?: HeadersInit | undefined;\n  body?: BodyInit | null | undefined;\n  format?: ResponseFormat | undefined;\n}\n\nexport interface RequestContext {\n  baseUrl: string;\n  config: OpenSERPConfig;\n  setLastResponse(response: LastResponse): void;\n}\n\nexport async function request<T>(\n  context: RequestContext,\n  options: RequestOptions,\n): Promise<T> {\n  let attempt = 0;\n\n  for (;;) {\n    try {\n      return await requestOnce<T>(context, options);\n    } catch (err) {\n      const shouldRetry = await context.config.retry?.(err, attempt);\n      if (!shouldRetry) {\n        throw err;\n      }\n      attempt += 1;\n    }\n  }\n}\n\nasync function requestOnce<T>(\n  { baseUrl, config, setLastResponse }: RequestContext,\n  options: RequestOptions,\n): Promise<T> {\n  const fetchImpl = config.fetch ?? globalThis.fetch;\n  if (!fetchImpl) {\n    throw new TypeError(\"OpenSERP SDK requires a fetch implementation.\");\n  }\n\n  const url = new URL(`${baseUrl}${options.path}`);\n  appendQuery(url, options.query);\n\n  const headers = new Headers(config.headers);\n  if (config.apiKey) {\n    headers.set(\"Authorization\", `Bearer ${config.apiKey}`);\n  }\n  for (const [key, value] of new Headers(options.headers)) {\n    headers.set(key, value);\n  }\n\n  const debug = resolveDebug(config);\n  const method = options.method ?? \"GET\";\n  if (debug.level !== \"off\") {\n    debug.emit({\n      type: \"request\",\n      method,\n      url: url.toString(),\n      ...(debug.level === \"verbose\" ? { headers: dumpHeaders(headers) } : {}),\n    });\n  }\n\n  const timeoutMs = config.timeoutMs ?? 30_000;\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  const startedAt = Date.now();\n\n  let response: Response;\n  try {\n    const init: RequestInit = {\n      method,\n      headers,\n      signal: controller.signal,\n    };\n    if (options.body !== undefined) {\n      init.body = options.body;\n    }\n\n    response = await fetchImpl(url, init);\n  } catch (err) {\n    const error = isAbortError(err) ? new TimeoutError(timeoutMs, err) : err;\n    if (debug.level !== \"off\") {\n      debug.emit({\n        type: \"error\",\n        method,\n        url: url.toString(),\n        durationMs: Date.now() - startedAt,\n        error,\n      });\n    }\n    throw error;\n  } finally {\n    clearTimeout(timer);\n  }\n\n  const last = readLastResponse(response);\n  setLastResponse(last);\n  if (debug.level !== \"off\") {\n    debug.emit({\n      type: \"response\",\n      method,\n      url: url.toString(),\n      status: response.status,\n      engineUsed: last.engineUsed,\n      requestId: last.requestId,\n      durationMs: Date.now() - startedAt,\n      ...(debug.level === \"verbose\" ? { headers: dumpHeaders(response.headers) } : {}),\n    });\n  }\n\n  const body = await readBody(response, options.format);\n  if (!response.ok) {\n    throw errorFromResponse(response.status, body, response.headers.get(\"x-request-id\") ?? undefined);\n  }\n\n  return body as T;\n}\n\nfunction appendQuery(url: URL, query: Record<string, QueryValue> | undefined): void {\n  if (!query) {\n    return;\n  }\n\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined || value === null) {\n      continue;\n    }\n    const encoded = Array.isArray(value) ? value.join(\",\") : String(value);\n    url.searchParams.set(key, encoded);\n  }\n}\n\nasync function readBody(response: Response, format?: ResponseFormat): Promise<unknown> {\n  if (response.status === 204) {\n    return undefined;\n  }\n\n  if (format && format !== \"json\") {\n    return response.text();\n  }\n\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n  if (contentType.includes(\"application/json\")) {\n    return response.json();\n  }\n\n  const text = await response.text();\n  if (!text) {\n    return undefined;\n  }\n\n  try {\n    return JSON.parse(text);\n  } catch {\n    return text;\n  }\n}\n\nfunction readLastResponse(response: Response): LastResponse {\n  const credits = {\n    used: numberHeader(response.headers, \"x-credits-used\"),\n    remaining: numberHeader(response.headers, \"x-credits-remaining\"),\n  };\n  const hasCredits = credits.used !== undefined || credits.remaining !== undefined;\n\n  return {\n    status: response.status,\n    requestId: response.headers.get(\"x-request-id\") ?? undefined,\n    credits: hasCredits ? credits : undefined,\n    engineUsed: response.headers.get(\"x-engine-used\") ?? undefined,\n    fallbackEngine: response.headers.get(\"x-fallback-engine\") ?? undefined,\n    cache: response.headers.get(\"x-cache\") ?? undefined,\n    proxyMode: response.headers.get(\"x-proxy-mode\") ?? undefined,\n    proxyTag: response.headers.get(\"x-proxy-tag\") ?? undefined,\n    proxyUsed: response.headers.get(\"x-proxy-used\") ?? undefined,\n    networkBytes: numberHeader(response.headers, \"x-network-bytes\"),\n    browserProfileId: response.headers.get(\"x-browser-profile-id\") ?? undefined,\n    headers: response.headers,\n  };\n}\n\nfunction numberHeader(headers: Headers, name: string): number | undefined {\n  const value = headers.get(name);\n  if (value === null || value === \"\") {\n    return undefined;\n  }\n  const parsed = Number(value);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction isAbortError(err: unknown): boolean {\n  return err instanceof DOMException && err.name === \"AbortError\";\n}\n","import { inferBackend, resolveBaseUrl } from \"./backend\";\nimport { CloudOnlyError, OssOnlyError } from \"./errors\";\nimport { request, type QueryValue } from \"./request\";\nimport type {\n  CacheStats,\n  CircuitBreakerStatsResponse,\n  HealthStatus,\n  ImageEnvelope,\n  ImageParams,\n  LastResponse,\n  MegaEnginesResponse,\n  MegaImageParams,\n  MegaSearchEnvelope,\n  MegaSearchParams,\n  OpenSERPConfig,\n  ParseParams,\n  ReadinessStatus,\n  SearchEnvelope,\n  SearchParams,\n  StatsResponse,\n  ProxyStats,\n} from \"./types/public\";\nimport type {\n  CloudAccount,\n  EnginesCapabilities,\n  EnginesStatus,\n  Pricing,\n} from \"./types/cloud\";\n\nexport class OpenSERP {\n  readonly config: OpenSERPConfig;\n  lastResponse?: LastResponse;\n\n  constructor(config: OpenSERPConfig = {}) {\n    this.config = { ...config };\n  }\n\n  get backend() {\n    return inferBackend(this.config);\n  }\n\n  get baseUrl() {\n    return resolveBaseUrl(this.config);\n  }\n\n  search(params: SearchParams): Promise<SearchEnvelope | string> {\n    const { engine, format, ...query } = params;\n    return this.get<SearchEnvelope | string>(`/${engine}/search`, query, format);\n  }\n\n  image(params: ImageParams): Promise<ImageEnvelope | string> {\n    const { engine, format, ...query } = params;\n    return this.get<ImageEnvelope | string>(`/${engine}/image`, query, format);\n  }\n\n  megaSearch(params: MegaSearchParams): Promise<MegaSearchEnvelope | string> {\n    const { format, ...query } = params;\n    return this.get<MegaSearchEnvelope | string>(\"/mega/search\", query, format);\n  }\n\n  fastSearch(params: Omit<MegaSearchParams, \"mode\">): Promise<MegaSearchEnvelope | string> {\n    return this.megaSearch({ ...params, mode: \"fast\" });\n  }\n\n  anySearch(params: Omit<MegaSearchParams, \"mode\">): Promise<MegaSearchEnvelope | string> {\n    return this.megaSearch({ ...params, mode: \"any\" });\n  }\n\n  megaImage(params: MegaImageParams): Promise<ImageEnvelope | string> {\n    const { format, ...query } = params;\n    return this.get<ImageEnvelope | string>(\"/mega/image\", query, format);\n  }\n\n  fastImage(params: Omit<MegaImageParams, \"mode\">): Promise<ImageEnvelope | string> {\n    return this.megaImage({ ...params, mode: \"fast\" });\n  }\n\n  anyImage(params: Omit<MegaImageParams, \"mode\">): Promise<ImageEnvelope | string> {\n    return this.megaImage({ ...params, mode: \"any\" });\n  }\n\n  parseGoogle(params: ParseParams): Promise<SearchEnvelope | string> {\n    this.assertOss(\"parseGoogle\");\n    return this.parse(\"/google/parse\", params);\n  }\n\n  parseBing(params: ParseParams): Promise<SearchEnvelope | string> {\n    this.assertOss(\"parseBing\");\n    return this.parse(\"/bing/parse\", params);\n  }\n\n  health(): Promise<HealthStatus> {\n    this.assertOss(\"health\");\n    return this.get<HealthStatus>(\"/health\");\n  }\n\n  ready(): Promise<ReadinessStatus> {\n    this.assertOss(\"ready\");\n    return this.get<ReadinessStatus>(\"/ready\");\n  }\n\n  stats(): Promise<StatsResponse> {\n    this.assertOss(\"stats\");\n    return this.get<StatsResponse>(\"/stats\");\n  }\n\n  cacheStats(): Promise<CacheStats> {\n    this.assertOss(\"cacheStats\");\n    return this.get<CacheStats>(\"/stats/cache\");\n  }\n\n  proxyStats(): Promise<ProxyStats> {\n    this.assertOss(\"proxyStats\");\n    return this.get<ProxyStats>(\"/stats/proxy\");\n  }\n\n  circuitBreakerStats(): Promise<CircuitBreakerStatsResponse> {\n    this.assertOss(\"circuitBreakerStats\");\n    return this.get<CircuitBreakerStatsResponse>(\"/stats/cb\");\n  }\n\n  engines(): Promise<MegaEnginesResponse> {\n    this.assertOss(\"engines\");\n    return this.get<MegaEnginesResponse>(\"/mega/engines\");\n  }\n\n  me(): Promise<CloudAccount> {\n    this.assertCloud(\"me\");\n    return this.get<CloudAccount>(\"/me\");\n  }\n\n  pricing(): Promise<Pricing> {\n    this.assertCloud(\"pricing\");\n    return this.get<Pricing>(\"/pricing\");\n  }\n\n  enginesStatus(): Promise<EnginesStatus> {\n    this.assertCloud(\"enginesStatus\");\n    return this.get<EnginesStatus>(\"/engines/status\");\n  }\n\n  enginesCapabilities(): Promise<EnginesCapabilities> {\n    this.assertCloud(\"enginesCapabilities\");\n    return this.get<EnginesCapabilities>(\"/engines/capabilities\");\n  }\n\n  private parse(path: string, params: ParseParams): Promise<SearchEnvelope | string> {\n    return request<SearchEnvelope | string>(this.requestContext(), {\n      method: \"POST\",\n      path,\n      query: params.format ? { format: params.format } : undefined,\n      headers: {\n        \"Content-Type\": \"text/html; charset=utf-8\",\n      },\n      body: params.html,\n      format: params.format,\n    });\n  }\n\n  private get<T>(\n    path: string,\n    query?: Record<string, QueryValue>,\n    format?: SearchParams[\"format\"],\n  ): Promise<T> {\n    const { query: cleanQuery, headers } = splitQueryAndHeaders({\n      ...query,\n      format,\n    });\n\n    return request<T>(this.requestContext(), {\n      path,\n      query: cleanQuery,\n      headers,\n      format,\n    });\n  }\n\n  private requestContext() {\n    return {\n      baseUrl: this.baseUrl,\n      config: this.config,\n      setLastResponse: (response: LastResponse) => {\n        this.lastResponse = response;\n      },\n    };\n  }\n\n  private assertCloud(method: string): void {\n    if (this.backend !== \"cloud\") {\n      throw new CloudOnlyError(method);\n    }\n  }\n\n  private assertOss(method: string): void {\n    if (this.backend !== \"oss\") {\n      throw new OssOnlyError(method);\n    }\n  }\n}\n\nfunction splitQueryAndHeaders(query: Record<string, QueryValue>): {\n  query: Record<string, QueryValue>;\n  headers: HeadersInit;\n} {\n  const {\n    useProxy,\n    proxyUrl,\n    proxyCountry,\n    proxyClass,\n    proxyProvider,\n    proxySessionId,\n    tenant,\n    ...cleanQuery\n  } = query;\n  const headers: Record<string, string> = {};\n\n  addHeader(headers, \"X-Use-Proxy\", useProxy);\n  addHeader(headers, \"X-Proxy-URL\", proxyUrl);\n  addHeader(headers, \"X-Proxy-Country\", proxyCountry);\n  addHeader(headers, \"X-Proxy-Class\", proxyClass);\n  addHeader(headers, \"X-Proxy-Provider\", proxyProvider);\n  addHeader(headers, \"X-Proxy-Session-ID\", proxySessionId);\n  addHeader(headers, \"X-Tenant\", tenant);\n\n  return { query: cleanQuery, headers };\n}\n\nfunction addHeader(headers: Record<string, string>, name: string, value: QueryValue): void {\n  if (value === undefined || value === null) {\n    return;\n  }\n  headers[name] = Array.isArray(value) ? value.join(\",\") : String(value);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openserp/sdk",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "TypeScript/JavaScript SDK for the OpenSERP self-hosted server and OpenSERP Cloud.",
   "type": "module",
   "license": "MIT",
@@ -8,8 +8,7 @@
   "homepage": "https://openserp.org",
   "repository": {
     "type": "git",
-    "url": "https://github.com/karust/openserp.git",
-    "directory": "integrations/sdk-js"
+    "url": "git+https://github.com/karust/openserp.git"
   },
   "bugs": {
     "url": "https://github.com/karust/openserp/issues"
@@ -17,15 +16,40 @@
   "keywords": [
     "openserp",
     "serp",
+    "serp-api",
     "search",
+    "search-api",
+    "google-search",
+    "google-search-api",
     "google",
     "bing",
     "yandex",
     "baidu",
     "duckduckgo",
     "ecosia",
+    "scraper",
+    "scraping",
+    "web-scraping",
+    "serpapi",
+    "serpapi-alternative",
     "seo",
-    "ai-grounding"
+    "rank-tracking",
+    "rank-tracker",
+    "keyword-research",
+    "ai",
+    "ai-grounding",
+    "rag",
+    "llm",
+    "llm-tools",
+    "agent",
+    "agent-tools",
+    "tool-use",
+    "openai",
+    "anthropic",
+    "mcp",
+    "typescript",
+    "nodejs",
+    "edge-runtime"
   ],
   "sideEffects": false,
   "exports": {