@n8n/ai-utilities 0.17.0 → 0.18.0

package/dist/esm/web-search/brave-search.d.ts

@@ -0,0 +1,8 @@
+import type { WebSearchOptions, WebSearchResponse } from './types';
+export interface BraveSearchOptions extends WebSearchOptions {
+    proxyConfig?: {
+        apiUrl: string;
+        getAuthHeaders: () => Promise<Record<string, string>>;
+    };
+}
+export declare function braveSearch(apiKey: string, query: string, options: BraveSearchOptions): Promise<WebSearchResponse>;

package/dist/esm/web-search/brave-search.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.braveSearch = braveSearch;
+const BRAVE_SEARCH_PATH = '/res/v1/web/search';
+const BRAVE_SEARCH_URL = `https://api.search.brave.com${BRAVE_SEARCH_PATH}`;
+async function braveSearch(apiKey, query, options) {
+    let searchQuery = query;
+    if (options.includeDomains?.length) {
+        const siteFilter = options.includeDomains.map((d) => `site:${d}`).join(' OR ');
+        searchQuery = `${query} (${siteFilter})`;
+    }
+    if (options.excludeDomains?.length) {
+        searchQuery += options.excludeDomains.map((d) => ` -site:${d}`).join('');
+    }
+    const params = new URLSearchParams({
+        q: searchQuery,
+        count: String(options.maxResults ?? 5),
+    });
+    const proxyConfig = options.proxyConfig;
+    const baseUrl = proxyConfig ? `${proxyConfig.apiUrl}${BRAVE_SEARCH_PATH}` : BRAVE_SEARCH_URL;
+    const proxyHeaders = proxyConfig ? await proxyConfig.getAuthHeaders() : undefined;
+    const headers = {
+        Accept: 'application/json',
+        'Accept-Encoding': 'gzip',
+        ...(proxyHeaders ?? { 'X-Subscription-Token': apiKey }),
+    };
+    const response = await fetch(`${baseUrl}?${params}`, { headers });
+    if (!response.ok) {
+        throw new Error(`Brave search failed: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return {
+        query,
+        results: (data.web?.results ?? []).map((r) => ({
+            title: r.title,
+            url: r.url,
+            snippet: r.description,
+            ...(r.age ? { publishedDate: r.age } : {}),
+        })),
+    };
+}
+//# sourceMappingURL=brave-search.js.map

package/dist/esm/web-search/brave-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brave-search.js","sourceRoot":"","sources":["../../../src/web-search/brave-search.ts"],"names":[],"mappings":";;AAgCA,kCA+CC;AA7ED,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAC/C,MAAM,gBAAgB,GAAG,+BAA+B,iBAAiB,EAAE,CAAC;AA6BrE,KAAK,UAAU,WAAW,CAChC,MAAc,EACd,KAAa,EACb,OAA2B;IAE3B,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,IAAI,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/E,WAAW,GAAG,GAAG,KAAK,KAAK,UAAU,GAAG,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;QACpC,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QAClC,CAAC,EAAE,WAAW;QACd,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;KACtC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACxC,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC7F,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,MAAM,OAAO,GAA2B;QACvC,MAAM,EAAE,kBAAkB;QAC1B,iBAAiB,EAAE,MAAM;QACzB,GAAG,CAAC,YAAY,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,CAAC;KACvD,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,IAAI,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAElE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA2B,CAAC;IAE/D,OAAO;QACN,KAAK;QACL,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9C,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,OAAO,EAAE,CAAC,CAAC,WAAW;YACtB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAC,CAAC;KACH,CAAC;AACH,CAAC"}

package/dist/esm/web-search/index.d.ts

@@ -0,0 +1,3 @@
+export { braveSearch, type BraveSearchOptions } from './brave-search';
+export { searxngSearch } from './searxng-search';
+export type { WebSearchOptions, WebSearchResponse, WebSearchResult } from './types';

package/dist/esm/web-search/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searxngSearch = exports.braveSearch = void 0;
+var brave_search_1 = require("./brave-search");
+Object.defineProperty(exports, "braveSearch", { enumerable: true, get: function () { return brave_search_1.braveSearch; } });
+var searxng_search_1 = require("./searxng-search");
+Object.defineProperty(exports, "searxngSearch", { enumerable: true, get: function () { return searxng_search_1.searxngSearch; } });
+//# sourceMappingURL=index.js.map

package/dist/esm/web-search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/web-search/index.ts"],"names":[],"mappings":";;;AAAA,+CAAsE;AAA7D,2GAAA,WAAW,OAAA;AACpB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA"}

package/dist/esm/web-search/searxng-search.d.ts

@@ -0,0 +1,2 @@
+import type { WebSearchOptions, WebSearchResponse } from './types';
+export declare function searxngSearch(baseUrl: string, query: string, options: WebSearchOptions): Promise<WebSearchResponse>;

package/dist/esm/web-search/searxng-search.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searxngSearch = searxngSearch;
+async function searxngSearch(baseUrl, query, options) {
+    let searchQuery = query;
+    if (options.includeDomains?.length) {
+        const siteFilter = options.includeDomains.map((d) => `site:${d}`).join(' OR ');
+        searchQuery = `${query} (${siteFilter})`;
+    }
+    if (options.excludeDomains?.length) {
+        searchQuery += options.excludeDomains.map((d) => ` -site:${d}`).join('');
+    }
+    const normalizedUrl = baseUrl.replace(/\/+$/, '');
+    const params = new URLSearchParams({
+        q: searchQuery,
+        format: 'json',
+        pageno: '1',
+    });
+    const response = await fetch(`${normalizedUrl}/search?${params}`, {
+        headers: {
+            Accept: 'application/json',
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`SearXNG search failed: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    const maxResults = options.maxResults ?? 5;
+    return {
+        query,
+        results: (data.results ?? []).slice(0, maxResults).map((r) => ({
+            title: r.title,
+            url: r.url,
+            snippet: r.content,
+            ...(r.publishedDate ? { publishedDate: r.publishedDate } : {}),
+        })),
+    };
+}
+//# sourceMappingURL=searxng-search.js.map

package/dist/esm/web-search/searxng-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searxng-search.js","sourceRoot":"","sources":["../../../src/web-search/searxng-search.ts"],"names":[],"mappings":";;AAqBA,sCA8CC;AA9CM,KAAK,UAAU,aAAa,CAClC,OAAe,EACf,KAAa,EACb,OAAyB;IAEzB,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,IAAI,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/E,WAAW,GAAG,GAAG,KAAK,KAAK,UAAU,GAAG,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;QACpC,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QAClC,CAAC,EAAE,WAAW;QACd,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,GAAG;KACX,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,aAAa,WAAW,MAAM,EAAE,EAAE;QACjE,OAAO,EAAE;YACR,MAAM,EAAE,kBAAkB;SAC1B;KACD,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAuB,CAAC;IAC3D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAE3C,OAAO;QACN,KAAK;QACL,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9D,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC,CAAC;KACH,CAAC;AACH,CAAC"}

package/dist/esm/web-search/types.d.ts

@@ -0,0 +1,15 @@
+export interface WebSearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+    publishedDate?: string;
+}
+export interface WebSearchResponse {
+    query: string;
+    results: WebSearchResult[];
+}
+export interface WebSearchOptions {
+    maxResults?: number;
+    includeDomains?: string[];
+    excludeDomains?: string[];
+}

package/dist/esm/web-search/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/esm/web-search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/web-search/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@n8n/ai-utilities",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Utilities for building AI nodes in n8n",
   "types": "dist/esm/index.d.ts",
   "module": "dist/esm/index.js",
@@ -18,6 +18,9 @@
       ],
       "http-proxy-agent": [
         "dist/esm/utils/http-proxy-agent.d.ts"
+      ],
+      "web-search": [
+        "dist/esm/web-search/index.d.ts"
       ]
     }
   },
