utilitas 1998.2.21 → 1998.2.23

package/lib/manifest.mjs

@@ -1,7 +1,7 @@
 const manifest = {
     "name": "utilitas",
     "description": "Just another common utility for JavaScript.",
-    "version": "1998.2.21",
+    "version": "1998.2.23",
     "private": false,
     "homepage": "https://github.com/Leask/utilitas",
     "main": "index.mjs",

package/lib/shot.mjs

@@ -1,8 +1,8 @@
-import { distillHtml } from './web.mjs';
 import { fileTypeFromBuffer } from 'file-type';
-import { join } from 'path';
 import { promises as fs } from 'fs';
+import { join } from 'path';
 import { sha256 } from './encryption.mjs';
+import { distillHtml } from './web.mjs';
 
 import {
     ensureString, extract, ignoreErrFunc, inBrowser, parseJson, parseVersion,
@@ -148,6 +148,62 @@ const get = async (url, options) => {
     };
 };
 
+const search = async (query, options) => {
+    assert(query, 'Query is required.');
+    const [GOOGLE, DUCKDUCKGO] = ['GOOGLE', 'DUCKDUCKGO'];
+    const provider = ensureString(options?.provider, { case: 'UP' }) || DUCKDUCKGO;
+    let url, parser;
+    switch (provider) {
+        case GOOGLE:
+            assert(options?.apiKey, 'API key is required.');
+            assert(options?.cx, 'CX is required.');
+            url = `https://www.googleapis.com/customsearch/v1?key=${options.apiKey}&cx=${options.cx}&q=${encodeURIComponent(query)}`;
+            break;
+        case DUCKDUCKGO:
+            url = `https://api.duckduckgo.com/?q=${encodeURIComponent(query)}&format=json&skip_disambig=1`;
+            parser = x => x.FirstURL ? {
+                title: x.FirstURL.replace(/^.*\/([^\/]*)$/, '$1').replace(/_/g, ' '),
+                link: x.FirstURL, snippet: x.Text,
+                image: `https://duckduckgo.com${x.Icon.URL}`, source: null,
+            } : null;
+            break;
+        default:
+            throwError(`Invalid provider: ${provider}.`);
+    }
+    const resp = await get(url, { encode: _JSON, ...options || {} });
+    let result = [];
+    if (options?.raw) {
+        result = resp.content;
+    } else if (provider === GOOGLE) {
+        result.push(...resp?.content?.items.map(x => ({
+            title: x.title, link: x.link, snippet: x.snippet,
+            image: x.pagemap?.cse_image?.[0]?.src || null,
+        })));
+    } else if (provider === DUCKDUCKGO) {
+        const cnt = resp?.content;
+        if (cnt?.Abstract) {
+            result.push({
+                title: cnt?.Heading + (cnt?.Entity ? ` (${cnt.Entity})` : ''),
+                link: cnt?.AbstractURL, snippet: cnt?.AbstractText,
+                image: cnt?.Image ? `https://duckduckgo.com${cnt.Image}` : null,
+                source: cnt?.AbstractSource,
+            });
+            if (cnt?.Results) {
+                result.push(...cnt.Results.map(x => ({
+                    title: x.Text, link: x.FirstURL, snippet: null,
+                    image: x.Icon ? `https://duckduckgo.com${x.Icon.URL}` : null,
+                    source: null,
+                })));
+            }
+        } else if (cnt?.RelatedTopics?.[0] && !options?.no_recurse) {
+            result = await search(cnt.RelatedTopics[0].FirstURL.replace(
+                /^.*\/([^\/]*)$/, '$1'
+            ).replace(/_/g, ' '), { ...options, no_recurse: true });
+        }
+    }
+    return result;
+};
+
 export default get;
 export {
     checkVersion,
@@ -157,4 +213,5 @@ export {
     getJson,
     getParsedHtml,
     getVersionOnNpm,
+    search
 };

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "utilitas",
     "description": "Just another common utility for JavaScript.",
-    "version": "1998.2.21",
+    "version": "1998.2.23",
     "private": false,
     "homepage": "https://github.com/Leask/utilitas",
     "main": "index.mjs",