From 0368ca276aec8fb285574c11464bea58e48b2b4c Mon Sep 17 00:00:00 2001 From: Strift Date: Thu, 5 Jun 2025 14:37:20 +0800 Subject: [PATCH 1/4] Rebase and fix conflicts --- README.md | 751 +----------------------------------------------------- 1 file changed, 5 insertions(+), 746 deletions(-) diff --git a/README.md b/README.md index 7123a8591..488f7ea91 100644 --- a/README.md +++ b/README.md @@ -37,13 +37,14 @@ - [🤖 Compatibility with Meilisearch](#-compatibility-with-meilisearch) - [💡 Learn more](#-learn-more) - [⚙️ Contributing](#️-contributing) -- [📜 API resources](#-api-resources) ## 📖 Documentation -This readme and [Meilisearch JS documentation website](https://meilisearch.github.io/meilisearch-js/) contains all the information you need to start using this Meilisearch SDK. - -For general information on how to use Meilisearch—such as our API reference, tutorials, guides, and in-depth articles—refer to our [main documentation website](https://www.meilisearch.com/docs/). +- [client library documentation](https://meilisearch.github.io/meilisearch-js/modules.html) + ─ information on each exported item of this package +- [main documentation website](https://www.meilisearch.com/docs/) ─ general + information on how to use Meilisearch—such as our API reference, tutorials, + guides, and in-depth articles ## 🔧 Installation @@ -424,748 +425,6 @@ This repository also contains [more examples](./examples). We welcome all contributions, big and small! If you want to know more about this SDK's development workflow or want to contribute to the repo, please visit our [contributing guidelines](/CONTRIBUTING.md) for detailed instructions. -## 📜 API resources - -### Search - -#### [Make a search request](https://www.meilisearch.com/docs/reference/api/search) - -```ts -client.index('xxx').search(query: string, options: SearchParams = {}, config?: Partial): Promise> -``` - -#### [Make a search request using the GET method (slower than the search method)](https://www.meilisearch.com/docs/reference/api/search#search-in-an-index-with-get-route) - -```ts -client.index('xxx').searchGet(query: string, options: SearchParams = {}, config?: Partial): Promise> -``` - -### Multi Search - -#### [Make multiple search requests](https://www.meilisearch.com/docs/reference/api/multi_search#multi-search) - -```ts -client.multiSearch(queries?: MultiSearchParams, config?: Partial): Promise>> -``` - -`multiSearch` uses the `POST` method when performing its request to Meilisearch. - -### Search For Facet Values - -#### [Search for facet values](https://www.meilisearch.com/docs/reference/api/facet_search#perform-a-facet-search) - -```ts -client.index('myIndex').searchForFacetValues(params: SearchForFacetValuesParams, config?: Partial): Promise -``` - -### Documents - -#### [Add or replace multiple documents](https://www.meilisearch.com/docs/reference/api/documents#add-or-replace-documents) - -```ts -client.index('myIndex').addDocuments(documents: Document[]): Promise -``` - -#### [Add or replace multiple documents in string format](https://www.meilisearch.com/docs/reference/api/documents#add-or-update-documents) - -```ts -client.index('myIndex').addDocumentsFromString(documents: string, contentType: ContentType, queryParams: RawDocumentAdditionOptions): Promise -``` - -#### [Add or replace multiple documents in batches](https://www.meilisearch.com/docs/reference/api/documents#add-or-replace-documents) - -```ts -client.index('myIndex').addDocumentsInBatches(documents: Document[], batchSize = 1000): Promise -``` - -#### [Add or update multiple documents](https://www.meilisearch.com/docs/reference/api/documents#add-or-update-documents) - -```ts -client.index('myIndex').updateDocuments(documents: Array>>): Promise -``` - -#### [Add or update multiple documents in string format](https://www.meilisearch.com/docs/reference/api/documents#add-or-update-documents) - -```ts -client.index('myIndex').updateDocumentsFromString(documents: string, contentType: ContentType, queryParams: RawDocumentAdditionOptions): Promise -``` - -#### [Add or update multiple documents in batches](https://www.meilisearch.com/docs/reference/api/documents#add-or-update-documents) - -```ts -client.index('myIndex').updateDocumentsInBatches(documents: Array>>, batchSize = 1000): Promise -``` - -#### [Get Documents](https://www.meilisearch.com/docs/reference/api/documents#get-documents) - -```ts -client.index.getDocuments(parameters: DocumentsQuery = {}): Promise>> -``` - -#### [Get one document](https://www.meilisearch.com/docs/reference/api/documents#get-one-document) - -```ts -client.index('myIndex').getDocument(documentId: string): Promise> -``` - -#### [Delete one document](https://www.meilisearch.com/docs/reference/api/documents#delete-one-document) - -```ts -client.index('myIndex').deleteDocument(documentId: string | number): Promise -``` - -#### [Delete multiple documents](https://www.meilisearch.com/docs/reference/api/documents#delete-documents) - -```ts -client.index('myIndex').deleteDocuments(params: DocumentsDeletionQuery | DocumentsIds): Promise -``` - -#### [Delete all documents](https://www.meilisearch.com/docs/reference/api/documents#delete-all-documents) - -```ts -client.index('myIndex').deleteAllDocuments(): Promise -``` - -### Tasks - -#### [Get all tasks](https://www.meilisearch.com/docs/reference/api/tasks#get-all-tasks) - -```ts -client.tasks.getTasks(parameters: TasksQuery): Promise -``` - -#### [Get one task](https://www.meilisearch.com/docs/reference/api/tasks) - -```ts -client.tasks.getTask(uid: number): Promise -``` - -#### [Delete tasks](https://www.meilisearch.com/docs/reference/api/tasks#delete-tasks) - -```ts -client.tasks.deleteTasks(parameters: DeleteTasksQuery = {}): Promise -``` - -#### [Cancel tasks](https://www.meilisearch.com/docs/reference/api/tasks#cancel-tasks) - -```ts -client.tasks.cancelTasks(parameters: CancelTasksQuery = {}): Promise -``` - -#### [Get all tasks of an index](https://www.meilisearch.com/docs/reference/api/tasks#get-all-tasks-by-index) - -```ts -client.index('myIndex').tasks.getTasks(parameters: TasksQuery): Promise -``` - -#### [Get one task of an index](https://www.meilisearch.com/docs/reference/api/tasks) - -```ts -client.index('myIndex').tasks.getTask(uid: number): Promise -``` - -#### Wait for one task - -```ts -client.tasks.waitForTask(uid: number, { timeout?: number, interval?: number }): Promise -``` - -#### Wait for multiple tasks - -```ts -client.tasks.waitForTasks(uids: number[], { timeout?: number, interval?: number }): Promise -``` - -### Batches - -#### [Get one batch](https://www.meilisearch.com/docs/reference/api/batches#get-one-batch) - -```ts -client.batches.getBatch(uid: number): Promise -``` - -#### [Get all batches](https://www.meilisearch.com/docs/reference/api/batchess#get-batches) - -```ts -client.batches.getBatches(parameters: BatchesQuery = {}): Promise -``` - -### Indexes - -#### [Get all indexes in Index instances](https://www.meilisearch.com/docs/reference/api/indexes#list-all-indexes) - -```ts -client.getIndexes(parameters: IndexesQuery): Promise> -``` - -#### [Get all indexes](https://www.meilisearch.com/docs/reference/api/indexes#list-all-indexes) - -```ts -client.getRawIndexes(parameters: IndexesQuery): Promise> -``` - - -#### [Create a new index](https://www.meilisearch.com/docs/reference/api/indexes#create-an-index) - -```ts -client.createIndex(uid: string, options?: IndexOptions): Promise -``` - -#### Create a local reference to an index - -```ts -client.index(uid: string): Index -``` - -#### [Get an index instance completed with information fetched from Meilisearch](https://www.meilisearch.com/docs/reference/api/indexes#get-one-index) - -```ts -client.getIndex(uid: string): Promise> -``` - -#### [Get the raw index JSON response from Meilisearch](https://www.meilisearch.com/docs/reference/api/indexes#get-one-index) - -```ts -client.getRawIndex(uid: string): Promise -``` - -#### [Get an object with information about the index](https://www.meilisearch.com/docs/reference/api/indexes#get-one-index) - -```ts -client.index('myIndex').getRawInfo(): Promise -``` - -#### [Update Index](https://www.meilisearch.com/docs/reference/api/indexes#update-an-index) - -##### Using the client - -```ts -client.updateIndex(uid: string, options: IndexOptions): Promise -``` - -##### Using the index object - -```ts -client.index('myIndex').update(data: IndexOptions): Promise -``` - -#### [Delete index](https://www.meilisearch.com/docs/reference/api/indexes#delete-an-index) - -##### Using the client -```ts -client.deleteIndex(uid): Promise -``` - -##### Using the index object -```ts -client.index('myIndex').delete(): Promise -``` - -#### [Get specific index stats](https://www.meilisearch.com/docs/reference/api/stats#get-stats-of-an-index) - -```ts -client.index('myIndex').getStats(): Promise -``` - -##### Return Index instance with updated information - -```ts -client.index('myIndex').fetchInfo(): Promise -``` - -##### Get Primary Key of an Index - -```ts -client.index('myIndex').fetchPrimaryKey(): Promise -``` - -##### Swap two indexes - -```ts -client.swapIndexes(params: SwapIndexesParams): Promise -``` - -### Settings - -#### [Get settings](https://www.meilisearch.com/docs/reference/api/settings#get-settings) - -```ts -client.index('myIndex').getSettings(): Promise -``` - -#### [Update settings](https://www.meilisearch.com/docs/reference/api/settings#update-settings) - -```ts -client.index('myIndex').updateSettings(settings: Settings): Promise -``` - -#### [Reset settings](https://www.meilisearch.com/docs/reference/api/settings#reset-settings) - -```ts -client.index('myIndex').resetSettings(): Promise -``` - -### Pagination Settings - -#### [Get pagination](https://www.meilisearch.com/docs/reference/api/settings#get-pagination-settings) - -```ts -client.index('myIndex').getPagination(): Promise -``` - -#### [Update pagination](https://www.meilisearch.com/docs/reference/api/settings#update-pagination-settings) - -```ts -client.index('myIndex').updatePagination(pagination: PaginationSettings): Promise -``` - -#### [Reset pagination](https://www.meilisearch.com/docs/reference/api/settings#reset-pagination-settings) - -```ts -client.index('myIndex').resetPagination(): Promise -``` - -### Synonyms - -#### [Get synonyms](https://www.meilisearch.com/docs/reference/api/settings#get-synonyms) - -```ts -client.index('myIndex').getSynonyms(): Promise -``` - -#### [Update synonyms](https://www.meilisearch.com/docs/reference/api/settings#update-synonyms) - -```ts -client.index('myIndex').updateSynonyms(synonyms: Synonyms): Promise -``` - -#### [Reset synonyms](https://www.meilisearch.com/docs/reference/api/settings#reset-synonyms) - -```ts -client.index('myIndex').resetSynonyms(): Promise -``` - -### Stop words - -#### [Get stop words](https://www.meilisearch.com/docs/reference/api/settings#get-stop-words) - -```ts -client.index('myIndex').getStopWords(): Promise -``` - -#### [Update stop words](https://www.meilisearch.com/docs/reference/api/settings#update-stop-words) - -```ts -client.index('myIndex').updateStopWords(stopWords: string[] | null ): Promise -``` - -#### [Reset stop words](https://www.meilisearch.com/docs/reference/api/settings#reset-stop-words) - -```ts -client.index('myIndex').resetStopWords(): Promise -``` - -### Ranking rules - -#### [Get ranking rules](https://www.meilisearch.com/docs/reference/api/settings#get-ranking-rules) - -```ts -client.index('myIndex').getRankingRules(): Promise -``` - -#### [Update ranking rules](https://www.meilisearch.com/docs/reference/api/settings#update-ranking-rules) - -```ts -client.index('myIndex').updateRankingRules(rankingRules: string[] | null): Promise -``` - -#### [Reset ranking rules](https://www.meilisearch.com/docs/reference/api/settings#reset-ranking-rules) - -```ts -client.index('myIndex').resetRankingRules(): Promise -``` - -### Distinct Attribute - -#### [Get distinct attribute](https://www.meilisearch.com/docs/reference/api/settings#get-distinct-attribute) - -```ts -client.index('myIndex').getDistinctAttribute(): Promise -``` - -#### [Update distinct attribute](https://www.meilisearch.com/docs/reference/api/settings#update-distinct-attribute) - -```ts -client.index('myIndex').updateDistinctAttribute(distinctAttribute: string | null): Promise -``` - -#### [Reset distinct attribute](https://www.meilisearch.com/docs/reference/api/settings#reset-distinct-attribute) - -```ts -client.index('myIndex').resetDistinctAttribute(): Promise -``` - -### Searchable attributes - -#### [Get searchable attributes](https://www.meilisearch.com/docs/reference/api/settings#get-searchable-attributes) - -```ts -client.index('myIndex').getSearchableAttributes(): Promise -``` - -#### [Update searchable attributes](https://www.meilisearch.com/docs/reference/api/settings#update-searchable-attributes) - -```ts -client.index('myIndex').updateSearchableAttributes(searchableAttributes: string[] | null): Promise -``` - -#### [Reset searchable attributes](https://www.meilisearch.com/docs/reference/api/settings#reset-searchable-attributes) - -```ts -client.index('myIndex').resetSearchableAttributes(): Promise -``` - -### Displayed attributes - -#### [Get displayed attributes](https://www.meilisearch.com/docs/reference/api/settings#get-displayed-attributes) - -```ts -client.index('myIndex').getDisplayedAttributes(): Promise -``` - -#### [Update displayed attributes](https://www.meilisearch.com/docs/reference/api/settings#update-displayed-attributes) - -```ts -client.index('myIndex').updateDisplayedAttributes(displayedAttributes: string[] | null): Promise -``` - -#### [Reset displayed attributes](https://www.meilisearch.com/docs/reference/api/settings#reset-displayed-attributes) - -```ts -client.index('myIndex').resetDisplayedAttributes(): Promise -``` - -### Filterable attributes - -#### [Get filterable attributes](https://www.meilisearch.com/docs/reference/api/settings#get-filterable-attributes) - -```ts -client.index('myIndex').getFilterableAttributes(): Promise -``` - -#### [Update filterable attributes](https://www.meilisearch.com/docs/reference/api/settings#update-filterable-attributes) - -```ts -client.index('myIndex').updateFilterableAttributes(filterableAttributes: string[] | null): Promise -``` - -#### [Reset filterable attributes](https://www.meilisearch.com/docs/reference/api/settings#reset-filterable-attributes) - -```ts -client.index('myIndex').resetFilterableAttributes(): Promise -``` - -### Sortable attributes - -#### [Get sortable attributes](https://www.meilisearch.com/docs/reference/api/settings#get-sortable-attributes) - -```ts -client.index('myIndex').getSortableAttributes(): Promise -``` - -#### [Update sortable attributes](https://www.meilisearch.com/docs/reference/api/settings#update-sortable-attributes) - -```ts -client.index('myIndex').updateSortableAttributes(sortableAttributes: string[] | null): Promise -``` - -#### [Reset sortable attributes](https://www.meilisearch.com/docs/reference/api/settings#reset-sortable-attributes) - -```ts -client.index('myIndex').resetSortableAttributes(): Promise -``` - -### Faceting - -#### [Get faceting](https://www.meilisearch.com/docs/reference/api/settings#get-faceting-settings) - -```ts -client.index('myIndex').getFaceting(): Promise -``` - -#### [Update faceting](https://www.meilisearch.com/docs/reference/api/settings#update-faceting-settings) - -```ts -client.index('myIndex').updateFaceting(faceting: Faceting): Promise -``` - -#### [Reset faceting](https://www.meilisearch.com/docs/reference/api/settings#reset-faceting-settings) - -```ts -client.index('myIndex').resetFaceting(): Promise -``` - -### Typo tolerance - -#### [Get typo tolerance](https://www.meilisearch.com/docs/reference/api/settings#get-typo-tolerance-settings) - -```ts -client.index('myIndex').getTypoTolerance(): Promise -``` - -#### [Update typo tolerance](https://www.meilisearch.com/docs/reference/api/settings#update-typo-tolerance-settings) - -```ts -client.index('myIndex').updateTypoTolerance(typoTolerance: TypoTolerance | null): Promise -``` - -#### [Reset typo tolerance](https://www.meilisearch.com/docs/reference/api/settings#reset-typo-tolerance-settings) - -```ts -client.index('myIndex').resetTypoTolerance(): Promise -``` - - -### Separator tokens - -#### [Get separator tokens](https://www.meilisearch.com/docs/reference/api/settings#get-separator-tokens) - -```ts -client.index('myIndex').getSeparatorTokens(): Promise -``` - -#### [Update separator tokens](https://www.meilisearch.com/docs/reference/api/settings#update-separator-tokens) - -```ts -client.index('myIndex').updateSeparatorTokens(separatorTokens: SeparatorTokens | null): Promise -``` - -#### [Reset separator tokens](https://www.meilisearch.com/docs/reference/api/settings#reset-separator-tokens) - -```ts -client.index('myIndex').resetSeparatorTokens(): Promise -``` - -### Non Separator tokens - -#### [Get non separator tokens](https://www.meilisearch.com/docs/reference/api/settings#get-non-separator-tokens) - -```ts -client.index('myIndex').getNonSeparatorTokens(): Promise -``` - -#### [Update non separator tokens](https://www.meilisearch.com/docs/reference/api/settings#update-non-separator-tokens) - -```ts -client.index('myIndex').updateNonSeparatorTokens(nonSeparatorTokens: NonSeparatorTokens | null): Promise -``` - -#### [Reset non separator tokens](https://www.meilisearch.com/docs/reference/api/settings#reset-non-separator-tokens) - -```ts -client.index('myIndex').resetNonSeparatorTokens(): Promise -``` - -### Dictionary - -#### [Get dictionary](https://www.meilisearch.com/docs/reference/api/settings#get-dictionary) - -```ts -client.index('myIndex').getDictionary(): Promise -``` - -#### [Update dictionary](https://www.meilisearch.com/docs/reference/api/settings#update-dictionary) - -```ts -client.index('myIndex').updateDictionary(dictionary: Dictionary | null): Promise -``` - -#### [Reset dictionary](https://www.meilisearch.com/docs/reference/api/settings#reset-dictionary) - -```ts -client.index('myIndex').resetDictionary(): Promise -``` - -### Proximity Precision - -#### [Get proximity precision](https://www.meilisearch.com/docs/reference/api/settings#get-proximity-precision-settings) - -```ts -client.index('myIndex').getProximityPrecision(): Promise -``` - -#### [Update proximity precision](https://www.meilisearch.com/docs/reference/api/settings#update-proximity-precision-settings) - -```ts -client.index('myIndex').updateProximityPrecision(proximityPrecision: ProximityPrecision): Promise -``` - -#### [Reset proximity precision](https://www.meilisearch.com/docs/reference/api/settings#reset-proximity-precision-settings) - -```ts -client.index('myIndex').resetProximityPrecision(): Promise -``` - -### Facet search settings - -#### [Get facet search settings](https://www.meilisearch.com/docs/reference/api/settings#get-facet-search-settings) - -```ts -client.index('myIndex').getFacetSearch(): Promise -``` - -#### [Update facet search settings](https://www.meilisearch.com/docs/reference/api/settings#update-facet-search-settings) - -```ts -client.index('myIndex').updateFacetSearch(enabled: boolean): Promise -``` - -#### [Reset facet search settings](https://www.meilisearch.com/docs/reference/api/settings#reset-facet-search-settings) - -```ts -client.index('myIndex').resetFacetSearch(): Promise -``` - -### Prefix search settings - -#### [Get prefix search settings](https://www.meilisearch.com/docs/reference/api/settings#get-prefix-search-settings) - -```ts -client.index('myIndex').getPrefixSearch(): Promise -``` - -#### [Update prefix search settings](https://www.meilisearch.com/docs/reference/api/settings#update-prefix-search-settings) - -```ts -client.index('myIndex').updatePrefixSearch(prefixSearch: PrefixSearch): Promise -``` - -#### [Reset prefix search settings](https://www.meilisearch.com/docs/reference/api/settings#reset-prefix-search-settings) - -```ts -client.index('myIndex').resetPrefixSearch(): Promise -``` - -### Embedders - -#### Get embedders - -```ts -client.index('myIndex').getEmbedders(): Promise -``` - -#### Update embedders - -```ts -client.index('myIndex').updateEmbedders(embedders: Embedders): Promise -``` - -#### Reset embedders - -```ts -client.index('myIndex').resetEmbedders(): Promise -``` - -### SearchCutoffMs - -#### [Get SearchCutoffMs](https://www.meilisearch.com/docs/reference/api/settings#get-search-cutoff) - -```ts -client.index('myIndex').getSearchCutoffMs(): Promise -``` - -#### [Update SearchCutoffMs](https://www.meilisearch.com/docs/reference/api/settings#update-search-cutoff) - -```ts -client.index('myIndex').updateSearchCutoffMs(searchCutoffMs: SearchCutoffMs): Promise -``` - -#### [Reset SearchCutoffMs](https://www.meilisearch.com/docs/reference/api/settings#reset-search-cutoff) - -```ts -client.index('myIndex').resetSearchCutoffMs(): Promise -``` - -### Keys - -#### [Get keys](https://www.meilisearch.com/docs/reference/api/keys#get-all-keys) - -```ts -client.getKeys(parameters: KeysQuery): Promise -``` - -#### [Get one key](https://www.meilisearch.com/docs/reference/api/keys#get-one-key) - -```ts -client.getKey(keyOrUid: string): Promise -``` - -#### [Create a key](https://www.meilisearch.com/docs/reference/api/keys#create-a-key) - -```ts -client.createKey(options: KeyCreation): Promise -``` - -#### [Update a key](https://www.meilisearch.com/docs/reference/api/keys#update-a-key) - -```ts -client.updateKey(keyOrUid: string, options: KeyUpdate): Promise -``` - -#### [Delete a key](https://www.meilisearch.com/docs/reference/api/keys#delete-a-key) - -```ts -client.deleteKey(keyOrUid: string): Promise -``` - -### `isHealthy` - -#### [Return `true` or `false` depending on the health of the server](https://www.meilisearch.com/docs/reference/api/health#get-health) - -```ts -client.isHealthy(): Promise -``` - -### Health - -#### [Check if the server is healthy](https://www.meilisearch.com/docs/reference/api/health#get-health) - -```ts -client.health(): Promise -``` - -### Stats - -#### [Get database stats](https://www.meilisearch.com/docs/reference/api/stats#get-stats-of-all-indexes) - -```ts -client.getStats(): Promise -``` - -### Version - -#### [Get binary version](https://www.meilisearch.com/docs/reference/api/version#get-version-of-meilisearch) - -```ts -client.getVersion(): Promise -``` - -### Dumps - -#### [Trigger a dump creation process](https://www.meilisearch.com/docs/reference/api/dump#create-a-dump) - -```ts -client.createDump(): Promise -``` - -### Snapshots - -#### [Trigger a snapshot on-demand process](https://www.meilisearch.com/docs/reference/api/snapshots#create-a-snapshot) - -```ts -client.createSnapshot(): Promise -``` - --- Meilisearch provides and maintains many SDKs and integration tools like this one. We want to provide everyone with an **amazing search experience for any kind of project**. For a full overview of everything we create and maintain, take a look at the [integration-guides](https://github.com/meilisearch/integration-guides) repository. From f2015fd8c422489bc7dc195c2789a631408dfc2a Mon Sep 17 00:00:00 2001 From: Strift Date: Thu, 5 Jun 2025 14:38:22 +0800 Subject: [PATCH 2/4] Remove capital S in meilisearch --- README.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 488f7ea91..62f7bfa4f 100644 --- a/README.md +++ b/README.md @@ -101,9 +101,9 @@ After installing `meilisearch-js`, you must import it into your application. The Usage in an ES module environment: ```js -import { MeiliSearch } from "meilisearch"; +import { Meilisearch } from "meilisearch"; -const client = new MeiliSearch({ +const client = new Meilisearch({ host: "http://127.0.0.1:7700", apiKey: "masterKey", }); @@ -119,7 +119,7 @@ tag: ```html ``` @@ -133,9 +133,9 @@ to read their documentation. Usage in a back-end node.js or another environment supporting CommonJS modules: ```js -const { MeiliSearch } = require("meilisearch"); +const { Meilisearch } = require("meilisearch"); -const client = new MeiliSearch({ +const client = new Meilisearch({ host: "http://127.0.0.1:7700", apiKey: "masterKey", }); @@ -150,9 +150,9 @@ To use `meilisearch-js` with React Native, you must also install [react-native-u Usage in a Deno environment: ```js -import { MeiliSearch } from "npm:meilisearch"; +import { Meilisearch } from "npm:meilisearch"; -const client = new MeiliSearch({ +const client = new Meilisearch({ host: "http://127.0.0.1:7700", apiKey: "masterKey", }); @@ -165,12 +165,12 @@ Take a look at the [playground](./playgrounds/javascript/src/meilisearch.ts) for ### Add documents ```js -const { MeiliSearch } = require('meilisearch') +const { Meilisearch } = require('meilisearch') // Or if you are in a ES environment -import { MeiliSearch } from 'meilisearch' +import { Meilisearch } from 'meilisearch' ;(async () => { - const client = new MeiliSearch({ + const client = new Meilisearch({ host: 'http://127.0.0.1:7700', apiKey: 'masterKey', }) @@ -374,7 +374,7 @@ controller.abort() You can provide a custom request configuration. for example, with custom headers. ```ts -const client: MeiliSearch = new MeiliSearch({ +const client: Meilisearch = new Meilisearch({ host: 'http://localhost:3000/api/meilisearch/proxy', requestConfig: { headers: { @@ -391,7 +391,7 @@ const client: MeiliSearch = new MeiliSearch({ You can use your own HTTP client, for example, with [`axios`](https://github.com/axios/axios). ```ts -const client: MeiliSearch = new MeiliSearch({ +const client: Meilisearch = new Meilisearch({ host: 'http://localhost:3000/api/meilisearch/proxy', httpClient: async (url, opts) => { const response = await $axios.request({ From c6e595359d5bee98c3d7fe6b8424d729109c53b1 Mon Sep 17 00:00:00 2001 From: Strift Date: Thu, 5 Jun 2025 14:41:40 +0800 Subject: [PATCH 3/4] Rebase and fix conflicts --- README.md | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 62f7bfa4f..5403c048d 100644 --- a/README.md +++ b/README.md @@ -7,11 +7,11 @@

Meilisearch | Meilisearch Cloud | - Documentation | - Discord | - Roadmap | - Website | - FAQ + Documentation | + Discord | + Roadmap | + Website | + FAQ

@@ -40,11 +40,9 @@ ## 📖 Documentation -- [client library documentation](https://meilisearch.github.io/meilisearch-js/modules.html) - ─ information on each exported item of this package -- [main documentation website](https://www.meilisearch.com/docs/) ─ general - information on how to use Meilisearch—such as our API reference, tutorials, - guides, and in-depth articles +Consult the [Meilisearch Documentation](https://www.meilisearch.com/docs/?utm_campaign=oss&utm_source=github&utm_medium=meilisearch-js) for guides, tutorials, and API reference materials on using Meilisearch. + +For detailed information about the `meilisearch-js` package, visit the [client library documentation](https://meilisearch.github.io/meilisearch-js/modules.html?utm_campaign=oss&utm_source=github&utm_medium=meilisearch-js). ## 🔧 Installation From 838c45e462867cb975ca9f700287fcba296f6f81 Mon Sep 17 00:00:00 2001 From: Strift Date: Thu, 5 Jun 2025 14:46:40 +0800 Subject: [PATCH 4/4] Update Learn more section --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 5403c048d..690eaa8ee 100644 --- a/README.md +++ b/README.md @@ -412,12 +412,12 @@ This package guarantees compatibility with [version v1.x of Meilisearch](https:/ The following sections in our main documentation website may interest you: -- **Manipulate documents**: see the [API references](https://www.meilisearch.com/docs/reference/api/documents) or read more about [documents](https://www.meilisearch.com/docs/learn/core_concepts/documents). -- **Search**: see the [API references](https://www.meilisearch.com/docs/reference/api/search) or follow our guide on [search parameters](https://www.meilisearch.com/docs/reference/api/search#search-parameters). -- **Manage the indexes**: see the [API references](https://www.meilisearch.com/docs/reference/api/indexes) or read more about [indexes](https://www.meilisearch.com/docs/learn/core_concepts/indexes). -- **Configure the index settings**: see the [API references](https://www.meilisearch.com/docs/reference/api/settings) or follow our guide on [settings parameters](https://www.meilisearch.com/docs/reference/api/settings#settings_parameters). +- **Managing documents**: see the [API reference](https://www.meilisearch.com/docs/reference/api/documents?utm_campaign=oss&utm_source=github&utm_medium=meilisearch-js) or read more about [documents](https://www.meilisearch.com/docs/learn/core_concepts/documents). +- **Searching**: see the [API reference](https://www.meilisearch.com/docs/reference/api/search?utm_campaign=oss&utm_source=github&utm_medium=meilisearch-js) or follow our guide on [search parameters](https://www.meilisearch.com/docs/reference/api/search?utm_campaign=oss&utm_source=github&utm_medium=meilisearch-js#search-parameters). +- **Managing indexes**: see the [API reference](https://www.meilisearch.com/docs/reference/api/indexes?utm_campaign=oss&utm_source=github&utm_medium=meilisearch-js) or read more about [indexes](https://www.meilisearch.com/docs/learn/core_concepts/indexes?utm_campaign=oss&utm_source=github&utm_medium=meilisearch-js). +- **Configuring indexes**: see the [API reference](https://www.meilisearch.com/docs/reference/api/settings?utm_campaign=oss&utm_source=github&utm_medium=meilisearch-js) or follow our guide on [settings parameters](https://www.meilisearch.com/docs/reference/api/settings?utm_campaign=oss&utm_source=github&utm_medium=meilisearch-js#settings_parameters). -This repository also contains [more examples](./examples). +Check out the [playgrounds](./playgrounds/) for examples of implementation. ## ⚙️ Contributing