@@ -47,6 +50,11 @@
       "import": "./dist/esm/utils/http-proxy-agent.js",
       "require": "./dist/cjs/utils/http-proxy-agent.js"
     },
+    "./web-search": {
+      "types": "./dist/esm/web-search/index.d.ts",
+      "import": "./dist/esm/web-search/index.js",
+      "require": "./dist/cjs/web-search/index.js"
+    },
     "./*": "./*"
   },
   "files": [
@@ -60,7 +68,7 @@
     "@types/mime-types": "3.0.1",
     "tsx": "^4.19.3",
     "axios": "1.16.1",
-    "n8n-workflow": "2.23.0"
+    "n8n-workflow": "2.24.0"
   },
   "dependencies": {
     "zod": "3.25.67",
@@ -77,9 +85,9 @@
     "pdf-parse": "2.4.5",
     "proxy-from-env": "^1.1.0",
     "undici": "^6.21.0",
-    "@n8n/config": "2.22.0",
-    "@n8n/typescript-config": "1.4.0",
-    "@n8n/utils": "1.32.0"
+    "@n8n/config": "2.23.0",
+    "@n8n/utils": "1.33.0",
+    "@n8n/typescript-config": "1.4.0"
   },
   "peerDependencies": {
     "n8n-workflow": "*"