junghoon-vans/spring-data-meilisearch
66.3
Adequate · 8 November 2026
9.7k
lines of production code
Java
primary language
6
measurements over time
What this system is
This system is a Spring Data integration library for Meilisearch that enables developers to use standard Spring Data repository interfaces for full-text search and document management. It provides declarative configuration via Java annotations and XML, supporting complex search operations such as faceting, filtering, sorting, and vector-based similarity searches. The library handles entity mapping, query translation, and index lifecycle management while offering Kotlin extensions and comprehensive test infrastructure for integration testing.
How it got here
2023 — Spring Data Meilisearch integration
22 changes.
The project was initialized and built from scratch to provide a Spring Data integration for Meilisearch, establishing core infrastructure for client configuration, entity mapping, and repository operations. Key features include support for both XML and annotation-based configuration, declarative index settings via annotations, and a full repository layer with CRUD, search, and derived query capabilities. Comprehensive test coverage was added to validate configuration, mapping, and repository functionality against a real Meilisearch instance.
2025–2026 — MSC client implementation and query model expansion
9 changes.
This period focused on implementing the core Meilisearch Client (MSC) infrastructure, including templates, converters, and a comprehensive query model supporting facets, similarity, and multi-index searches. It also introduced Kotlin extension functions for idiomatic usage, declared repository query support, and migrated the documentation system to Antora with automated versioning.
Features
Add Kotlin blocking operations extensions
New Kotlin extension functions are added to the core Meilisearch operations interfaces (DocumentOperations, MeilisearchOperations, and SearchOperations). These extensions allow developers to use reified type parameters, enabling them to call methods like get, multiGet, findAll, search, and count without explicitly passing the class type, resulting in more concise and idiomatic Kotlin code.
src/main/kotlin · high confidence
Add XML and annotation-based configuration for Meilisearch
Users can now configure the Meilisearch client and operations using Spring XML namespaces (via MeilisearchNamespaceHandler and MeilisearchClientBeanDefinitionParser) or Java-based annotation configuration (via MeilisearchConfiguration and MeilisearchConfigurationSupport). The XML parser supports setting host-url, api-key, client-agents, json-handler-ref, request-timeout, and request-interval attributes, while the annotation-based approach auto-configures the client, converter, mapping context, and JSON handler beans.
src/main/java/io/vanslog/spring/data/meilisearch/config · high confidence
Add declared repository query support and facet search capabilities
Users can now define search queries directly on repository interfaces using declared query methods with positional parameters, which are compiled and bound to Meilisearch filters and text queries. The library also introduces facet search support, exposing facet hit data via a new FacetHit record, and improves pagination accuracy by using the search response's total hit count for repository pages instead of relying on the loaded hit count.
spring-data-meilisearch · high confidence
Added Spring XML namespace support for Meilisearch configuration
The library now supports configuring Meilisearch via Spring XML. New metadata files in META-INF register the custom namespace handler and schema, allowing users to define Meilisearch beans using the http://www.vanslog.io/spring/data/meilisearch namespace and the associated XSD.
src/main/resources/META-INF · high confidence
Initial Spring Data Meilisearch repository support
This release introduces the core infrastructure for Spring Data repositories backed by Meilisearch. The \src/main/java/io/vanslog/spring/data/meilisearch/repository/support\ package now provides the factory (\MeilisearchRepositoryFactory\), entity information handling (\MappingMeilisearchEntityInformation\), and the base repository implementation (\SimpleMeilisearchRepository\). This enables users to define standard Spring Data repository interfaces to perform CRUD operations, derived queries, and pagination against Meilisearch indices.
src/main/java/io/vanslog/spring/data/meilisearch/repository/support · high confidence
Initial support for Meilisearch repositories via Spring Data configuration
This change introduces the configuration infrastructure required to use Meilisearch as a Spring Data repository store. Users can now enable Meilisearch repositories by adding the new \@EnableMeilisearchRepositories\ annotation to their configuration classes, which scans specified base packages for interfaces extending \MeilisearchRepository\ and annotated with \@Document\. The setup includes a custom \RepositoryConfigurationExtension\ that wires the \MeilisearchOperations\ bean (defaulting to \meilisearchTemplate\) into the repository factory, and a registrar to handle the Spring component scanning. This allows developers to define standard Spring Data repository interfaces backed by Meilisearch without writing implementation code.
src/main/java/io/vanslog/spring/data/meilisearch/repository/config · high confidence
Introduce Meilisearch repository interface and declared query support
This change adds the core repository layer for Meilisearch integration. The new MeilisearchRepository interface extends Spring Data's CrudRepository and PagingAndSortingRepository, enabling standard CRUD operations as well as paging and sorting (requiring Meilisearch 1.16+). It specifically supports native ID-list fetching via findAllById (available from Meilisearch 1.14) and sorted listings, noting that concurrent additions may affect result counts in sorted queries. Additionally, a new @Query annotation is introduced to allow developers to declare repository search methods using native Meilisearch filter templates and full-text search queries (q), replacing method-name derivation for these specific search patterns.
src/main/java/io/vanslog/spring/data/meilisearch/repository · high confidence
Introduce core Meilisearch operations and index management APIs
The library now exposes a structured set of core interfaces and model classes for interacting with Meilisearch. DocumentOperations provides methods for saving, retrieving, counting, and deleting entities, while SearchOperations adds support for standard, multi, federated, facet, and similar-document searches, returning results wrapped in SearchHit and SearchHits. Index management is handled via MeilisearchIndexOperations, which allows creating, updating, listing, and deleting indexes, as well as reading and writing runtime settings (including pagination, faceting, and typo tolerance) through MeilisearchIndexSettings. Instance-level health, version, and statistics are available through MeilisearchInstanceOperations, and a MeilisearchCallback interface enables low-level client access for custom operations.
src/main/java/io/vanslog/spring/data/meilisearch/core · high confidence
Introduce core entity-to-document conversion infrastructure
This change adds the foundational conversion layer for mapping Spring Data entities to and from Meilisearch documents. It introduces the \MeilisearchConverter\ interface and its \MappingMeilisearchConverter\ implementation, which leverage Spring Data's mapping context to handle property-level serialization and deserialization. The package also includes \MeilisearchCustomConversions\ to support custom type converters and a \Document\ class representing the map-shaped structure used between entity mapping and JSON serialization, enabling users to store and retrieve complex objects via type-safe conversion rather than manual handling.
src/main/java/io/vanslog/spring/data/meilisearch/core/convert · high confidence
Introduce core mapping abstraction for Meilisearch entities
This change adds the foundational mapping layer for the Meilisearch integration, introducing interfaces and implementations for persistent entities and properties. Users can now define Meilisearch-specific configurations via annotations such as @Document, @Setting, @Pagination, @TypoTolerance, and @Faceting, which control index settings like sortable attributes, distinct fields, and ranking rules. The mapping context automatically resolves index UIDs and applies these settings during repository bootstrapping, enabling fine-grained control over search behavior directly from entity definitions.
src/main/java/io/vanslog/spring/data/meilisearch/core/mapping · high confidence
Introduces MSC client implementation for Meilisearch operations
This change adds a new \client.msc\ package containing the Meilisearch Client-backed implementation of the Spring Data Meilisearch template and index/instance operations. It introduces \MeilisearchTemplate\ as the core \MeilisearchOperations\ implementation, along with \MeilisearchIndexTemplate\ and \MeilisearchInstanceTemplate\ to handle index lifecycle (create, update, delete, settings) and instance-level operations (health, version, stats). The package also includes dedicated converters (\RequestConverter\, \ResponseConverter\, \IndexRequestConverter\, \IndexSettingsResponseConverter\, \InstanceResponseConverter\) to map Spring Data query objects to Meilisearch SDK requests and SDK responses back to Spring Data domain objects, as well as result adapters like \MeilisearchSearchResult\ and \MeilisearchFacetSearchResult\ to handle raw JSON parsing for search and facet search responses.
src/main/java/io/vanslog/spring/data/meilisearch/client/msc · high confidence
Introduction of Spring Data Meilisearch module with core exception types and configuration
This change introduces the initial structure for the Spring Data Meilisearch integration. It adds specific exception classes (DocumentAccessException, IndexAccessException, TaskStatusException, UncategorizedMeilisearchException) to handle Meilisearch-specific errors within the Spring Data exception hierarchy. It also establishes the root package with non-null API/field annotations and includes an AGENTS.md guide detailing the module's architecture, including client, config, core, and repository sub-packages.
src/main/java/io/vanslog/spring/data/meilisearch · high confidence
New annotation-based configuration for Meilisearch index settings
The library now provides a comprehensive set of Java annotations in the \io.vanslog.spring.data.meilisearch.annotations\ package to configure Meilisearch index settings directly on domain classes. The \@Document\ annotation marks entities for persistence, while the \@Setting\ annotation allows users to define core search behaviors such as sortable, searchable, and filterable attributes, distinct fields, ranking rules, synonyms, and stop words. Additionally, specialized annotations have been introduced to handle advanced features: \@Embedder\ and \@EmbedderParameter\ for configuring AI-powered vector search sources (including OpenAI, Hugging Face, and Ollama); \@TypoTolerance\ and \@MinWordSizeForTypos\ for spell-checking behavior; \@Faceting\ for facet limits; \@Pagination\ for result caps; \@LocalizedAttribute\ for multi-language support; and \@Synonym\ for defining word equivalences. These annotations replace or supplement previous configuration methods, enabling declarative setup of index properties at the class level.
src/main/java/io/vanslog/spring/data/meilisearch/annotations · high confidence
New query model classes for Meilisearch search operations
Added a new set of query model classes in the core query package to support Meilisearch search capabilities. This includes a BaseQuery and BaseQueryBuilder hierarchy for standard search queries with pagination, sorting, filtering, and highlighting options. New query types have been introduced: FacetQuery and FacetQueryBuilder for facet search operations, SimilarQuery and SimilarQueryBuilder for finding similar documents using embeddings, and IndexQuery and IndexQueryBuilder for multi-index federation searches. These classes provide builder-pattern APIs for constructing complex search queries against Meilisearch indexes.
src/main/java/io/vanslog/spring/data/meilisearch/core/query · high confidence
Project initialization with documentation and build scaffolding
The repository has been initialized with the core project structure, including a Maven build configuration, a Maven Wrapper (v3.2.0) for consistent builds, and an Apache 2.0 license. Documentation has been added in AsciiDoc format (README.adoc, CONTRIBUTING.adoc, TESTING.adoc) and an Antora playbook for reference documentation generation. An AGENTS.md guide provides development conventions and code map details for contributors.
(repo-wide) · high confidence
Spring XML schema for Meilisearch configuration
A new Spring XML schema (XSD) has been added for the Meilisearch integration, enabling users to configure the Meilisearch client and repositories via Spring XML namespaces. The schema defines the \meilisearch-client\ element with attributes for the host URL (defaulting to localhost:7700), optional API key, client agents, request timeout, request interval, and a reference to a custom JSON handler. It also defines a \repositories\ element that extends the standard Spring Data repository configuration to support Meilisearch-specific template references.
src/main/resources/io · high confidence
Behavioural changes
Introduce dedicated Meilisearch client with configurable timeouts and Gson serialization
The library now provides a dedicated \MeilisearchClient\ that extends the official SDK client, allowing users to configure request timeouts and intervals for long-running tasks via a new \ClientConfiguration\ builder. This client uses Gson as the default JSON handler and includes a custom HTTP transport layer to support document fetching operations (such as \getRawDocumentsByIds\ and \getRawDocuments\) that may require specific timeout handling or access to endpoints not fully exposed by the base SDK. A Spring \FactoryBean\ is also provided to simplify client instantiation in Spring applications.
src/main/java/io/vanslog/spring/data/meilisearch/client · high confidence
Migrate documentation to Antora with automated versioning and publishing
The documentation site has been restructured to use Antora, introducing a new playbook, component configuration, and custom Node.js scripts to manage version-specific content. This change enables automated generation of publish-ready playbooks that handle release tag exclusions and local path resolution, while a custom extension ensures correct version segment metadata for navigation. Users will benefit from improved reference documentation versioning, aligned release URL policies, and reliable preview builds for pull requests.
src/main/antora · high confidence
Postinstall script patches Antora extension for recursive directory creation
A new postinstall script has been added to automatically patch the @springio/antora-extensions package. This patch modifies the cache-scandir module to use recursive directory creation (fs.mkdirSync with { recursive: true }), ensuring that nested cache directories are created correctly during the build process without manual intervention.
scripts · high confidence
Test coverage
Added integration tests for Meilisearch repository operations; Added test configuration for declared repository queries; Added test coverage for Meilisearch core components; Added test entity models for Meilisearch integration testing; Added unit tests for Meilisearch client MSC converters; Added unit tests for Meilisearch configuration and repository setup; Added unit tests for Meilisearch mapping components; Added unit tests for Meilisearch repository support classes; Added unit tests for SimilarQuery; JUnit Jupiter extension for Meilisearch integration tests.
Dependencies
Added Maven Wrapper for consistent builds
The project now includes a Maven Wrapper (version 3.2.0) configured to use Maven 3.9.6. This ensures that all developers and CI systems use the exact same Maven version and dependencies, eliminating build inconsistencies caused by local environment differences.
.mvn · high confidence
Upgrade Spring Data parent and Meilisearch Java SDK
The project now builds against Spring Data Commons 3.3.13-SNAPSHOT (via the spring-data-parent 3.3.13-SNAPSHOT) and uses the Meilisearch Java SDK 0.21.0. This brings the library up to date with the latest Spring Data APIs and the newest Meilisearch client features, ensuring compatibility and access to recent bug fixes and improvements in both frameworks.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 66 → 66 (+0.3)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 95 → 95 (+0.0)
- Architecture 73 → 74 (+1.1)
- Maturity 60 → 60 (+0.0)
- Readiness 70 → 70 (+0.3)
- Security 66 → 66 (+0.5)
- Performance 100 → 100 (+0.0)
Resolved (11)
- High CVE: [GHSA redacted] (package-lock.json)
- No assertions: rejectsBmpDigitImmediatelyAfterMultiDigitPlaceholder (src/test/java/io/vanslog/spring/data/meilisearch/repository/support/MeilisearchDeclaredQueryBindingUnitTests.java)
- No assertions: rejectsMalformedFilterAndQPlaceholdersAtConstruction (src/test/java/io/vanslog/spring/data/meilisearch/repository/support/MeilisearchDeclaredQueryBindingUnitTests.java)
- No assertions: rejectsMixedAsciiAndNonAsciiPositionalDigits (src/test/java/io/vanslog/spring/data/meilisearch/repository/support/MeilisearchDeclaredQueryBindingUnitTests.java)
- No assertions: rejectsNestedArraysAndArraysOfCollections (src/test/java/io/vanslog/spring/data/meilisearch/repository/support/MeilisearchDeclaredQueryBindingUnitTests.java)
- No assertions: rejectsNonAsciiPositionalDigitsInFilterAndQ (src/test/java/io/vanslog/spring/data/meilisearch/repository/support/MeilisearchDeclaredQueryBindingUnitTests.java)
- No assertions: rejectsSupplementaryDigitImmediatelyAfterMultiDigitPlaceholder (src/test/java/io/vanslog/spring/data/meilisearch/repository/support/MeilisearchDeclaredQueryBindingUnitTests.java)
- No assertions: rejectsUnsafeOrMalformedFilterPlaceholdersAtConstruction (src/test/java/io/vanslog/spring/data/meilisearch/repository/support/MeilisearchDeclaredQueryBindingUnitTests.java)
- No assertions: rejectsUnsupportedDeclaredCollectionElementTypes (src/test/java/io/vanslog/spring/data/meilisearch/repository/support/MeilisearchDeclaredQueryBindingUnitTests.java)
- No assertions: rejectsUnusedBindablesAndEmptyDeclarations (src/test/java/io/vanslog/spring/data/meilisearch/repository/support/MeilisearchDeclaredQueryBindingUnitTests.java)
- No assertions: shouldDistinguishNullMissingAndExistingFields (src/test/java/io/vanslog/spring/data/meilisearch/repository/support/MeilisearchRepositoryFactoryUnitTests.java)
Architecture
- Unchanged — 0 containers · 1 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
junghoon-vans/spring-data-meilisearch was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 8 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 8731d9342cd4d0d7c870059a2217dfd180585847 — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-45ab2cab63de.