Comprehensive comparison for Search technology in Software Development applications

// Production-ready code search API endpoint using Algolia
// Demonstrates searching across code repositories with filters and faceting

const algoliasearch = require('algoliasearch');
const express = require('express');
const app = express();

// Initialize Algolia client
const client = algoliasearch(
  process.env.ALGOLIA_APP_ID,
  process.env.ALGOLIA_API_KEY
);
const index = client.initIndex('code_repositories');

// Middleware
app.use(express.json());

// Code search endpoint with advanced filtering
app.post('/api/search/code', async (req, res) => {
  try {
    const {
      query = '',
      language = null,
      repository = null,
      page = 0,
      hitsPerPage = 20,
      sortBy = 'relevance'
    } = req.body;

    // Validate input
    if (hitsPerPage > 100) {
      return res.status(400).json({ error: 'hitsPerPage cannot exceed 100' });
    }

    // Build facet filters
    const facetFilters = [];
    if (language) {
      facetFilters.push(`language:${language}`);
    }
    if (repository) {
      facetFilters.push(`repository:${repository}`);
    }

    // Configure search parameters
    const searchParams = {
      query,
      page,
      hitsPerPage,
      facets: ['language', 'repository', 'fileType'],
      facetFilters: facetFilters.length > 0 ? facetFilters : undefined,
      attributesToRetrieve: [
        'fileName',
        'filePath',
        'repository',
        'language',
        'codeSnippet',
        'lastModified',
        'author'
      ],
      attributesToHighlight: ['codeSnippet', 'fileName'],
      highlightPreTag: '<mark>',
      highlightPostTag: '</mark>',
      snippetEllipsisText: '...',
      removeWordsIfNoResults: 'lastWords',
      typoTolerance: true,
      minWordSizefor1Typo: 4,
      minWordSizefor2Typos: 8
    };

    // Handle sorting
    let searchIndex = index;
    if (sortBy === 'date') {
      searchIndex = client.initIndex('code_repositories_date_desc');
    } else if (sortBy === 'popularity') {
      searchIndex = client.initIndex('code_repositories_stars_desc');
    }

    // Execute search
    const results = await searchIndex.search(query, searchParams);

    // Format response
    const response = {
      hits: results.hits.map(hit => ({
        objectID: hit.objectID,
        fileName: hit.fileName,
        filePath: hit.filePath,
        repository: hit.repository,
        language: hit.language,
        codeSnippet: hit._highlightResult?.codeSnippet?.value || hit.codeSnippet,
        lastModified: hit.lastModified,
        author: hit.author
      })),
      facets: results.facets,
      nbHits: results.nbHits,
      nbPages: results.nbPages,
      page: results.page,
      hitsPerPage: results.hitsPerPage,
      processingTimeMS: results.processingTimeMS
    };

    res.json(response);

  } catch (error) {
    console.error('Algolia search error:', error);
    
    // Handle specific Algolia errors
    if (error.statusCode === 429) {
      return res.status(429).json({ error: 'Rate limit exceeded. Please try again later.' });
    }
    
    if (error.statusCode === 403) {
      return res.status(500).json({ error: 'Search service authentication failed.' });
    }

    res.status(500).json({ 
      error: 'Search failed. Please try again.',
      details: process.env.NODE_ENV === 'development' ? error.message : undefined
    });
  }
});

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Code search API running on port ${PORT}`);
});