sxng-cli 1.0.1

package/README.md

@@ -0,0 +1,85 @@
+# SearXNG CLI
+
+A command-line interface for searching with SearXNG, a privacy-respecting meta search engine.
+
+## Installation
+
+```bash
+npm install -g sxng-cli
+# or
+pnpm add -g sxng-cli
+# or
+yarn global add sxng-cli
+```
+
+## Quick Start
+
+1. Set up a SearXNG server:
+```bash
+docker run -d --name searxng -p 8080:8080 searxng/searxng
+```
+
+2. Create a configuration file:
+```bash
+cp searxng.config.example.json searxng.config.json
+# Edit the file with your settings
+```
+
+3. Run a search:
+```bash
+sxng "your search query"
+```
+
+## Configuration
+
+Configuration can be provided via:
+1. Environment variables (highest priority)
+2. Config file: `./searxng.config.json`
+3. Default values (lowest priority)
+
+See `searxng.config.example.json` for an example configuration.
+
+## Usage
+
+```bash
+# Simple search
+sxng "TypeScript tutorial"
+
+# Limit results
+sxng "TypeScript tutorial" --limit 5
+
+# Use specific engines
+sxng --engines google,github "react hooks"
+
+# Search in specific categories
+sxng --categories it,science "machine learning"
+
+# Recent results only
+sxng --time week "latest news"
+
+# Output as CSV
+sxng "docker tutorial" --format csv > results.csv
+
+# Check server health
+sxng --health
+
+# List available engines
+sxng --engines-list
+
+# List available categories
+sxng --categories-list
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `SEARXNG_BASE_URL` | SearXNG server URL | `http://localhost:8080` |
+| `SEARXNG_DEFAULT_LIMIT` | Default result limit | `10` |
+| `SEARXNG_TIMEOUT` | Request timeout in ms | `10000` |
+| `SEARXNG_USE_PROXY` | Use proxy (`true`/`false`) | `false` |
+| `SEARXNG_PROXY_URL` | Proxy URL | (none) |
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * SearXNG CLI - Configuration
+ *
+ * Configuration priority (highest to lowest):
+ * 1. Environment variables
+ * 2. Config file (./sxng.config.json)
+ * 3. Default values (localhost only)
+ */
+export interface SearXNGConfig {
+    baseUrl: string;
+    defaultEngine: string;
+    allowedEngines: string[];
+    defaultLimit: number;
+    useProxy: boolean;
+    proxyUrl: string;
+    timeout: number;
+}
+export declare const config: SearXNGConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACnB;AAiGD,eAAO,MAAM,MAAM,EAAE,aAA6B,CAAC"}

package/dist/config.js

