v0.54.0 🌻

🚀 Enhancements

• Add sharding support to networks API (#2037) @flevi29

🐛 Bug Fixes

• fix: change swap-indexes http request to use relative path (#2053) @jezzzm

⚙️ Maintenance/misc

• Update dependabot and release template configuration (#2021)
• build(deps-dev): bump typescript from 5.8.3 to 5.9.2 (#2026) @dependabot[bot]
• build(deps): bump actions/setup-node from 4 to 5 (#2022) @dependabot[bot]
• build(deps-dev): bump typescript from 5.9.2 to 5.9.3 (#2042) @dependabot[bot]
• build(deps-dev): bump lint-staged from 16.1.5 to 16.2.3 (#2043) @dependabot[bot]
• build(deps-dev): bump typedoc from 0.28.12 to 0.28.13 (#2041) @dependabot[bot]
• build(deps-dev): bump typescript-eslint from 8.41.0 to 8.45.0 (#2046) @dependabot[bot]
• build(deps-dev): bump @vitest/eslint-plugin from 1.3.5 to 1.3.13 (#2045) @dependabot[bot]
• build(deps-dev): bump @types/node from 24.3.0 to 24.6.1 (#2040) @dependabot[bot]
• Fix tests for attributesToSearchOn set to null (#2050) @Strift
• build(deps-dev): bump vite from 7.1.5 to 7.1.11 (#2049) @dependabot[bot]
• build(deps): bump vite from 6.3.6 to 7.1.12 (#2051) @dependabot[bot]

Thanks again to @Strift, @dependabot[bot], @flevi29, @jezzzm, and dependabot[bot]! 🎉

v0.53.0

🚀 Enhancements

• Add multi-modal search (#1998) @Strift

⚙️ Maintenance/misc

• Fix index swaps types (#2000) @Strift
• Use package.json directly for version in src/ files, bundle ESM too with Vite (#2012) @flevi29

Thanks again to @Strift and @flevi29! 🎉

v0.52.0

🚀 Enhancements

• Update experimental features (#1977) @flevi29
• Add webhooks API (#1993) @Strift
• Add conversational search (#1988) @Strift

⚙️ Maintenance/misc

• Make experimental features tests more permissive (#1983) @Strift

Thanks again to @Strift, @flevi29, and dependabot[bot]! 🎉

v0.51.0 🦘

This version introduces features released in Meilisearch v1.15.0.

⚠️ Breaking changes

• Drop Node 18 support (#1927) @flevi29

🚀 Enhancements

• Add experimental features methods (#1928) @flevi29
• Add disableOnNumbers to typo tolerance settings (#1951) @Strift
• export type GranularFilterableAttribute (#1965) @nicolasvienot

⚙️ Maintenance/misc

• Remove _md code samples for Mintlify migration (#1924) @curquiza
• Trace Node.js warnings in CI tests (#1946) @flevi29
• Refactor tasks, batches & tests (#1952) @flevi29

Thanks again to @Strift, @brunoocasali, @curquiza, @flevi29, @nicolasvienot! 🎉

v0.50.0 🦫

This release adds new features related to Meilisearch 1.14.

⚠️ Breaking changes

Refactored HTTP client (#1741) @flevi29

Important

The Meilisearch class now accepts a requestInit parameter instead of requestConfig. Parameters of requestInit are the same, except it no longer accepts signal.

const client = new Meilisearch({
  host: 'https://edge.meilisearch.com',
  apiKey: 'your meilisearch API key',
  // `requestConfig` is removed, use `requestInit` instead
  requestInit: {
    headers: {
      "A-Http-Header": "The Value",
    },
  },
});

Refactored tasks and batches usage (#1825) @flevi29

Important

TaskClient and BatchClient are no longer exported

Migration guide: tasks promises now have a "waitTask" method

// Replace this 
const task = client.createIndex("test");
 await client.waitForTask(task.taskUid);
 
// By this
await client.createIndex("test").waitTask();

Migration guide: access TaskClient via the tasks property

// Replace this
client.getTask(1)
client.tasks.getTask(1)

// by this
client.getTasks()
client.tasks.getTasks()

Note

TaskClient is also accessible through the Index class, e.g., client.index('myindex').tasks

Migration guide: access BatchClient via the batches property

// Replace this
client.getBatch(1)
client.batches.getBatch(1)

// By this
client.getBatches()
client.batches.getBatches()

Note

BatchClient is also accessible through the Index class, e.g., client.index('myindex').batches

Updated exported types

Important

• Removed Batch, EnqueuedTask, and Task classes. The types are still exported!
• Date properties on Batch, EnqueuedTask, and Task are now string. They can be converted to a date using e.g. new Date(string)
• Renamed MeiliSearchTimeOutError to MeiliSearchRequestTimeOutError
• Renamed TasksQuery to TasksOrBatchesQuery

🚀 Enhancements

• Adds new features related to Meilisearch 1.14 (#1914) @Strift
• Add embedding metrics (#1888) @consoleLogIt
• Add documents database metrics to indexStats type (#1889) @consoleLogIt
• Add usedDatabaseSize field to stats type (#1890) @consoleLogIt
• Implement the experimental feature for remote federated search requests. (#1891) @consoleLogIt
• Improve TaskClient, BatchClient and associated types (#1825) @flevi29

🐛 Bug Fixes

• Refactor HttpRequests (#1741) @flevi29
• Remove custom TypeScript ESLint rules and adapt code, fix HttpRequests issue where timeout errors sometimes weren't properly thrown (#1749) @Barabasbalazs
• Improve TaskClient, BatchClient and associated types (#1825) @flevi29

⚙️ Maintenance/misc

• Update Vitest, ESLint and plugins, adapt code (#1900) @flevi29
• Remove hint about bad Meilisearch version (#1848) @flevi29
• Update Vite and Vitest (#1847) @flevi29
• Improve HttpRequests (#1741) @flevi29
• Add husky and configure lint-staged (#1861) @flevi29
• Fix package.json "repository" field (#1865) @flevi29
• Remove BORS, enable merge queues in actions (#1896) @flevi29
• Remove custom TypeScript ESLint rules and adapt code, fix HttpRequests issue where timeout errors sometimes weren't properly thrown (#1749) @Barabasbalazs
• Improve TaskClient, BatchClient and associated types (#1825) @flevi29

Thanks again to @Barabasbalazs, @Strift, @consoleLogIt, and @flevi29! 🎉

v0.49.0 🕊️

This version introduces features released on Meilisearch v1.13.0 🎉

✨ New

• AI-powered search is now stable @Strift

🐛 Bug Fixes

• Fix lack of source maps in ESM output (#1837) @flevi29

⚙️ Maintenance/misc

• Test latest major Node.js LTS version (#1840) @flevi29
• Improve playgrounds (#1839) @flevi29
• Refactor README.md installation and import sections (#1859) @flevi29
• build(deps-dev): bump vite from 6.0.7 to 6.0.9 in /playgrounds/javascript (#1831) @dependabot

Thanks again to @flevi29 and @Strift! 🎉

v0.48.2 🌻

🐛 Bug Fixes

• Fix Vite global patch for browser environments (#1829) @flevi29

Thanks again to @flevi29, @meili-bors[bot] ! 🎉

v0.48.1 🌻

🐛 Bug Fixes

• Add types field for backwards compatibility in package.json (#1827) @flevi29

Thanks again to @flevi29, @meili-bors[bot] ! 🎉

v0.48.0 🌻

⚠️ Breaking changes

• Improve token.ts and make it tree-shakeable (#1661) @flevi29

Migration

Replace:

await generateTenantToken("74c9c733-3368-4738-bbe5-1d18a5fecb37", [], {
	apiKey: "0a6e572506c52ab0bd6195921575d23092b7f0c284ab4ac86d12346c33057f99",
	expiresAt: new Date("December 17, 4000 03:24:00"),
});

By:

await generateTenantToken({
	apiKey: "0a6e572506c52ab0bd6195921575d23092b7f0c284ab4ac86d12346c33057f99",
	apiKeyUid: "74c9c733-3368-4738-bbe5-1d18a5fecb37",
	searches: [],
	expiresAt: new Date("December 17, 4000 03:24:00"),
});

⚙️ Maintenance

• Switch from rollup to vite, from commonjs to ecmascript modules (#1740) @flevi29
• Remove mention of support of Node 14 and 16 (#1805) @Strift
• Fix and improve eslint config, other minor changes (#1795) @flevi29
• Fix swapped args in localized-attributes sample (#1818) @ellnix
• [Playground] Replace Parcel by Vite (#1821) @Strift
• Switch from rollup to vite, from commonjs to ecmascript modules (#1740) @flevi29
• Remove nodemon dependency (#1822) @flevi29

Thanks again to @Strift, @ellnix, and @flevi29 🎉

v0.47.0 🌻

This version introduces features released on Meilisearch v1.12.0 🎉

Check out the Meilisearch v1.12.0 changelog for more information.

🚀 Enhancements

• Addition: #1775

Introducing new methods to get one or several batches, respectively getBatch() and getBatches().

// fetch one batch using batch UID
const batch = await client.getBatch(123)

// fetch all batches
const batches = await client.getBatches()

• Addition: #1774

The getTasks() methods now accept a reverse parameter to retrieve tasks in reverse chronological order.

const tasks = await client.getTasks({ reverse: true });

• Addition: #1790

Index settings now allow disabling prefix search and facet search. They're both enabled by default. The SDK now comes with dedicated methods to configure these settings.

// disable prefix search
await client.index('myIndex').updatePrefixSearch('disabled')
// reset prefix search settings
await client.index('myIndex').resetPrefixSearch()

// disable facet search
await client.index('myIndex').updateFacetSearch(false)
// reset facet search settings
await client.index('myIndex').resetFacetSearch()

• Update: #1773

The _matchesPosition array now contains an indices array the text was matched in an array.

When searching for fantasy in a document that has a searchable genre field with the value genre: ["fantasy", "adventure"], the matches position will be as follow:

{
  genre: [{ start: 0, length: 7, indices: [0] }]
}

Which means:

• There was a single match in the genre array (array length == 1)
• The match started as position 0 (the first character, "f")
• The match has a length of 7 (the entire "fantasy" word)
• The match was in the first item of the array (indices == [0])

⚙️ Maintenance/misc

• Update CONTRIBUTING.md with minimal Node version (#1788)

Thanks again to @Barabasbalazs, @mdubus, @irevoire, @curquiza, and @Strift. 🎉