recker 1.0.23 → 1.0.26

package/dist/cli/handler.js

@@ -1,9 +1,8 @@
 import { createClient } from '../core/client.js';
 import { requireOptional } from '../utils/optional-require.js';
 import colors from '../utils/colors.js';
-import oraImport from 'ora';
+import { createSpinner } from './tui/spinner.js';
 let highlight;
-const ora = oraImport;
 async function initDependencies() {
     if (!highlight) {
         try {
@@ -24,10 +23,9 @@ export async function handleRequest(options) {
             }
         });
     }
-    const spinner = options.quiet ? null : ora({
+    const spinner = options.quiet ? null : createSpinner({
         text: `${colors.bold(options.method)} ${colors.cyan(options.url)}`,
-        color: 'cyan',
-        spinner: 'dots'
+        color: 'cyan'
     }).start();
     const start = performance.now();
     try {

package/dist/cli/tui/search-panel.d.ts

@@ -13,6 +13,8 @@ export declare class SearchPanel {
     private rightPanelWidth;
     private contentHeight;
     private previewContent;
+    private keyHandler;
+    private resizeHandler;
     constructor(options?: SearchPanelOptions);
     private findDocsPath;
     open(): Promise<void>;

package/dist/cli/tui/search-panel.js

@@ -34,6 +34,8 @@ export class SearchPanel {
     rightPanelWidth = 0;
     contentHeight = 0;
     previewContent = [];
+    keyHandler = null;
+    resizeHandler = null;
     constructor(options = {}) {
         this.state = {
             query: options.initialQuery || '',
@@ -69,11 +71,13 @@ export class SearchPanel {
         if (process.stdin.isTTY) {
             process.stdin.setRawMode(true);
         }
-        process.stdout.on('resize', () => {
+        this.resizeHandler = () => {
             this.updateDimensions();
             this.render();
-        });
-        process.stdin.on('data', this.handleKeyInput.bind(this));
+        };
+        process.stdout.on('resize', this.resizeHandler);
+        this.keyHandler = this.handleKeyInput.bind(this);
+        process.stdin.on('data', this.keyHandler);
         if (this.state.query) {
             await this.performSearch();
         }
@@ -99,8 +103,14 @@ export class SearchPanel {
             this.rl.close();
             this.rl = null;
         }
-        process.stdin.removeAllListeners('data');
-        process.stdout.removeAllListeners('resize');
+        if (this.keyHandler) {
+            process.stdin.removeListener('data', this.keyHandler);
+            this.keyHandler = null;
+        }
+        if (this.resizeHandler) {
+            process.stdout.removeListener('resize', this.resizeHandler);
+            this.resizeHandler = null;
+        }
     }
     updateDimensions() {
         this.termWidth = process.stdout.columns || 80;

package/dist/cli/tui/shell-search.d.ts

@@ -1,21 +1,27 @@
 import type { SearchResult } from '../../mcp/search/types.js';
+export type ProgressCallback = (stage: string, percent?: number) => void;
 export declare class ShellSearch {
     private hybridSearch;
     private docsIndex;
     private codeExamples;
     private typeDefinitions;
     private initialized;
+    private initializing;
     private idleTimer;
     private docsPath;
     private examplesPath;
     private srcPath;
+    private spinner;
+    private hasSemanticSearch;
     constructor();
+    private updateSpinner;
     private ensureInitialized;
     private resetIdleTimer;
     private unload;
     search(query: string, options?: {
         limit?: number;
         category?: string;
+        silent?: boolean;
     }): Promise<SearchResult[]>;
     suggest(useCase: string): Promise<string>;
     getExamples(feature: string, options?: {

package/dist/cli/tui/shell-search.js

@@ -2,6 +2,7 @@ import { createHybridSearch, createEmbedder, isFastembedAvailable } from '../../
 import { readFileSync, readdirSync, statSync, existsSync } from 'fs';
 import { join, relative, extname, basename, dirname } from 'path';
 import { fileURLToPath } from 'url';
+import { createSpinner } from './spinner.js';
 const IDLE_TIMEOUT_MS = 5 * 60 * 1000;
 export class ShellSearch {
     hybridSearch = null;
@@ -9,27 +10,61 @@ export class ShellSearch {
     codeExamples = [];
     typeDefinitions = [];
     initialized = false;
+    initializing = false;
     idleTimer = null;
     docsPath;
     examplesPath;
     srcPath;
+    spinner = null;
+    hasSemanticSearch = false;
     constructor() {
         this.docsPath = this.findDocsPath();
         this.examplesPath = this.findExamplesPath();
         this.srcPath = this.findSrcPath();
     }
+    updateSpinner(text) {
+        if (this.spinner) {
+            this.spinner.text = text;
+        }
+    }
     async ensureInitialized() {
         this.resetIdleTimer();
         if (this.initialized && this.hybridSearch) {
             return;
         }
-        this.hybridSearch = createHybridSearch({ debug: false });
-        if (await isFastembedAvailable()) {
-            this.hybridSearch.setEmbedder(createEmbedder());
+        if (this.initializing) {
+            while (this.initializing) {
+                await new Promise(resolve => setTimeout(resolve, 100));
+            }
+            return;
+        }
+        this.initializing = true;
+        this.spinner = createSpinner({ text: 'Initializing search...' }).start();
+        try {
+            this.updateSpinner('Creating search index...');
+            this.hybridSearch = createHybridSearch({ debug: false });
+            this.updateSpinner('Checking semantic search availability...');
+            const fastembedAvailable = await isFastembedAvailable();
+            if (fastembedAvailable) {
+                this.updateSpinner('Loading AI embedding model (first time may take a while)...');
+                this.hybridSearch.setEmbedder(createEmbedder());
+                this.hasSemanticSearch = true;
+            }
+            this.updateSpinner('Indexing documentation...');
+            this.buildIndex();
+            this.updateSpinner('Finalizing search index...');
+            await this.hybridSearch.initialize(this.docsIndex);
+            this.initialized = true;
+            this.spinner.succeed(`Search ready (${this.docsIndex.length} docs${this.hasSemanticSearch ? ', semantic enabled' : ''})`);
+        }
+        catch (error) {
+            this.spinner.fail(`Search initialization failed: ${error}`);
+            throw error;
+        }
+        finally {
+            this.initializing = false;
+            this.spinner = null;
         }
-        this.buildIndex();
-        await this.hybridSearch.initialize(this.docsIndex);
-        this.initialized = true;
     }
     resetIdleTimer() {
         if (this.idleTimer) {
@@ -48,22 +83,46 @@ export class ShellSearch {
     }
     async search(query, options = {}) {
         await this.ensureInitialized();
-        const { limit = 5, category } = options;
+        const { limit = 5, category, silent = false } = options;
         if (!this.hybridSearch) {
             return [];
         }
-        return this.hybridSearch.search(query, { limit, category, mode: 'hybrid' });
+        let searchSpinner = null;
+        if (!silent && this.hasSemanticSearch) {
+            searchSpinner = createSpinner({ text: 'Generating query embedding...' }).start();
+        }
+        try {
+            if (searchSpinner) {
+                searchSpinner.text = 'Searching documentation...';
+            }
+            const results = await this.hybridSearch.search(query, { limit, category, mode: 'hybrid' });
+            if (searchSpinner) {
+                searchSpinner.succeed(`Found ${results.length} result${results.length !== 1 ? 's' : ''}`);
+            }
+            return results;
+        }
+        catch (error) {
+            if (searchSpinner) {
+                searchSpinner.fail(`Search failed: ${error}`);
+            }
+            throw error;
+        }
     }
     async suggest(useCase) {
-        await this.ensureInitialized();
-        const results = await this.search(useCase, { limit: 3 });
-        if (results.length === 0) {
-            return `No suggestions found for: "${useCase}"\n\nTry searching for specific features like:\n  - retry\n  - cache\n  - streaming\n  - websocket\n  - pagination`;
-        }
-        const useCaseLower = useCase.toLowerCase();
-        const suggestions = [];
-        if (useCaseLower.includes('retry') || useCaseLower.includes('fail') || useCaseLower.includes('error')) {
-            suggestions.push(`\n**Retry Configuration:**
+        const spinner = createSpinner({ text: 'Generating suggestions...' }).start();
+        try {
+            await this.ensureInitialized();
+            spinner.text = 'Finding relevant documentation...';
+            const results = await this.search(useCase, { limit: 3, silent: true });
+            if (results.length === 0) {
+                spinner.info('No suggestions found');
+                return `No suggestions found for: "${useCase}"\n\nTry searching for specific features like:\n  - retry\n  - cache\n  - streaming\n  - websocket\n  - pagination`;
+            }
+            spinner.text = 'Building suggestions...';
+            const useCaseLower = useCase.toLowerCase();
+            const suggestions = [];
+            if (useCaseLower.includes('retry') || useCaseLower.includes('fail') || useCaseLower.includes('error')) {
+                suggestions.push(`\n**Retry Configuration:**
 \`\`\`typescript
 import { createClient } from 'recker';
 
@@ -77,9 +136,9 @@ const client = createClient({
   }
 });
 \`\`\``);
-        }
-        if (useCaseLower.includes('cache') || useCaseLower.includes('storage')) {
-            suggestions.push(`\n**Cache Configuration:**
+            }
+            if (useCaseLower.includes('cache') || useCaseLower.includes('storage')) {
+                suggestions.push(`\n**Cache Configuration:**
 \`\`\`typescript
 import { createClient } from 'recker';
 
@@ -92,9 +151,9 @@ const client = createClient({
   }
 });
 \`\`\``);
-        }
-        if (useCaseLower.includes('stream') || useCaseLower.includes('sse') || useCaseLower.includes('ai') || useCaseLower.includes('openai')) {
-            suggestions.push(`\n**Streaming Configuration:**
+            }
+            if (useCaseLower.includes('stream') || useCaseLower.includes('sse') || useCaseLower.includes('ai') || useCaseLower.includes('openai')) {
+                suggestions.push(`\n**Streaming Configuration:**
 \`\`\`typescript
 import { createClient } from 'recker';
 
@@ -105,9 +164,9 @@ for await (const event of client.post('/v1/chat/completions', { body, stream: tr
   console.log(event.data);
 }
 \`\`\``);
-        }
-        if (useCaseLower.includes('parallel') || useCaseLower.includes('batch') || useCaseLower.includes('concurrent')) {
-            suggestions.push(`\n**Batch/Parallel Requests:**
+            }
+            if (useCaseLower.includes('parallel') || useCaseLower.includes('batch') || useCaseLower.includes('concurrent')) {
+                suggestions.push(`\n**Batch/Parallel Requests:**
 \`\`\`typescript
 import { createClient } from 'recker';
 
@@ -122,19 +181,25 @@ const { results, stats } = await client.batch([
   { path: '/users/3' }
 ], { mapResponse: r => r.json() });
 \`\`\``);
-        }
-        let output = `**Suggestion for: "${useCase}"**\n`;
-        if (suggestions.length > 0) {
-            output += suggestions.join('\n');
-        }
-        output += `\n\n**Related Documentation:**\n`;
-        for (const result of results) {
-            output += `  - ${result.title} (${result.path})\n`;
-            if (result.snippet) {
-                output += `    ${result.snippet.slice(0, 100)}...\n`;
             }
+            let output = `**Suggestion for: "${useCase}"**\n`;
+            if (suggestions.length > 0) {
+                output += suggestions.join('\n');
+            }
+            output += `\n\n**Related Documentation:**\n`;
+            for (const result of results) {
+                output += `  - ${result.title} (${result.path})\n`;
+                if (result.snippet) {
+                    output += `    ${result.snippet.slice(0, 100)}...\n`;
+                }
+            }
+            spinner.succeed('Suggestions ready');
+            return output;
+        }
+        catch (error) {
+            spinner.fail(`Failed to generate suggestions: ${error}`);
+            throw error;
         }
-        return output;
     }
     async getExamples(feature, options = {}) {
         await this.ensureInitialized();

package/dist/cli/tui/shell.js

@@ -13,7 +13,7 @@ import { ScrapeDocument } from '../../scrape/document.js';
 import colors from '../../utils/colors.js';
 import { getShellSearch } from './shell-search.js';
 import { openSearchPanel } from './search-panel.js';
-import { ScrollBuffer, parseScrollKey, parseMouseScroll, enableMouseReporting, disableMouseReporting } from './scroll-buffer.js';
+import { ScrollBuffer, parseScrollKey, parseMouseScroll, disableMouseReporting } from './scroll-buffer.js';
 let highlight;
 async function initDependencies() {
     if (!highlight) {
@@ -106,7 +106,7 @@ export class RekShell {
         console.clear();
         console.log(colors.bold(colors.cyan('Rek Console')));
         console.log(colors.gray('Chat with your APIs. Type "help" for magic.'));
-        console.log(colors.gray('Page Up/Down or mouse scroll to view history.'));
+        console.log(colors.gray('Use Page Up/Down to view history.'));
         console.log(colors.gray('--------------------------------------------\n'));
         this.prompt();
         this.rl.on('line', async (line) => {
@@ -150,7 +150,6 @@ export class RekShell {
         disableMouseReporting();
     }
     setupScrollKeyHandler() {
-        enableMouseReporting();
         if (process.stdin.isTTY) {
             const originalEmit = process.stdin.emit.bind(process.stdin);
             const self = this;
@@ -2060,10 +2059,12 @@ ${colors.bold('Network:')}
             this.rl.pause();
             await openSearchPanel(query.trim() || undefined);
             this.rl.resume();
+            this.prompt();
         }
         catch (error) {
             console.error(colors.red(`Search failed: ${error.message}`));
             this.rl.resume();
+            this.prompt();
         }
     }
     async runSuggest(useCase) {
@@ -2209,7 +2210,6 @@ ${colors.bold('Network:')}
   ${colors.bold('Navigation:')}
     ${colors.green('Page Up/Down')}        Scroll through command history.
     ${colors.green('Home/End')}            Jump to top/bottom of history.
-    ${colors.green('Mouse Scroll')}        Scroll with mouse wheel.
     ${colors.green('Escape')}              Exit scroll mode.
 
   ${colors.bold('Examples:')}

package/dist/cli/tui/spinner.d.ts

@@ -0,0 +1,16 @@
+export interface SpinnerOptions {
+    text?: string;
+    color?: 'cyan' | 'green' | 'yellow' | 'red' | 'blue' | 'magenta' | 'white' | 'gray';
+}
+export interface Spinner {
+    text: string;
+    start(): Spinner;
+    stop(): Spinner;
+    succeed(text?: string): Spinner;
+    fail(text?: string): Spinner;
+    info(text?: string): Spinner;
+    warn(text?: string): Spinner;
+    isSpinning: boolean;
+}
+export declare function createSpinner(options?: SpinnerOptions | string): Spinner;
+export default createSpinner;

package/dist/cli/tui/spinner.js

@@ -0,0 +1,97 @@
+import colors from '../../utils/colors.js';
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const FRAME_INTERVAL = 80;
+class TerminalSpinner {
+    _text;
+    color;
+    frameIndex = 0;
+    intervalId = null;
+    stream = process.stderr;
+    isSpinning = false;
+    constructor(options = {}) {
+        this._text = options.text || '';
+        this.color = this.getColorFn(options.color || 'cyan');
+    }
+    getColorFn(color) {
+        switch (color) {
+            case 'green': return colors.green;
+            case 'yellow': return colors.yellow;
+            case 'red': return colors.red;
+            case 'blue': return colors.blue;
+            case 'magenta': return colors.magenta;
+            case 'gray': return colors.gray;
+            case 'white': return (s) => s;
+            case 'cyan':
+            default: return colors.cyan;
+        }
+    }
+    get text() {
+        return this._text;
+    }
+    set text(value) {
+        this._text = value;
+    }
+    start() {
+        if (this.isSpinning)
+            return this;
+        this.isSpinning = true;
+        this.frameIndex = 0;
+        this.stream.write('\x1b[?25l');
+        this.intervalId = setInterval(() => {
+            this.render();
+            this.frameIndex = (this.frameIndex + 1) % SPINNER_FRAMES.length;
+        }, FRAME_INTERVAL);
+        return this;
+    }
+    render() {
+        const frame = SPINNER_FRAMES[this.frameIndex];
+        const line = `${this.color(frame)} ${this._text}`;
+        this.stream.write(`\r\x1b[K${line}`);
+    }
+    clearLine() {
+        this.stream.write('\r\x1b[K');
+    }
+    stop() {
+        if (!this.isSpinning)
+            return this;
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        this.isSpinning = false;
+        this.clearLine();
+        this.stream.write('\x1b[?25h');
+        return this;
+    }
+    succeed(text) {
+        this.stop();
+        const finalText = text ?? this._text;
+        console.log(`${colors.green('✔')} ${finalText}`);
+        return this;
+    }
+    fail(text) {
+        this.stop();
+        const finalText = text ?? this._text;
+        console.log(`${colors.red('✖')} ${finalText}`);
+        return this;
+    }
+    info(text) {
+        this.stop();
+        const finalText = text ?? this._text;
+        console.log(`${colors.blue('ℹ')} ${finalText}`);
+        return this;
+    }
+    warn(text) {
+        this.stop();
+        const finalText = text ?? this._text;
+        console.log(`${colors.yellow('⚠')} ${finalText}`);
+        return this;
+    }
+}
+export function createSpinner(options) {
+    if (typeof options === 'string') {
+        return new TerminalSpinner({ text: options });
+    }
+    return new TerminalSpinner(options);
+}
+export default createSpinner;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recker",
-  "version": "1.0.23",
+  "version": "1.0.26",
   "description": "AI & DevX focused HTTP client for Node.js 18+",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -131,7 +131,6 @@
     "cheerio": "^1.0.0",
     "commander": "^14.0.2",
     "fuse.js": "^7.1.0",
-    "ora": "^9.0.0",
     "undici": "^7.16.0",
     "zod": "^4.1.13"
   },
@@ -174,7 +173,6 @@
     "mitata": "^1.0.34",
     "needle": "^3.3.1",
     "node-fetch": "^3.3.2",
-    "ora": "^9.0.0",
     "picocolors": "^1.1.1",
     "popsicle": "^12.1.2",
     "serve": "^14.2.5",