@@ -0,0 +1,102 @@
+/**
+ * SearXNG CLI - Configuration
+ *
+ * Configuration priority (highest to lowest):
+ * 1. Environment variables
+ * 2. Config file (./sxng.config.json)
+ * 3. Default values (localhost only)
+ */
+import { readFileSync, existsSync } from 'fs';
+const DEFAULT_CONFIG = {
+    baseUrl: '',
+    defaultEngine: '',
+    allowedEngines: [],
+    defaultLimit: 10,
+    useProxy: false,
+    proxyUrl: '',
+    timeout: 10000
+};
+function readOptionalEnv(name, defaultValue) {
+    const value = process.env[name]?.trim();
+    return value ? value : defaultValue;
+}
+function readIntEnv(name, defaultValue) {
+    const value = process.env[name];
+    if (!value)
+        return defaultValue;
+    const parsed = parseInt(value, 10);
+    return Number.isFinite(parsed) ? parsed : defaultValue;
+}
+function readBoolEnv(name, defaultValue) {
+    const value = process.env[name];
+    if (value === undefined)
+        return defaultValue;
+    return value === 'true' || value === '1';
+}
+function findConfigFile() {
+    const localConfig = './sxng.config.json';
+    if (existsSync(localConfig)) {
+        return localConfig;
+    }
+    return null;
+}
+function loadConfigFile() {
+    const configPath = findConfigFile();
+    if (!configPath) {
+        return {};
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+function mergeConfig() {
+    const config = { ...DEFAULT_CONFIG };
+    const fileConfig = loadConfigFile();
+    if (fileConfig.baseUrl !== undefined)
+        config.baseUrl = fileConfig.baseUrl;
+    if (fileConfig.defaultEngine !== undefined)
+        config.defaultEngine = fileConfig.defaultEngine;
+    if (fileConfig.allowedEngines !== undefined)
+        config.allowedEngines = fileConfig.allowedEngines;
+    if (fileConfig.defaultLimit !== undefined)
+        config.defaultLimit = fileConfig.defaultLimit;
+    if (fileConfig.useProxy !== undefined)
+        config.useProxy = fileConfig.useProxy;
+    if (fileConfig.proxyUrl !== undefined)
+        config.proxyUrl = fileConfig.proxyUrl;
+    if (fileConfig.timeout !== undefined)
+        config.timeout = fileConfig.timeout;
+    const envBaseUrl = readOptionalEnv('SEARXNG_BASE_URL');
+    if (envBaseUrl)
+        config.baseUrl = envBaseUrl;
+    const envDefaultEngine = readOptionalEnv('SEARXNG_DEFAULT_ENGINE');
+    if (envDefaultEngine !== undefined)
+        config.defaultEngine = envDefaultEngine;
+    const envAllowedEngines = process.env.SEARXNG_ALLOWED_ENGINES;
+    if (envAllowedEngines !== undefined) {
+        config.allowedEngines = envAllowedEngines.split(',').map(e => e.trim()).filter(Boolean);
+    }
+    const envDefaultLimit = process.env.SEARXNG_DEFAULT_LIMIT;
+    if (envDefaultLimit !== undefined) {
+        config.defaultLimit = readIntEnv('SEARXNG_DEFAULT_LIMIT', config.defaultLimit);
+    }
+    const envUseProxy = process.env.SEARXNG_USE_PROXY;
+    if (envUseProxy !== undefined) {
+        config.useProxy = readBoolEnv('SEARXNG_USE_PROXY', config.useProxy);
+    }
+    const envProxyUrl = readOptionalEnv('SEARXNG_PROXY_URL');
+    if (envProxyUrl)
+        config.proxyUrl = envProxyUrl;
+    const envTimeout = process.env.SEARXNG_TIMEOUT;
+    if (envTimeout !== undefined) {
+        config.timeout = readIntEnv('SEARXNG_TIMEOUT', config.timeout);
+    }
+    return config;
+}
+export const config = mergeConfig();
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * SearXNG CLI - Main Entry Point
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG"}

package/dist/index.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * SearXNG CLI - Main Entry Point
+ */
+import { runCli } from './runCli.js';
+import { SearXNGService } from './service.js';
+async function main() {
+    const args = process.argv.slice(2);
+    const service = new SearXNGService();
+    try {
+        const exitCode = await runCli(args, service);
+        if (exitCode !== null) {
+            process.exit(exitCode);
+        }
+    }
+    catch (error) {
+        console.error(`Fatal error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,KAAK,UAAU,IAAI;IACf,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;IAErC,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,gBAAgB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SearXNG CLI - Interactive Configuration Setup
+ */
+export interface SearXNGConfig {
+    baseUrl: string;
+    defaultEngine: string;
+    allowedEngines: string[];
+    defaultLimit: number;
+    useProxy: boolean;
+    proxyUrl: string;
+    timeout: number;
+}
+export declare function initConfig(): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACnB;AAsDD,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAiGlD"}

package/dist/init.js

@@ -0,0 +1,121 @@
+/**
+ * SearXNG CLI - Interactive Configuration Setup
+ */
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { resolve } from 'path';
+import readline from 'readline';
+const DEFAULT_CONFIG = {
+    baseUrl: 'http://localhost:8080',
+    defaultEngine: '',
+    allowedEngines: [],
+    defaultLimit: 10,
+    useProxy: false,
+    proxyUrl: '',
+    timeout: 10000
+};
+class ConfiguratorInterface {
+    rl;
+    constructor() {
+        this.rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+    }
+    async question(prompt, defaultValue) {
+        return new Promise((resolve) => {
+            const displayPrompt = defaultValue ? `${prompt} [${defaultValue}]: ` : `${prompt}: `;
+            this.rl.question(displayPrompt, (answer) => {
+                resolve(answer.trim() || defaultValue || '');
+            });
+        });
+    }
+    async confirm(prompt, defaultValue = true) {
+        const answer = await this.question(`${prompt} (${defaultValue ? 'Y/n' : 'y/N'})`, defaultValue ? 'y' : 'n');
+        return answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes';
+    }
+    async multilineInput(prompt) {
+        console.log(prompt);
+        console.log('(Enter items separated by commas, or press Enter to skip)');
+        const input = await this.question('> ');
+        return input
+            .split(',')
+            .map(item => item.trim())
+            .filter(item => item.length > 0);
+    }
+    close() {
+        this.rl.close();
+    }
+}
+export async function initConfig() {
+    const configPath = resolve('./sxng.config.json');
+    const configurator = new ConfiguratorInterface();
+    console.log('\n📝 SearXNG CLI Configuration Setup\n');
+    console.log('This will guide you through setting up your SearXNG configuration.\n');
+    let config = { ...DEFAULT_CONFIG };
+    // Load existing config if available
+    if (existsSync(configPath)) {
+        const useExisting = await configurator.confirm('Found existing config. Use it as base');
+        if (useExisting) {
+            try {
+                const existing = JSON.parse(readFileSync(configPath, 'utf-8'));
+                config = { ...DEFAULT_CONFIG, ...existing };
+                console.log('✓ Loaded existing configuration\n');
+            }
+            catch (error) {
+                console.log('⚠ Failed to parse existing config, starting fresh\n');
+            }
+        }
+    }
+    // Configure baseUrl
+    console.log('--- SearXNG Server Configuration ---');
+    config.baseUrl = await configurator.question('SearXNG server URL', config.baseUrl);
+    // Configure default engine
+    const engineChoice = await configurator.question('Default search engine (leave blank for none)', config.defaultEngine);
+    config.defaultEngine = engineChoice;
+    // Configure allowed engines
+    const allowedEnginesInput = await configurator.multilineInput('Allowed engines (leave blank to allow all)');
+    if (allowedEnginesInput.length > 0) {
+        config.allowedEngines = allowedEnginesInput;
+    }
+    // Configure default limit
+    console.log('\n--- Result Settings ---');
+    const limitStr = await configurator.question('Default result limit', String(config.defaultLimit));
+    config.defaultLimit = Math.max(1, parseInt(limitStr, 10) || 10);
+    // Configure timeout
+    const timeoutStr = await configurator.question('Request timeout (milliseconds)', String(config.timeout));
+    config.timeout = Math.max(1000, parseInt(timeoutStr, 10) || 10000);
+    // Configure proxy
+    console.log('\n--- Proxy Configuration ---');
+    const useProxy = await configurator.confirm('Use HTTP proxy', config.useProxy);
+    config.useProxy = useProxy;
+    if (useProxy) {
+        config.proxyUrl = await configurator.question('Proxy URL', config.proxyUrl);
+    }
+    else {
+        config.proxyUrl = '';
+    }
+    // Review and confirm
+    console.log('\n--- Configuration Summary ---');
+    console.log(JSON.stringify(config, null, 2));
+    const confirm = await configurator.confirm('\nSave this configuration');
+    configurator.close();
+    if (confirm) {
+        try {
+            writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+            console.log(`\n✓ Configuration saved to ${configPath}`);
+            console.log('\n✨ Setup complete! You can now use sxng to search.\n');
+            console.log('Try it out:');
+            console.log('  sxng "TypeScript tutorial"\n');
+            return 0;
+        }
+        catch (error) {
+            console.error(`\n✗ Failed to save configuration: ${error instanceof Error ? error.message : String(error)}`);
+            return 1;
+        }
+    }
+    else {
+        console.log('\n❌ Configuration not saved.');
+        return 1;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}

package/dist/protocol.d.ts

@@ -0,0 +1,23 @@
+/**
+ * SearXNG CLI - Protocol Definitions
+ * Standardized envelope format for CLI communication
+ */
+export type CliEnvelopeError = {
+    code: string;
+    message: string;
+    retryable: boolean;
+    details?: Record<string, unknown>;
+};
+export type CliEnvelope<T> = {
+    status: 'ok' | 'error';
+    data: T | null;
+    error: CliEnvelopeError | null;
+    hint: string | null;
+};
+export declare function createSuccessEnvelope<T>(data: T): CliEnvelope<T>;
+export declare function createErrorEnvelope(code: string, message: string, options?: {
+    retryable?: boolean;
+    details?: Record<string, unknown>;
+    hint?: string | null;
+}): CliEnvelope<null>;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IACzB,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAOhE;AAED,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACL,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB,GACP,WAAW,CAAC,IAAI,CAAC,CAYnB"}

package/dist/protocol.js

@@ -0,0 +1,26 @@
+/**
+ * SearXNG CLI - Protocol Definitions
+ * Standardized envelope format for CLI communication
+ */
+export function createSuccessEnvelope(data) {
+    return {
+        status: 'ok',
+        data,
+        error: null,
+        hint: null
+    };
+}
+export function createErrorEnvelope(code, message, options = {}) {
+    return {
+        status: 'error',
+        data: null,
+        error: {
+            code,
+            message,
+            retryable: options.retryable ?? false,
+            details: options.details
+        },
+        hint: options.hint ?? null
+    };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,MAAM,UAAU,qBAAqB,CAAI,IAAO;IAC5C,OAAO;QACH,MAAM,EAAE,IAAI;QACZ,IAAI;QACJ,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,IAAI;KACb,CAAC;AACN,CAAC;AAED,MAAM,UAAU,mBAAmB,CAC/B,IAAY,EACZ,OAAe,EACf,UAII,EAAE;IAEN,OAAO;QACH,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,IAAI;QACV,KAAK,EAAE;YACH,IAAI;YACJ,OAAO;YACP,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;YACrC,OAAO,EAAE,OAAO,CAAC,OAAO;SAC3B;QACD,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;KAC7B,CAAC;AACN,CAAC"}

package/dist/runCli.d.ts

@@ -0,0 +1,6 @@
+/**
+ * SearXNG CLI - CLI Runner
+ */
+import { SearXNGService } from './service.js';
+export declare function runCli(args: string[], service: SearXNGService): Promise<number | null>;
+//# sourceMappingURL=runCli.d.ts.map

package/dist/runCli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCli.d.ts","sourceRoot":"","sources":["../src/runCli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAiB,MAAM,cAAc,CAAC;AAgM7D,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsJ5F"}

package/dist/runCli.js

@@ -0,0 +1,276 @@
+/**
+ * SearXNG CLI - CLI Runner
+ */
+import { createSuccessEnvelope, createErrorEnvelope } from './protocol.js';
+import { config } from './config.js';
+import { initConfig } from './init.js';
+const HELP_TEXT = `SearXNG CLI - Web Search Tool
+
+Usage:
+  sxng <query> [options]
+  sxng init
+  sxng --engines <engine1,engine2> <query>
+  sxng --categories <category> <query>
+  sxng --health
+
+Commands:
+  init                         Interactive configuration setup
+  <query>                      Perform a web search with the given query
+
+Options:
+  -e, --engines <engines>      Comma-separated list of search engines
+  -c, --categories <cats>      Comma-separated list of categories
+  -l, --limit <n>              Maximum number of results (default: ${config.defaultLimit})
+  -p, --page <n>               Page number for pagination
+  --lang <code>                Language code (e.g., en, zh, ja)
+  --time <range>               Time range: day, week, month, year, all
+  -f, --format <fmt>           Output format: json, csv, html (default: json)
+  --engines-list               List available search engines
+  --categories-list            List available categories
+  --health                     Check SearXNG server health
+  -h, --help                   Show this help message
+
+Examples:
+  sxng init
+  sxng "TypeScript tutorial"
+  sxng --engines google,github "react hooks"
+  sxng --categories it,science "machine learning"
+  sxng --limit 5 --time week "latest news"
+
+Environment Variables:
+  SEARXNG_BASE_URL             SearXNG server URL
+  SEARXNG_DEFAULT_ENGINE       Default search engine
+  SEARXNG_ALLOWED_ENGINES      Comma-separated allowed engines
+  SEARXNG_DEFAULT_LIMIT        Default result limit
+  SEARXNG_USE_PROXY            Use proxy (true/false)
+  SEARXNG_PROXY_URL            Proxy URL
+  SEARXNG_TIMEOUT              Request timeout in ms
+`;
+function parseArgs(args) {
+    const options = {
+        init: false,
+        enginesList: false,
+        categoriesList: false,
+        health: false,
+        help: false
+    };
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '-h':
+            case '--help':
+                options.help = true;
+                break;
+            case 'init':
+                options.init = true;
+                break;
+            case '-e':
+            case '--engines':
+                options.engines = args[++i]?.split(',').map(e => e.trim()).filter(Boolean);
+                break;
+            case '-c':
+            case '--categories':
+                options.categories = args[++i]?.split(',').map(c => c.trim()).filter(Boolean);
+                break;
+            case '-l':
+            case '--limit':
+                options.limit = parseInt(args[++i], 10);
+                break;
+            case '-p':
+            case '--page':
+                options.page = parseInt(args[++i], 10);
+                break;
+            case '--lang':
+                options.language = args[++i];
+                break;
+            case '--time':
+                const timeVal = args[++i];
+                if (['day', 'week', 'month', 'year', 'all'].includes(timeVal)) {
+                    options.timeRange = timeVal;
+                }
+                break;
+            case '-f':
+            case '--format':
+                const fmt = args[++i];
+                if (['json', 'csv', 'html'].includes(fmt)) {
+                    options.format = fmt;
+                }
+                break;
+            case '--engines-list':
+                options.enginesList = true;
+                break;
+            case '--categories-list':
+                options.categoriesList = true;
+                break;
+            case '--health':
+                options.health = true;
+                break;
+            default:
+                if (!arg.startsWith('-')) {
+                    positional.push(arg);
+                }
+                break;
+        }
+    }
+    if (positional.length > 0) {
+        options.query = positional.join(' ');
+    }
+    return options;
+}
+function formatAsCsv(results) {
+    if (results.length === 0)
+        return '';
+    const headers = ['title', 'url', 'content', 'engine', 'category'];
+    const lines = [headers.join(',')];
+    for (const r of results) {
+        const row = headers.map(h => {
+            const val = String(r[h] || '').replace(/"/g, '""');
+            return `"${val}"`;
+        });
+        lines.push(row.join(','));
+    }
+    return lines.join('\n');
+}
+function formatAsHtml(results) {
+    const rows = results.map(r => `
+        <tr>
+            <td><a href="${r.url}">${r.title}</a></td>
+            <td>${r.content}</td>
+            <td>${r.engine}</td>
+        </tr>
+    `).join('');
+    return `<!DOCTYPE html>
+<html>
+<head><title>Search Results</title></head>
+<body>
+<table border="1">
+    <tr><th>Title</th><th>Content</th><th>Engine</th></tr>
+    ${rows}
+</table>
+</body>
+</html>`;
+}
+function formatOutput(data, format) {
+    switch (format) {
+        case 'csv':
+            return formatAsCsv(data.results || []);
+        case 'html':
+            return formatAsHtml(data.results || []);
+        case 'json':
+        default:
+            return JSON.stringify(data, null, 2);
+    }
+}
+export async function runCli(args, service) {
+    const options = parseArgs(args);
+    if (options.help) {
+        console.log(HELP_TEXT);
+        return 0;
+    }
+    if (options.init) {
+        return await initConfig();
+    }
+    if (options.health) {
+        const health = await service.healthCheck();
+        const envelope = health.status === 'healthy'
+            ? createSuccessEnvelope(health)
+            : createErrorEnvelope('HEALTH_CHECK_FAILED', health.error || 'SearXNG server is not responding', { hint: `Check if SearXNG is running at ${config.baseUrl}` });
+        console.log(JSON.stringify(envelope, null, 2));
+        return health.status === 'healthy' ? 0 : 1;
+    }
+    if (options.enginesList) {
+        try {
+            const engines = await service.getEngines();
+            if (engines.length === 0) {
+                const envelope = createErrorEnvelope('ENGINES_FETCH_EMPTY', 'No engines returned from SearXNG server', { hint: 'Check if SearXNG server is properly configured' });
+                console.log(JSON.stringify(envelope, null, 2));
+                return 1;
+            }
+            const envelope = createSuccessEnvelope({
+                engines,
+                source: 'server'
+            });
+            console.log(JSON.stringify(envelope, null, 2));
+            return 0;
+        }
+        catch (error) {
+            const envelope = createErrorEnvelope('ENGINES_FETCH_FAILED', error instanceof Error ? error.message : 'Failed to fetch engines', { hint: 'Check your network connection and SearXNG server status' });
+            console.log(JSON.stringify(envelope, null, 2));
+            return 1;
+        }
+    }
+    if (options.categoriesList) {
+        try {
+            const categories = await service.getCategories();
+            if (categories.length === 0) {
+                const envelope = createErrorEnvelope('CATEGORIES_FETCH_EMPTY', 'No categories returned from SearXNG server', { hint: 'Check if SearXNG server is properly configured' });
+                console.log(JSON.stringify(envelope, null, 2));
+                return 1;
+            }
+            const envelope = createSuccessEnvelope({
+                categories,
+                source: 'server'
+            });
+            console.log(JSON.stringify(envelope, null, 2));
+            return 0;
+        }
+        catch (error) {
+            const envelope = createErrorEnvelope('CATEGORIES_FETCH_FAILED', error instanceof Error ? error.message : 'Failed to fetch categories', { hint: 'Check your network connection and SearXNG server status' });
+            console.log(JSON.stringify(envelope, null, 2));
+            return 1;
+        }
+    }
+    if (!options.query) {
+        const envelope = createErrorEnvelope('MISSING_QUERY', 'No search query provided', { hint: 'Use: sxng "your search query"' });
+        console.log(JSON.stringify(envelope, null, 2));
+        return 1;
+    }
+    if (options.engines && config.allowedEngines.length > 0) {
+        const invalid = options.engines.filter(e => !config.allowedEngines.includes(e));
+        if (invalid.length > 0) {
+            const envelope = createErrorEnvelope('INVALID_ENGINES', `Engines not allowed: ${invalid.join(', ')}`, { hint: `Allowed engines: ${config.allowedEngines.join(', ')}` });
+            console.log(JSON.stringify(envelope, null, 2));
+            return 1;
+        }
+    }
+    const searchOptions = {
+        query: options.query,
+        engines: options.engines,
+        categories: options.categories,
+        limit: options.limit ?? config.defaultLimit,
+        page: options.page,
+        language: options.language,
+        timeRange: options.timeRange,
+        format: options.format || 'json'
+    };
+    try {
+        const results = await service.search(searchOptions);
+        const envelope = createSuccessEnvelope({
+            query: results.query,
+            totalResults: results.numberOfResults,
+            returnedResults: results.results.length,
+            results: results.results,
+            suggestions: results.suggestions,
+            answers: results.answers,
+            unresponsiveEngines: results.unresponsiveEngines
+        });
+        if (options.format && options.format !== 'json') {
+            console.error(JSON.stringify(envelope, null, 2));
+            console.log(formatOutput(results, options.format));
+        }
+        else {
+            console.log(JSON.stringify(envelope, null, 2));
+        }
+        return 0;
+    }
+    catch (error) {
+        const envelope = createErrorEnvelope('SEARCH_FAILED', error instanceof Error ? error.message : 'Search request failed', {
+            retryable: true,
+            hint: 'Check your network connection and SearXNG server status'
+        });
+        console.log(JSON.stringify(envelope, null, 2));
+        return 1;
+    }
+}
+//# sourceMappingURL=runCli.js.map

package/dist/runCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCli.js","sourceRoot":"","sources":["../src/runCli.ts"],"names":[],"mappings":"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"}

package/dist/service.d.ts

@@ -0,0 +1,51 @@
+/**
+ * SearXNG CLI - Search Service
+ */
+export interface SearchOptions {
+    query: string;
+    engines?: string[];
+    categories?: string[];
+    limit?: number;
+    page?: number;
+    language?: string;
+    timeRange?: 'day' | 'week' | 'month' | 'year' | 'all';
+    format?: 'json' | 'csv' | 'html';
+}
+export interface SearchResult {
+    title: string;
+    url: string;
+    content: string;
+    engine: string;
+    category: string;
+    publishedDate?: string;
+    thumbnail?: string;
+    score?: number;
+}
+export interface SearchResponse {
+    query: string;
+    numberOfResults: number;
+    results: SearchResult[];
+    suggestions: string[];
+    answers: string[];
+    corrections: string[];
+    infoboxes: Array<{
+        infobox: string;
+        content: string;
+        engine: string;
+    }>;
+    unresponsiveEngines: string[];
+}
+export declare class SearXNGService {
+    private client;
+    constructor();
+    getEngines(): Promise<string[]>;
+    getCategories(): Promise<string[]>;
+    search(options: SearchOptions): Promise<SearchResponse>;
+    healthCheck(): Promise<{
+        status: 'healthy' | 'unhealthy';
+        baseUrl: string;
+        engines?: string[];
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACtD,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,mBAAmB,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAgB;;IAyBxB,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAa/B,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAWlC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA+DvD,WAAW,IAAI,OAAO,CAAC;QACzB,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;QAChC,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CAiBL"}

package/dist/service.js

@@ -0,0 +1,127 @@
+/**
+ * SearXNG CLI - Search Service
+ */
+import axios from 'axios';
+import { HttpsProxyAgent } from 'https-proxy-agent';
+import { config } from './config.js';
+export class SearXNGService {
+    client;
+    constructor() {
+        const axiosConfig = {
+            baseURL: config.baseUrl,
+            timeout: config.timeout,
+            headers: {
+                'Accept': 'application/json',
+                'User-Agent': 'searxng-cli/1.0.0'
+            }
+        };
+        if (config.useProxy && config.proxyUrl) {
+            try {
+                const proxyAgent = new HttpsProxyAgent(config.proxyUrl);
+                axiosConfig.httpsAgent = proxyAgent;
+                axiosConfig.httpAgent = proxyAgent;
+            }
+            catch (error) {
+                console.error(`Failed to configure proxy: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        this.client = axios.create(axiosConfig);
+    }
+    async getEngines() {
+        try {
+            const response = await this.client.get('/config');
+            const engines = response.data.engines || [];
+            return engines
+                .filter((e) => e.enabled)
+                .map((e) => e.name);
+        }
+        catch (error) {
+            console.error(`Failed to fetch engines: ${error instanceof Error ? error.message : String(error)}`);
+            return [];
+        }
+    }
+    async getCategories() {
+        try {
+            const response = await this.client.get('/config');
+            const categories = response.data.categories || [];
+            return categories.map((c) => typeof c === 'string' ? c : c?.name).filter(Boolean);
+        }
+        catch (error) {
+            console.error(`Failed to fetch categories: ${error instanceof Error ? error.message : String(error)}`);
+            return [];
+        }
+    }
+    async search(options) {
+        const params = {
+            q: options.query,
+            format: 'json'
+        };
+        if (options.engines && options.engines.length > 0) {
+            params.engines = options.engines.join(',');
+        }
+        if (options.categories && options.categories.length > 0) {
+            params.categories = options.categories.join(',');
+        }
+        if (options.language) {
+            params.language = options.language;
+        }
+        if (options.timeRange) {
+            params.time_range = options.timeRange;
+        }
+        if (options.page && options.page > 1) {
+            params.pageno = String(options.page);
+        }
+        try {
+            const response = await this.client.get('/search', { params });
+            const data = response.data;
+            const results = (data.results || []).map((item) => ({
+                title: item.title || '',
+                url: item.url || '',
+                content: item.content || item.snippet || '',
+                engine: item.engine || 'unknown',
+                category: item.category || 'general',
+                publishedDate: item.publishedDate,
+                thumbnail: item.thumbnail,
+                score: item.score
+            }));
+            const limitedResults = options.limit && options.limit > 0
+                ? results.slice(0, options.limit)
+                : results;
+            return {
+                query: data.query || options.query,
+                numberOfResults: data.numberOfResults || limitedResults.length,
+                results: limitedResults,
+                suggestions: data.suggestions || [],
+                answers: data.answers || [],
+                corrections: data.corrections || [],
+                infoboxes: data.infoboxes || [],
+                unresponsiveEngines: data.unresponsive_engines || []
+            };
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                throw new Error(`Search failed: ${error.response?.statusText || error.message}`);
+            }
+            throw error;
+        }
+    }
+    async healthCheck() {
+        try {
+            const response = await this.client.get('/healthz', { timeout: 5000 });
+            const engines = await this.getEngines();
+            return {
+                status: 'healthy',
+                baseUrl: config.baseUrl,
+                engines
+            };
+        }
+        catch (error) {
+            return {
+                status: 'unhealthy',
+                baseUrl: config.baseUrl,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "sxng-cli",
+  "version": "1.0.1",
+  "description": "SearXNG CLI - Web Search Tool",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "sxng": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "sxng.config.example.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "searxng",
+    "search",
+    "cli",
+    "web-search"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.0",
+    "https-proxy-agent": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/sxng.config.example.json

@@ -0,0 +1,9 @@
+{
+  "baseUrl": "http://localhost:8080",
+  "defaultEngine": "",
+  "allowedEngines": [],
+  "defaultLimit": 10,
+  "useProxy": false,
+  "proxyUrl": "",
+  "timeout": 10000
+}