SplatDev.Search.Elastic 1.0.3

SplatDev.Search.Elastic

Elasticsearch 8+ adapter for SplatDev.Search abstractions — full-text search, filtering, sorting, and bulk indexing via the official Elastic.Clients.Elasticsearch SDK.

Compatibility

Installation

dotnet add package SplatDev.Search.Elastic

Configuration

DI registration

using SplatDev.Search;
using SplatDev.Search.Elastic.Services;

// Cloud deployment (Elastic Cloud)
builder.Services.AddSingleton<ISearchProvider>(_ =>
    new ElasticSearchProvider("my-deployment:ZXVyb3B...", "api-key-string"));

// Self-hosted / local
builder.Services.AddSingleton<ISearchProvider>(_ =>
    new ElasticSearchProvider(new Uri("http://localhost:9200")));

Usage

using SplatDev.Search;

public class ProductCatalog
{
    private readonly ISearchProvider _search;

    public ProductCatalog(ISearchProvider search) => _search = search;

    public async Task IndexProductAsync(Product product)
    {
        await _search.IndexAsync("products", product);
    }

    public async Task BulkIndexAsync(IEnumerable<Product> products)
    {
        await _search.IndexManyAsync("products", products);
    }

    public async Task<SearchResult<Product>> SearchProductsAsync(string term, int page = 0)
    {
        return await _search.SearchAsync<Product>("products", new SearchRequest
        {
            Query = term,
            From = page * 20,
            Size = 20,
            Sort =
            [
                new SearchSortField { Field = "price", Direction = SortDirection.Descending },
            ],
            Filters = new Dictionary<string, object>
            {
                { "category", "electronics" },
                { "inStock", "true" },
            },
            Fields = ["name", "price", "category"],
        });
    }
}

Features

• Full ISearchProvider implementation backed by Elastic.Clients.Elasticsearch v8.15+
• Multi-match queries across configurable fields
• Term-level filters (converted to boolean filter clauses)
• Sorting by field with direction
• Source filtering (field projection)
• Bulk indexing via IndexManyAsync
• Index management (create, delete, exists)
• Delete by query string
• Both cloud (Elastic Cloud) and self-hosted connection modes

Dependencies

SplatDev.Search.Elastic — part of the SplatDev.Umbraco.Plugins suite. Licensed under MIT. © SplatDev Ltda.

Changelog

1.0.3 — 2026-08-25

Documentation only, no code change. The README's search example used SearchSort; the real type is SearchSortField. It also assigned a Dictionary<string, string> to SearchRequest.Filters, which is a Dictionary<string, object> — so the sample did not compile on either count. It is now compiled against the assembly.

1.0.2 — 2026-08-24

Removes a dashboard screenshot that showed an error toast. It was captured against a site where this plugin's API was unreachable, so it advertised a broken dashboard. No screenshot is better than a misleading one; a replacement will be taken against a working install.

1.0.1 — 2026-08-24

Package metadata only: the listing now carries an icon and search tags, and the project and repository links point at the organisation that actually hosts this code. No code changes.

1.0.0 — 2026-08-24

This package now keeps a changelog. Earlier releases predate it and are not reconstructed here — consult the repository history for those. From this version on, every release records what changed for someone using it.