searxng-sdk 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,86 @@
+# searxng-sdk
+
+Zero-dependency TypeScript SDK for the [SearXNG](https://docs.searxng.org/) search API.
+
+## Install
+
+```bash
+npm install searxng-sdk
+# or
+bun add searxng-sdk
+```
+
+## Usage
+
+```ts
+import { SearxngClient } from "searxng-sdk";
+
+const client = new SearxngClient({ baseUrl: "http://localhost:8888" });
+
+const { results } = await client
+  .search("bitcoin price")
+  .categories("news")
+  .language("fr")
+  .timeRange("day")
+  .execute();
+```
+
+## API
+
+### `new SearxngClient(config)`
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `baseUrl` | `string` | **required** | SearXNG instance URL |
+| `timeout` | `number` | `10000` | Request timeout in ms |
+| `retry` | `{ maxRetries, baseDelayMs }` | `{ 3, 1000 }` | Retry on 429 with exponential backoff |
+| `defaultLanguage` | `string` | — | Applied to all searches |
+| `defaultCategories` | `string[]` | — | Applied to all searches |
+| `defaultSafesearch` | `0 \| 1 \| 2` | — | Applied to all searches |
+| `headers` | `Record<string, string>` | — | Custom headers (e.g. proxy auth) |
+
+### `client.search(query)`
+
+Returns a `SearchBuilder` with chainable methods:
+
+```ts
+.categories(...categories: string[])  // "general", "news", "images", "videos", "it", "science", ...
+.engines(...engines: string[])        // "google", "bing", "duckduckgo", "wikipedia", ...
+.language(lang: string)               // "en", "fr", "de", ...
+.page(n: number)                      // >= 1
+.timeRange(range)                     // "day" | "week" | "month" | "year"
+.safesearch(level)                    // 0 (off) | 1 (moderate) | 2 (strict)
+.execute()                            // → Promise<SearchResponse>
+```
+
+### `SearchResponse`
+
+```ts
+{
+  query: string;
+  results: SearchResult[];       // { title, url, content, engine, publishedDate?, author?, thumbnail?, imgSrc?, category? }
+  suggestions: string[];
+  corrections: string[];
+  infobox?: Infobox;             // { title, imgSrc?, content?, attributes, urls, relatedTopics }
+  unresponsiveEngines: [string, string][];
+}
+```
+
+## Prerequisites
+
+Your SearXNG instance must have JSON format enabled in `settings.yml`:
+
+```yaml
+search:
+  formats:
+    - html
+    - json
+```
+
+## Compatibility
+
+Node.js 18+ / Bun / Deno
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,297 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SearchBuilder: () => SearchBuilder,
+  SearxngClient: () => SearxngClient,
+  SearxngError: () => SearxngError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors/searxng-error.ts
+var SearxngError = class extends Error {
+  constructor(message, status, retryAfter) {
+    super(message);
+    this.name = "SearxngError";
+    this.status = status;
+    this.retryAfter = retryAfter;
+  }
+};
+
+// src/http/fetch.ts
+async function fetchJson(url, options) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), options.timeout);
+  try {
+    const response = await fetch(url, {
+      signal: controller.signal,
+      headers: {
+        Accept: "application/json",
+        ...options.headers
+      }
+    });
+    clearTimeout(timeoutId);
+    if (!response.ok) {
+      const retryAfter = parseRetryAfter(response.headers.get("Retry-After"));
+      if (response.status === 403) {
+        throw new SearxngError(
+          "JSON format not enabled on this instance",
+          403
+        );
+      }
+      throw new SearxngError(
+        `HTTP ${response.status} ${response.statusText}`,
+        response.status,
+        retryAfter
+      );
+    }
+    let data;
+    try {
+      data = await response.json();
+    } catch {
+      throw new SearxngError("Invalid JSON response", response.status);
+    }
+    return { data, response };
+  } catch (error) {
+    clearTimeout(timeoutId);
+    if (error instanceof SearxngError) {
+      throw error;
+    }
+    if (error instanceof Error && error.name === "AbortError") {
+      throw new SearxngError("Request timed out", 0);
+    }
+    throw new SearxngError(
+      `Network error: ${error instanceof Error ? error.message : String(error)}`,
+      0
+    );
+  }
+}
+function parseRetryAfter(value) {
+  if (!value) return void 0;
+  const seconds = Number(value);
+  return Number.isFinite(seconds) ? seconds : void 0;
+}
+
+// src/http/retry.ts
+async function withRetry(fn, options) {
+  let lastError;
+  for (let attempt = 0; attempt <= options.maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      if (!(error instanceof SearxngError) || error.status !== 429) {
+        throw error;
+      }
+      lastError = error;
+      if (attempt === options.maxRetries) {
+        break;
+      }
+      const backoff = options.baseDelayMs * Math.pow(2, attempt);
+      const delay = error.retryAfter !== void 0 ? Math.max(error.retryAfter * 1e3, backoff) : backoff;
+      await sleep(delay);
+    }
+  }
+  throw lastError;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/builders/response-mapper.ts
+function mapRawResponse(raw) {
+  return {
+    query: String(raw["query"] ?? ""),
+    results: mapResults(raw["results"]),
+    suggestions: mapStringArray(raw["suggestions"]),
+    corrections: mapStringArray(raw["corrections"]),
+    infobox: raw["infoboxes"] ? mapInfobox(raw["infoboxes"]) : void 0,
+    unresponsiveEngines: mapUnresponsiveEngines(raw["unresponsive_engines"])
+  };
+}
+function mapResults(raw) {
+  if (!Array.isArray(raw)) return [];
+  return raw.map((r) => ({
+    title: String(r["title"] ?? ""),
+    url: String(r["url"] ?? ""),
+    content: String(r["content"] ?? ""),
+    engine: String(r["engine"] ?? ""),
+    publishedDate: optionalString(r["publishedDate"] ?? r["published_date"]),
+    author: optionalString(r["author"]),
+    thumbnail: optionalString(r["thumbnail"] ?? r["thumbnail_src"]),
+    imgSrc: optionalString(r["img_src"]),
+    category: optionalString(r["category"])
+  }));
+}
+function mapInfobox(raw) {
+  if (!Array.isArray(raw) || raw.length === 0) return void 0;
+  const box = raw[0];
+  return {
+    title: String(box["infobox"] ?? ""),
+    imgSrc: optionalString(box["img_src"]),
+    content: optionalString(box["content"]),
+    attributes: mapInfoboxAttributes(box["attributes"]),
+    urls: mapInfoboxUrls(box["urls"]),
+    relatedTopics: mapInfoboxRelatedTopics(box["relatedTopics"])
+  };
+}
+function mapInfoboxAttributes(raw) {
+  if (!Array.isArray(raw)) return [];
+  return raw.map((a) => ({
+    label: String(a["label"] ?? ""),
+    value: String(a["value"] ?? "")
+  }));
+}
+function mapInfoboxUrls(raw) {
+  if (!Array.isArray(raw)) return [];
+  return raw.map((u) => ({
+    url: String(u["url"] ?? ""),
+    title: String(u["title"] ?? "")
+  }));
+}
+function mapInfoboxRelatedTopics(raw) {
+  if (!Array.isArray(raw)) return [];
+  return raw.map((t) => ({
+    name: String(t["name"] ?? ""),
+    suggestions: mapStringArray(
+      Array.isArray(t["suggestions"]) ? t["suggestions"].map(
+        (s) => s["suggestion"] ?? s
+      ) : void 0
+    )
+  }));
+}
+function mapUnresponsiveEngines(raw) {
+  if (!Array.isArray(raw)) return [];
+  return raw.filter((e) => Array.isArray(e) && e.length >= 2).map((e) => [String(e[0]), String(e[1])]);
+}
+function mapStringArray(raw) {
+  if (!Array.isArray(raw)) return [];
+  return raw.map(String);
+}
+function optionalString(value) {
+  if (value === null || value === void 0) return void 0;
+  return String(value);
+}
+
+// src/builders/search.builder.ts
+var SearchBuilder = class {
+  constructor(query, config) {
+    this.executed = false;
+    if (!query.trim()) {
+      throw new SearxngError("Search query must not be empty", 0);
+    }
+    this.config = config;
+    this.params = {
+      q: query,
+      format: "json",
+      language: config.defaultLanguage,
+      categories: config.defaultCategories?.join(","),
+      safesearch: config.defaultSafesearch
+    };
+  }
+  categories(...categories) {
+    this.params.categories = categories.join(",");
+    return this;
+  }
+  engines(...engines) {
+    this.params.engines = engines.join(",");
+    return this;
+  }
+  language(lang) {
+    this.params.language = lang;
+    return this;
+  }
+  page(pageno) {
+    if (pageno < 1) {
+      throw new SearxngError("Page number must be >= 1", 0);
+    }
+    this.params.pageno = pageno;
+    return this;
+  }
+  timeRange(range) {
+    this.params.time_range = range;
+    return this;
+  }
+  safesearch(level) {
+    this.params.safesearch = level;
+    return this;
+  }
+  async execute() {
+    if (this.executed) {
+      throw new SearxngError("Builder already executed", 0);
+    }
+    this.executed = true;
+    const url = this.buildUrl();
+    const { data } = await withRetry(
+      () => fetchJson(url, {
+        timeout: this.config.timeout,
+        headers: this.config.headers
+      }),
+      this.config.retry
+    );
+    return mapRawResponse(data);
+  }
+  buildUrl() {
+    const url = new URL("/search", this.config.baseUrl);
+    for (const [key, value] of Object.entries(this.params)) {
+      if (value !== void 0) {
+        url.searchParams.set(key, String(value));
+      }
+    }
+    return url.toString();
+  }
+};
+
+// src/client.ts
+var SearxngClient = class {
+  constructor(config) {
+    if (!config.baseUrl?.trim()) {
+      throw new SearxngError("baseUrl is required", 0);
+    }
+    if (config.timeout !== void 0 && config.timeout <= 0) {
+      throw new SearxngError("timeout must be > 0", 0);
+    }
+    if (config.retry?.maxRetries !== void 0 && config.retry.maxRetries < 0) {
+      throw new SearxngError("retry.maxRetries must be >= 0", 0);
+    }
+    this.config = {
+      baseUrl: config.baseUrl.replace(/\/+$/, ""),
+      timeout: config.timeout ?? 1e4,
+      retry: {
+        maxRetries: config.retry?.maxRetries ?? 3,
+        baseDelayMs: config.retry?.baseDelayMs ?? 1e3
+      },
+      defaultLanguage: config.defaultLanguage,
+      defaultCategories: config.defaultCategories,
+      defaultSafesearch: config.defaultSafesearch,
+      headers: config.headers ?? {}
+    };
+  }
+  search(query) {
+    return new SearchBuilder(query, this.config);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SearchBuilder,
+  SearxngClient,
+  SearxngError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors/searxng-error.ts","../src/http/fetch.ts","../src/http/retry.ts","../src/builders/response-mapper.ts","../src/builders/search.builder.ts","../src/client.ts"],"sourcesContent":["export { SearxngClient } from \"./client.ts\";\nexport { SearchBuilder } from \"./builders/search.builder.ts\";\nexport { SearxngError } from \"./errors/searxng-error.ts\";\n\nexport type {\n  SearxngClientConfig,\n  SafeSearch,\n  RetryConfig,\n} from \"./types/config.ts\";\nexport type { TimeRange } from \"./types/search-params.ts\";\nexport type {\n  SearchResponse,\n  SearchResult,\n  Infobox,\n  InfoboxAttribute,\n  InfoboxUrl,\n  InfoboxRelatedTopic,\n  UnresponsiveEngine,\n} from \"./types/search-response.ts\";\n","export class SearxngError extends Error {\n  readonly status: number;\n  readonly retryAfter?: number;\n\n  constructor(message: string, status: number, retryAfter?: number) {\n    super(message);\n    this.name = \"SearxngError\";\n    this.status = status;\n    this.retryAfter = retryAfter;\n  }\n}\n","import { SearxngError } from \"../errors/searxng-error.ts\";\n\nexport interface FetchJsonOptions {\n  timeout: number;\n  headers: Record<string, string>;\n}\n\nexport async function fetchJson<T>(\n  url: string,\n  options: FetchJsonOptions,\n): Promise<{ data: T; response: Response }> {\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), options.timeout);\n\n  try {\n    const response = await fetch(url, {\n      signal: controller.signal,\n      headers: {\n        Accept: \"application/json\",\n        ...options.headers,\n      },\n    });\n\n    clearTimeout(timeoutId);\n\n    if (!response.ok) {\n      const retryAfter = parseRetryAfter(response.headers.get(\"Retry-After\"));\n\n      if (response.status === 403) {\n        throw new SearxngError(\n          \"JSON format not enabled on this instance\",\n          403,\n        );\n      }\n\n      throw new SearxngError(\n        `HTTP ${response.status} ${response.statusText}`,\n        response.status,\n        retryAfter,\n      );\n    }\n\n    let data: T;\n    try {\n      data = (await response.json()) as T;\n    } catch {\n      throw new SearxngError(\"Invalid JSON response\", response.status);\n    }\n\n    return { data, response };\n  } catch (error) {\n    clearTimeout(timeoutId);\n\n    if (error instanceof SearxngError) {\n      throw error;\n    }\n\n    if (error instanceof Error && error.name === \"AbortError\") {\n      throw new SearxngError(\"Request timed out\", 0);\n    }\n\n    throw new SearxngError(\n      `Network error: ${error instanceof Error ? error.message : String(error)}`,\n      0,\n    );\n  }\n}\n\nfunction parseRetryAfter(value: string | null): number | undefined {\n  if (!value) return undefined;\n  const seconds = Number(value);\n  return Number.isFinite(seconds) ? seconds : undefined;\n}\n","import { SearxngError } from \"../errors/searxng-error.ts\";\n\nexport interface RetryOptions {\n  maxRetries: number;\n  baseDelayMs: number;\n}\n\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  options: RetryOptions,\n): Promise<T> {\n  let lastError: SearxngError | undefined;\n\n  for (let attempt = 0; attempt <= options.maxRetries; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      if (!(error instanceof SearxngError) || error.status !== 429) {\n        throw error;\n      }\n\n      lastError = error;\n\n      if (attempt === options.maxRetries) {\n        break;\n      }\n\n      const backoff = options.baseDelayMs * Math.pow(2, attempt);\n      const delay =\n        error.retryAfter !== undefined\n          ? Math.max(error.retryAfter * 1000, backoff)\n          : backoff;\n\n      await sleep(delay);\n    }\n  }\n\n  throw lastError!;\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import type {\n  SearchResponse,\n  SearchResult,\n  Infobox,\n  InfoboxAttribute,\n  InfoboxUrl,\n  InfoboxRelatedTopic,\n  UnresponsiveEngine,\n} from \"../types/search-response.ts\";\n\ntype RawRecord = Record<string, unknown>;\ntype RawResponse = Record<string, unknown>;\n\nexport function mapRawResponse(raw: RawResponse): SearchResponse {\n  return {\n    query: String(raw[\"query\"] ?? \"\"),\n    results: mapResults(raw[\"results\"]),\n    suggestions: mapStringArray(raw[\"suggestions\"]),\n    corrections: mapStringArray(raw[\"corrections\"]),\n    infobox: raw[\"infoboxes\"] ? mapInfobox(raw[\"infoboxes\"]) : undefined,\n    unresponsiveEngines: mapUnresponsiveEngines(raw[\"unresponsive_engines\"]),\n  };\n}\n\nfunction mapResults(raw: unknown): SearchResult[] {\n  if (!Array.isArray(raw)) return [];\n\n  return raw.map((r: RawRecord) => ({\n    title: String(r[\"title\"] ?? \"\"),\n    url: String(r[\"url\"] ?? \"\"),\n    content: String(r[\"content\"] ?? \"\"),\n    engine: String(r[\"engine\"] ?? \"\"),\n    publishedDate: optionalString(r[\"publishedDate\"] ?? r[\"published_date\"]),\n    author: optionalString(r[\"author\"]),\n    thumbnail: optionalString(r[\"thumbnail\"] ?? r[\"thumbnail_src\"]),\n    imgSrc: optionalString(r[\"img_src\"]),\n    category: optionalString(r[\"category\"]),\n  }));\n}\n\nfunction mapInfobox(raw: unknown): Infobox | undefined {\n  if (!Array.isArray(raw) || raw.length === 0) return undefined;\n\n  const box = raw[0] as RawRecord;\n  return {\n    title: String(box[\"infobox\"] ?? \"\"),\n    imgSrc: optionalString(box[\"img_src\"]),\n    content: optionalString(box[\"content\"]),\n    attributes: mapInfoboxAttributes(box[\"attributes\"]),\n    urls: mapInfoboxUrls(box[\"urls\"]),\n    relatedTopics: mapInfoboxRelatedTopics(box[\"relatedTopics\"]),\n  };\n}\n\nfunction mapInfoboxAttributes(raw: unknown): InfoboxAttribute[] {\n  if (!Array.isArray(raw)) return [];\n  return raw.map((a: Record<string, unknown>) => ({\n    label: String(a[\"label\"] ?? \"\"),\n    value: String(a[\"value\"] ?? \"\"),\n  }));\n}\n\nfunction mapInfoboxUrls(raw: unknown): InfoboxUrl[] {\n  if (!Array.isArray(raw)) return [];\n  return raw.map((u: Record<string, unknown>) => ({\n    url: String(u[\"url\"] ?? \"\"),\n    title: String(u[\"title\"] ?? \"\"),\n  }));\n}\n\nfunction mapInfoboxRelatedTopics(raw: unknown): InfoboxRelatedTopic[] {\n  if (!Array.isArray(raw)) return [];\n  return raw.map((t: Record<string, unknown>) => ({\n    name: String(t[\"name\"] ?? \"\"),\n    suggestions: mapStringArray(\n      Array.isArray(t[\"suggestions\"])\n        ? t[\"suggestions\"].map(\n            (s: Record<string, unknown>) => s[\"suggestion\"] ?? s,\n          )\n        : undefined,\n    ),\n  }));\n}\n\nfunction mapUnresponsiveEngines(raw: unknown): UnresponsiveEngine[] {\n  if (!Array.isArray(raw)) return [];\n  return raw\n    .filter((e): e is [unknown, unknown] => Array.isArray(e) && e.length >= 2)\n    .map((e) => [String(e[0]), String(e[1])] as UnresponsiveEngine);\n}\n\nfunction mapStringArray(raw: unknown): string[] {\n  if (!Array.isArray(raw)) return [];\n  return raw.map(String);\n}\n\nfunction optionalString(value: unknown): string | undefined {\n  if (value === null || value === undefined) return undefined;\n  return String(value);\n}\n","import type { SafeSearch, ResolvedConfig } from \"../types/config.ts\";\nimport type { SearchParams, TimeRange } from \"../types/search-params.ts\";\nimport type { SearchResponse } from \"../types/search-response.ts\";\nimport { SearxngError } from \"../errors/searxng-error.ts\";\nimport { fetchJson } from \"../http/fetch.ts\";\nimport { withRetry } from \"../http/retry.ts\";\nimport { mapRawResponse } from \"./response-mapper.ts\";\n\nexport class SearchBuilder {\n  private readonly params: SearchParams;\n  private readonly config: ResolvedConfig;\n  private executed = false;\n\n  constructor(query: string, config: ResolvedConfig) {\n    if (!query.trim()) {\n      throw new SearxngError(\"Search query must not be empty\", 0);\n    }\n\n    this.config = config;\n    this.params = {\n      q: query,\n      format: \"json\",\n      language: config.defaultLanguage,\n      categories: config.defaultCategories?.join(\",\"),\n      safesearch: config.defaultSafesearch,\n    };\n  }\n\n  categories(...categories: string[]): this {\n    this.params.categories = categories.join(\",\");\n    return this;\n  }\n\n  engines(...engines: string[]): this {\n    this.params.engines = engines.join(\",\");\n    return this;\n  }\n\n  language(lang: string): this {\n    this.params.language = lang;\n    return this;\n  }\n\n  page(pageno: number): this {\n    if (pageno < 1) {\n      throw new SearxngError(\"Page number must be >= 1\", 0);\n    }\n    this.params.pageno = pageno;\n    return this;\n  }\n\n  timeRange(range: TimeRange): this {\n    this.params.time_range = range;\n    return this;\n  }\n\n  safesearch(level: SafeSearch): this {\n    this.params.safesearch = level;\n    return this;\n  }\n\n  async execute(): Promise<SearchResponse> {\n    if (this.executed) {\n      throw new SearxngError(\"Builder already executed\", 0);\n    }\n    this.executed = true;\n\n    const url = this.buildUrl();\n\n    const { data } = await withRetry(\n      () =>\n        fetchJson<Record<string, unknown>>(url, {\n          timeout: this.config.timeout,\n          headers: this.config.headers,\n        }),\n      this.config.retry,\n    );\n\n    return mapRawResponse(data);\n  }\n\n  private buildUrl(): string {\n    const url = new URL(\"/search\", this.config.baseUrl);\n\n    for (const [key, value] of Object.entries(this.params)) {\n      if (value !== undefined) {\n        url.searchParams.set(key, String(value));\n      }\n    }\n\n    return url.toString();\n  }\n}\n","import type { SearxngClientConfig, ResolvedConfig } from \"./types/config.ts\";\nimport { SearxngError } from \"./errors/searxng-error.ts\";\nimport { SearchBuilder } from \"./builders/search.builder.ts\";\n\nexport class SearxngClient {\n  private readonly config: ResolvedConfig;\n\n  constructor(config: SearxngClientConfig) {\n    if (!config.baseUrl?.trim()) {\n      throw new SearxngError(\"baseUrl is required\", 0);\n    }\n\n    if (config.timeout !== undefined && config.timeout <= 0) {\n      throw new SearxngError(\"timeout must be > 0\", 0);\n    }\n\n    if (\n      config.retry?.maxRetries !== undefined &&\n      config.retry.maxRetries < 0\n    ) {\n      throw new SearxngError(\"retry.maxRetries must be >= 0\", 0);\n    }\n\n    this.config = {\n      baseUrl: config.baseUrl.replace(/\\/+$/, \"\"),\n      timeout: config.timeout ?? 10_000,\n      retry: {\n        maxRetries: config.retry?.maxRetries ?? 3,\n        baseDelayMs: config.retry?.baseDelayMs ?? 1_000,\n      },\n      defaultLanguage: config.defaultLanguage,\n      defaultCategories: config.defaultCategories,\n      defaultSafesearch: config.defaultSafesearch,\n      headers: config.headers ?? {},\n    };\n  }\n\n  search(query: string): SearchBuilder {\n    return new SearchBuilder(query, this.config);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,95 @@
+type SafeSearch = 0 | 1 | 2;
+interface RetryConfig {
+    maxRetries?: number;
+    baseDelayMs?: number;
+}
+interface SearxngClientConfig {
+    baseUrl: string;
+    timeout?: number;
+    retry?: RetryConfig;
+    defaultLanguage?: string;
+    defaultCategories?: string[];
+    defaultSafesearch?: SafeSearch;
+    headers?: Record<string, string>;
+}
+interface ResolvedConfig {
+    baseUrl: string;
+    timeout: number;
+    retry: Required<RetryConfig>;
+    defaultLanguage?: string;
+    defaultCategories?: string[];
+    defaultSafesearch?: SafeSearch;
+    headers: Record<string, string>;
+}
+
+type TimeRange = "day" | "week" | "month" | "year";
+
+interface SearchResult {
+    title: string;
+    url: string;
+    content: string;
+    engine: string;
+    publishedDate?: string;
+    author?: string;
+    thumbnail?: string;
+    imgSrc?: string;
+    category?: string;
+}
+interface InfoboxAttribute {
+    label: string;
+    value: string;
+}
+interface InfoboxUrl {
+    url: string;
+    title: string;
+}
+interface InfoboxRelatedTopic {
+    name: string;
+    suggestions: string[];
+}
+interface Infobox {
+    title: string;
+    imgSrc?: string;
+    content?: string;
+    attributes: InfoboxAttribute[];
+    urls: InfoboxUrl[];
+    relatedTopics: InfoboxRelatedTopic[];
+}
+type UnresponsiveEngine = [engine: string, reason: string];
+interface SearchResponse {
+    query: string;
+    results: SearchResult[];
+    suggestions: string[];
+    corrections: string[];
+    infobox?: Infobox;
+    unresponsiveEngines: UnresponsiveEngine[];
+}
+
+declare class SearchBuilder {
+    private readonly params;
+    private readonly config;
+    private executed;
+    constructor(query: string, config: ResolvedConfig);
+    categories(...categories: string[]): this;
+    engines(...engines: string[]): this;
+    language(lang: string): this;
+    page(pageno: number): this;
+    timeRange(range: TimeRange): this;
+    safesearch(level: SafeSearch): this;
+    execute(): Promise<SearchResponse>;
+    private buildUrl;
+}
+
+declare class SearxngClient {
+    private readonly config;
+    constructor(config: SearxngClientConfig);
+    search(query: string): SearchBuilder;
+}
+
+declare class SearxngError extends Error {
+    readonly status: number;
+    readonly retryAfter?: number;
+    constructor(message: string, status: number, retryAfter?: number);
+}
+
+export { type Infobox, type InfoboxAttribute, type InfoboxRelatedTopic, type InfoboxUrl, type RetryConfig, type SafeSearch, SearchBuilder, type SearchResponse, type SearchResult, SearxngClient, type SearxngClientConfig, SearxngError, type TimeRange, type UnresponsiveEngine };

package/dist/index.d.ts

@@ -0,0 +1,95 @@
+type SafeSearch = 0 | 1 | 2;
+interface RetryConfig {
+    maxRetries?: number;
+    baseDelayMs?: number;
+}
+interface SearxngClientConfig {
+    baseUrl: string;
+    timeout?: number;
+    retry?: RetryConfig;
+    defaultLanguage?: string;
+    defaultCategories?: string[];
+    defaultSafesearch?: SafeSearch;
+    headers?: Record<string, string>;
+}
+interface ResolvedConfig {
+    baseUrl: string;
+    timeout: number;
+    retry: Required<RetryConfig>;
+    defaultLanguage?: string;
+    defaultCategories?: string[];
+    defaultSafesearch?: SafeSearch;
+    headers: Record<string, string>;
+}
+
+type TimeRange = "day" | "week" | "month" | "year";
+
+interface SearchResult {
+    title: string;
+    url: string;
+    content: string;
+    engine: string;
+    publishedDate?: string;
+    author?: string;
+    thumbnail?: string;
+    imgSrc?: string;
+    category?: string;
+}
+interface InfoboxAttribute {
+    label: string;
+    value: string;
+}
+interface InfoboxUrl {
+    url: string;
+    title: string;
+}
+interface InfoboxRelatedTopic {
+    name: string;
+    suggestions: string[];
+}
+interface Infobox {
+    title: string;
+    imgSrc?: string;
+    content?: string;
+    attributes: InfoboxAttribute[];
+    urls: InfoboxUrl[];
+    relatedTopics: InfoboxRelatedTopic[];
+}
+type UnresponsiveEngine = [engine: string, reason: string];
+interface SearchResponse {
+    query: string;
+    results: SearchResult[];
+    suggestions: string[];
+    corrections: string[];
+    infobox?: Infobox;
+    unresponsiveEngines: UnresponsiveEngine[];
+}
+
+declare class SearchBuilder {
+    private readonly params;
+    private readonly config;
+    private executed;
+    constructor(query: string, config: ResolvedConfig);
+    categories(...categories: string[]): this;
+    engines(...engines: string[]): this;
+    language(lang: string): this;
+    page(pageno: number): this;
+    timeRange(range: TimeRange): this;
+    safesearch(level: SafeSearch): this;
+    execute(): Promise<SearchResponse>;
+    private buildUrl;
+}
+
+declare class SearxngClient {
+    private readonly config;
+    constructor(config: SearxngClientConfig);
+    search(query: string): SearchBuilder;
+}
+
+declare class SearxngError extends Error {
+    readonly status: number;
+    readonly retryAfter?: number;
+    constructor(message: string, status: number, retryAfter?: number);
+}
+
+export { type Infobox, type InfoboxAttribute, type InfoboxRelatedTopic, type InfoboxUrl, type RetryConfig, type SafeSearch, SearchBuilder, type SearchResponse, type SearchResult, SearxngClient, type SearxngClientConfig, SearxngError, type TimeRange, type UnresponsiveEngine };

package/dist/index.js

@@ -0,0 +1,268 @@
+// src/errors/searxng-error.ts
+var SearxngError = class extends Error {
+  constructor(message, status, retryAfter) {
+    super(message);
+    this.name = "SearxngError";
+    this.status = status;
+    this.retryAfter = retryAfter;
+  }
+};
+
+// src/http/fetch.ts
+async function fetchJson(url, options) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), options.timeout);
+  try {
+    const response = await fetch(url, {
+      signal: controller.signal,
+      headers: {
+        Accept: "application/json",
+        ...options.headers
+      }
+    });
+    clearTimeout(timeoutId);
+    if (!response.ok) {
+      const retryAfter = parseRetryAfter(response.headers.get("Retry-After"));
+      if (response.status === 403) {
+        throw new SearxngError(
+          "JSON format not enabled on this instance",
+          403
+        );
+      }
+      throw new SearxngError(
+        `HTTP ${response.status} ${response.statusText}`,
+        response.status,
+        retryAfter
+      );
+    }
+    let data;
+    try {
+      data = await response.json();
+    } catch {
+      throw new SearxngError("Invalid JSON response", response.status);
+    }
+    return { data, response };
+  } catch (error) {
+    clearTimeout(timeoutId);
+    if (error instanceof SearxngError) {
+      throw error;
+    }
+    if (error instanceof Error && error.name === "AbortError") {
+      throw new SearxngError("Request timed out", 0);
+    }
+    throw new SearxngError(
+      `Network error: ${error instanceof Error ? error.message : String(error)}`,
+      0
+    );
+  }
+}
+function parseRetryAfter(value) {
+  if (!value) return void 0;
+  const seconds = Number(value);
+  return Number.isFinite(seconds) ? seconds : void 0;
+}
+
+// src/http/retry.ts
+async function withRetry(fn, options) {
+  let lastError;
+  for (let attempt = 0; attempt <= options.maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      if (!(error instanceof SearxngError) || error.status !== 429) {
+        throw error;
+      }
+      lastError = error;
+      if (attempt === options.maxRetries) {
+        break;
+      }
+      const backoff = options.baseDelayMs * Math.pow(2, attempt);
+      const delay = error.retryAfter !== void 0 ? Math.max(error.retryAfter * 1e3, backoff) : backoff;
+      await sleep(delay);
+    }
+  }
+  throw lastError;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/builders/response-mapper.ts
+function mapRawResponse(raw) {
+  return {
+    query: String(raw["query"] ?? ""),
+    results: mapResults(raw["results"]),
+    suggestions: mapStringArray(raw["suggestions"]),
+    corrections: mapStringArray(raw["corrections"]),
+    infobox: raw["infoboxes"] ? mapInfobox(raw["infoboxes"]) : void 0,
+    unresponsiveEngines: mapUnresponsiveEngines(raw["unresponsive_engines"])
+  };
+}
+function mapResults(raw) {
+  if (!Array.isArray(raw)) return [];
+  return raw.map((r) => ({
+    title: String(r["title"] ?? ""),
+    url: String(r["url"] ?? ""),
+    content: String(r["content"] ?? ""),
+    engine: String(r["engine"] ?? ""),
+    publishedDate: optionalString(r["publishedDate"] ?? r["published_date"]),
+    author: optionalString(r["author"]),
+    thumbnail: optionalString(r["thumbnail"] ?? r["thumbnail_src"]),
+    imgSrc: optionalString(r["img_src"]),
+    category: optionalString(r["category"])
+  }));
+}
+function mapInfobox(raw) {
+  if (!Array.isArray(raw) || raw.length === 0) return void 0;
+  const box = raw[0];
+  return {
+    title: String(box["infobox"] ?? ""),
+    imgSrc: optionalString(box["img_src"]),
+    content: optionalString(box["content"]),
+    attributes: mapInfoboxAttributes(box["attributes"]),
+    urls: mapInfoboxUrls(box["urls"]),
+    relatedTopics: mapInfoboxRelatedTopics(box["relatedTopics"])
+  };
+}
+function mapInfoboxAttributes(raw) {
+  if (!Array.isArray(raw)) return [];
+  return raw.map((a) => ({
+    label: String(a["label"] ?? ""),
+    value: String(a["value"] ?? "")
+  }));
+}
+function mapInfoboxUrls(raw) {
+  if (!Array.isArray(raw)) return [];
+  return raw.map((u) => ({
+    url: String(u["url"] ?? ""),
+    title: String(u["title"] ?? "")
+  }));
+}
+function mapInfoboxRelatedTopics(raw) {
+  if (!Array.isArray(raw)) return [];
+  return raw.map((t) => ({
+    name: String(t["name"] ?? ""),
+    suggestions: mapStringArray(
+      Array.isArray(t["suggestions"]) ? t["suggestions"].map(
+        (s) => s["suggestion"] ?? s
+      ) : void 0
+    )
+  }));
+}
+function mapUnresponsiveEngines(raw) {
+  if (!Array.isArray(raw)) return [];
+  return raw.filter((e) => Array.isArray(e) && e.length >= 2).map((e) => [String(e[0]), String(e[1])]);
+}
+function mapStringArray(raw) {
+  if (!Array.isArray(raw)) return [];
+  return raw.map(String);
+}
+function optionalString(value) {
+  if (value === null || value === void 0) return void 0;
+  return String(value);
+}
+
+// src/builders/search.builder.ts
+var SearchBuilder = class {
+  constructor(query, config) {
+    this.executed = false;
+    if (!query.trim()) {
+      throw new SearxngError("Search query must not be empty", 0);
+    }
+    this.config = config;
+    this.params = {
+      q: query,
+      format: "json",
+      language: config.defaultLanguage,
+      categories: config.defaultCategories?.join(","),
+      safesearch: config.defaultSafesearch
+    };
+  }
+  categories(...categories) {
+    this.params.categories = categories.join(",");
+    return this;
+  }
+  engines(...engines) {
+    this.params.engines = engines.join(",");
+    return this;
+  }
+  language(lang) {
+    this.params.language = lang;
+    return this;
+  }
+  page(pageno) {
+    if (pageno < 1) {
+      throw new SearxngError("Page number must be >= 1", 0);
+    }
+    this.params.pageno = pageno;
+    return this;
+  }
+  timeRange(range) {
+    this.params.time_range = range;
+    return this;
+  }
+  safesearch(level) {
+    this.params.safesearch = level;
+    return this;
+  }
+  async execute() {
+    if (this.executed) {
+      throw new SearxngError("Builder already executed", 0);
+    }
+    this.executed = true;
+    const url = this.buildUrl();
+    const { data } = await withRetry(
+      () => fetchJson(url, {
+        timeout: this.config.timeout,
+        headers: this.config.headers
+      }),
+      this.config.retry
+    );
+    return mapRawResponse(data);
+  }
+  buildUrl() {
+    const url = new URL("/search", this.config.baseUrl);
+    for (const [key, value] of Object.entries(this.params)) {
+      if (value !== void 0) {
+        url.searchParams.set(key, String(value));
+      }
+    }
+    return url.toString();
+  }
+};
+
+// src/client.ts
+var SearxngClient = class {
+  constructor(config) {
+    if (!config.baseUrl?.trim()) {
+      throw new SearxngError("baseUrl is required", 0);
+    }
+    if (config.timeout !== void 0 && config.timeout <= 0) {
+      throw new SearxngError("timeout must be > 0", 0);
+    }
+    if (config.retry?.maxRetries !== void 0 && config.retry.maxRetries < 0) {
+      throw new SearxngError("retry.maxRetries must be >= 0", 0);
+    }
+    this.config = {
+      baseUrl: config.baseUrl.replace(/\/+$/, ""),
+      timeout: config.timeout ?? 1e4,
+      retry: {
+        maxRetries: config.retry?.maxRetries ?? 3,
+        baseDelayMs: config.retry?.baseDelayMs ?? 1e3
+      },
+      defaultLanguage: config.defaultLanguage,
+      defaultCategories: config.defaultCategories,
+      defaultSafesearch: config.defaultSafesearch,
+      headers: config.headers ?? {}
+    };
+  }
+  search(query) {
+    return new SearchBuilder(query, this.config);
+  }
+};
+export {
+  SearchBuilder,
+  SearxngClient,
+  SearxngError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/searxng-error.ts","../src/http/fetch.ts","../src/http/retry.ts","../src/builders/response-mapper.ts","../src/builders/search.builder.ts","../src/client.ts"],"sourcesContent":["export class SearxngError extends Error {\n  readonly status: number;\n  readonly retryAfter?: number;\n\n  constructor(message: string, status: number, retryAfter?: number) {\n    super(message);\n    this.name = \"SearxngError\";\n    this.status = status;\n    this.retryAfter = retryAfter;\n  }\n}\n","import { SearxngError } from \"../errors/searxng-error.ts\";\n\nexport interface FetchJsonOptions {\n  timeout: number;\n  headers: Record<string, string>;\n}\n\nexport async function fetchJson<T>(\n  url: string,\n  options: FetchJsonOptions,\n): Promise<{ data: T; response: Response }> {\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), options.timeout);\n\n  try {\n    const response = await fetch(url, {\n      signal: controller.signal,\n      headers: {\n        Accept: \"application/json\",\n        ...options.headers,\n      },\n    });\n\n    clearTimeout(timeoutId);\n\n    if (!response.ok) {\n      const retryAfter = parseRetryAfter(response.headers.get(\"Retry-After\"));\n\n      if (response.status === 403) {\n        throw new SearxngError(\n          \"JSON format not enabled on this instance\",\n          403,\n        );\n      }\n\n      throw new SearxngError(\n        `HTTP ${response.status} ${response.statusText}`,\n        response.status,\n        retryAfter,\n      );\n    }\n\n    let data: T;\n    try {\n      data = (await response.json()) as T;\n    } catch {\n      throw new SearxngError(\"Invalid JSON response\", response.status);\n    }\n\n    return { data, response };\n  } catch (error) {\n    clearTimeout(timeoutId);\n\n    if (error instanceof SearxngError) {\n      throw error;\n    }\n\n    if (error instanceof Error && error.name === \"AbortError\") {\n      throw new SearxngError(\"Request timed out\", 0);\n    }\n\n    throw new SearxngError(\n      `Network error: ${error instanceof Error ? error.message : String(error)}`,\n      0,\n    );\n  }\n}\n\nfunction parseRetryAfter(value: string | null): number | undefined {\n  if (!value) return undefined;\n  const seconds = Number(value);\n  return Number.isFinite(seconds) ? seconds : undefined;\n}\n","import { SearxngError } from \"../errors/searxng-error.ts\";\n\nexport interface RetryOptions {\n  maxRetries: number;\n  baseDelayMs: number;\n}\n\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  options: RetryOptions,\n): Promise<T> {\n  let lastError: SearxngError | undefined;\n\n  for (let attempt = 0; attempt <= options.maxRetries; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      if (!(error instanceof SearxngError) || error.status !== 429) {\n        throw error;\n      }\n\n      lastError = error;\n\n      if (attempt === options.maxRetries) {\n        break;\n      }\n\n      const backoff = options.baseDelayMs * Math.pow(2, attempt);\n      const delay =\n        error.retryAfter !== undefined\n          ? Math.max(error.retryAfter * 1000, backoff)\n          : backoff;\n\n      await sleep(delay);\n    }\n  }\n\n  throw lastError!;\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import type {\n  SearchResponse,\n  SearchResult,\n  Infobox,\n  InfoboxAttribute,\n  InfoboxUrl,\n  InfoboxRelatedTopic,\n  UnresponsiveEngine,\n} from \"../types/search-response.ts\";\n\ntype RawRecord = Record<string, unknown>;\ntype RawResponse = Record<string, unknown>;\n\nexport function mapRawResponse(raw: RawResponse): SearchResponse {\n  return {\n    query: String(raw[\"query\"] ?? \"\"),\n    results: mapResults(raw[\"results\"]),\n    suggestions: mapStringArray(raw[\"suggestions\"]),\n    corrections: mapStringArray(raw[\"corrections\"]),\n    infobox: raw[\"infoboxes\"] ? mapInfobox(raw[\"infoboxes\"]) : undefined,\n    unresponsiveEngines: mapUnresponsiveEngines(raw[\"unresponsive_engines\"]),\n  };\n}\n\nfunction mapResults(raw: unknown): SearchResult[] {\n  if (!Array.isArray(raw)) return [];\n\n  return raw.map((r: RawRecord) => ({\n    title: String(r[\"title\"] ?? \"\"),\n    url: String(r[\"url\"] ?? \"\"),\n    content: String(r[\"content\"] ?? \"\"),\n    engine: String(r[\"engine\"] ?? \"\"),\n    publishedDate: optionalString(r[\"publishedDate\"] ?? r[\"published_date\"]),\n    author: optionalString(r[\"author\"]),\n    thumbnail: optionalString(r[\"thumbnail\"] ?? r[\"thumbnail_src\"]),\n    imgSrc: optionalString(r[\"img_src\"]),\n    category: optionalString(r[\"category\"]),\n  }));\n}\n\nfunction mapInfobox(raw: unknown): Infobox | undefined {\n  if (!Array.isArray(raw) || raw.length === 0) return undefined;\n\n  const box = raw[0] as RawRecord;\n  return {\n    title: String(box[\"infobox\"] ?? \"\"),\n    imgSrc: optionalString(box[\"img_src\"]),\n    content: optionalString(box[\"content\"]),\n    attributes: mapInfoboxAttributes(box[\"attributes\"]),\n    urls: mapInfoboxUrls(box[\"urls\"]),\n    relatedTopics: mapInfoboxRelatedTopics(box[\"relatedTopics\"]),\n  };\n}\n\nfunction mapInfoboxAttributes(raw: unknown): InfoboxAttribute[] {\n  if (!Array.isArray(raw)) return [];\n  return raw.map((a: Record<string, unknown>) => ({\n    label: String(a[\"label\"] ?? \"\"),\n    value: String(a[\"value\"] ?? \"\"),\n  }));\n}\n\nfunction mapInfoboxUrls(raw: unknown): InfoboxUrl[] {\n  if (!Array.isArray(raw)) return [];\n  return raw.map((u: Record<string, unknown>) => ({\n    url: String(u[\"url\"] ?? \"\"),\n    title: String(u[\"title\"] ?? \"\"),\n  }));\n}\n\nfunction mapInfoboxRelatedTopics(raw: unknown): InfoboxRelatedTopic[] {\n  if (!Array.isArray(raw)) return [];\n  return raw.map((t: Record<string, unknown>) => ({\n    name: String(t[\"name\"] ?? \"\"),\n    suggestions: mapStringArray(\n      Array.isArray(t[\"suggestions\"])\n        ? t[\"suggestions\"].map(\n            (s: Record<string, unknown>) => s[\"suggestion\"] ?? s,\n          )\n        : undefined,\n    ),\n  }));\n}\n\nfunction mapUnresponsiveEngines(raw: unknown): UnresponsiveEngine[] {\n  if (!Array.isArray(raw)) return [];\n  return raw\n    .filter((e): e is [unknown, unknown] => Array.isArray(e) && e.length >= 2)\n    .map((e) => [String(e[0]), String(e[1])] as UnresponsiveEngine);\n}\n\nfunction mapStringArray(raw: unknown): string[] {\n  if (!Array.isArray(raw)) return [];\n  return raw.map(String);\n}\n\nfunction optionalString(value: unknown): string | undefined {\n  if (value === null || value === undefined) return undefined;\n  return String(value);\n}\n","import type { SafeSearch, ResolvedConfig } from \"../types/config.ts\";\nimport type { SearchParams, TimeRange } from \"../types/search-params.ts\";\nimport type { SearchResponse } from \"../types/search-response.ts\";\nimport { SearxngError } from \"../errors/searxng-error.ts\";\nimport { fetchJson } from \"../http/fetch.ts\";\nimport { withRetry } from \"../http/retry.ts\";\nimport { mapRawResponse } from \"./response-mapper.ts\";\n\nexport class SearchBuilder {\n  private readonly params: SearchParams;\n  private readonly config: ResolvedConfig;\n  private executed = false;\n\n  constructor(query: string, config: ResolvedConfig) {\n    if (!query.trim()) {\n      throw new SearxngError(\"Search query must not be empty\", 0);\n    }\n\n    this.config = config;\n    this.params = {\n      q: query,\n      format: \"json\",\n      language: config.defaultLanguage,\n      categories: config.defaultCategories?.join(\",\"),\n      safesearch: config.defaultSafesearch,\n    };\n  }\n\n  categories(...categories: string[]): this {\n    this.params.categories = categories.join(\",\");\n    return this;\n  }\n\n  engines(...engines: string[]): this {\n    this.params.engines = engines.join(\",\");\n    return this;\n  }\n\n  language(lang: string): this {\n    this.params.language = lang;\n    return this;\n  }\n\n  page(pageno: number): this {\n    if (pageno < 1) {\n      throw new SearxngError(\"Page number must be >= 1\", 0);\n    }\n    this.params.pageno = pageno;\n    return this;\n  }\n\n  timeRange(range: TimeRange): this {\n    this.params.time_range = range;\n    return this;\n  }\n\n  safesearch(level: SafeSearch): this {\n    this.params.safesearch = level;\n    return this;\n  }\n\n  async execute(): Promise<SearchResponse> {\n    if (this.executed) {\n      throw new SearxngError(\"Builder already executed\", 0);\n    }\n    this.executed = true;\n\n    const url = this.buildUrl();\n\n    const { data } = await withRetry(\n      () =>\n        fetchJson<Record<string, unknown>>(url, {\n          timeout: this.config.timeout,\n          headers: this.config.headers,\n        }),\n      this.config.retry,\n    );\n\n    return mapRawResponse(data);\n  }\n\n  private buildUrl(): string {\n    const url = new URL(\"/search\", this.config.baseUrl);\n\n    for (const [key, value] of Object.entries(this.params)) {\n      if (value !== undefined) {\n        url.searchParams.set(key, String(value));\n      }\n    }\n\n    return url.toString();\n  }\n}\n","import type { SearxngClientConfig, ResolvedConfig } from \"./types/config.ts\";\nimport { SearxngError } from \"./errors/searxng-error.ts\";\nimport { SearchBuilder } from \"./builders/search.builder.ts\";\n\nexport class SearxngClient {\n  private readonly config: ResolvedConfig;\n\n  constructor(config: SearxngClientConfig) {\n    if (!config.baseUrl?.trim()) {\n      throw new SearxngError(\"baseUrl is required\", 0);\n    }\n\n    if (config.timeout !== undefined && config.timeout <= 0) {\n      throw new SearxngError(\"timeout must be > 0\", 0);\n    }\n\n    if (\n      config.retry?.maxRetries !== undefined &&\n      config.retry.maxRetries < 0\n    ) {\n      throw new SearxngError(\"retry.maxRetries must be >= 0\", 0);\n    }\n\n    this.config = {\n      baseUrl: config.baseUrl.replace(/\\/+$/, \"\"),\n      timeout: config.timeout ?? 10_000,\n      retry: {\n        maxRetries: config.retry?.maxRetries ?? 3,\n        baseDelayMs: config.retry?.baseDelayMs ?? 1_000,\n      },\n      defaultLanguage: config.defaultLanguage,\n      defaultCategories: config.defaultCategories,\n      defaultSafesearch: config.defaultSafesearch,\n      headers: config.headers ?? {},\n    };\n  }\n\n  search(query: string): SearchBuilder {\n    return new SearchBuilder(query, this.config);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "searxng-sdk",
+  "version": "0.1.0",
+  "description": "Zero-dependency TypeScript SDK for the SearXNG search API with fluent builder pattern",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean --out-dir dist",
+    "dev": "tsup --watch",
+    "test": "bun test",
+    "check": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "searxng",
+    "searx",
+    "search",
+    "sdk",
+    "metasearch",
+    "privacy"
+  ],
+  "author": "intMeric",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/intMeric/searxng-sdk"
+  },
+  "homepage": "https://github.com/intMeric/searxng-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/intMeric/searxng-sdk/issues"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.9",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.0"
+  }
+}