firestore-meilisearch 0.1.3-beta.0 → 0.1.3-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +128 -0
- package/lib/version.js +1 -1
- package/package.json +1 -1
- package/src/version.ts +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
<h1 align="center">firestore-meilisearch</h1>
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<img src="https://raw.githubusercontent.com/meilisearch/integration-guides/main/assets/logos/meilisearch_firebase.svg" alt="Meilisearch-Firestore" width="200" height="200" />
|
|
5
|
+
</p>
|
|
6
|
+
|
|
7
|
+
<h1 align="center">Meilisearch Firestore</h1>
|
|
8
|
+
|
|
9
|
+
<h4 align="center">
|
|
10
|
+
<a href="https://github.com/meilisearch/meilisearch">Meilisearch</a> |
|
|
11
|
+
<a href="https://docs.meilisearch.com">Documentation</a> |
|
|
12
|
+
<a href="https://slack.meilisearch.com">Slack</a> |
|
|
13
|
+
<a href="https://roadmap.meilisearch.com/tabs/1-under-consideration">Roadmap</a> |
|
|
14
|
+
<a href="https://www.meilisearch.com">Website</a> |
|
|
15
|
+
<a href="https://docs.meilisearch.com/faq">FAQ</a>
|
|
16
|
+
</h4>
|
|
17
|
+
|
|
18
|
+
<p align="center">
|
|
19
|
+
<a href="https://github.com/meilisearch/firestore-meilisearch/actions"><img src="https://github.com/meilisearch/firestore-meilisearch/workflows/Tests/badge.svg" alt="Test"></a>
|
|
20
|
+
<a href="https://github.com/meilisearch/firestore-meilisearch/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-informational" alt="License"></a>
|
|
21
|
+
<a href="https://ms-bors.herokuapp.com/repositories/8"><img src="https://bors.tech/images/badge_small.svg" alt="Bors enabled"></a>
|
|
22
|
+
</p>
|
|
23
|
+
|
|
24
|
+
<p align="center">⚡ The Meilisearch API extension written for Firebase</p>
|
|
25
|
+
|
|
26
|
+
# Search in your Firestore content with Meilisearch
|
|
27
|
+
|
|
28
|
+
**Author**: Meilisearch (**[https://meilisearch.com](https://meilisearch.com)**)
|
|
29
|
+
|
|
30
|
+
**Description**: Full-text Search on Firebase with Meilisearch
|
|
31
|
+
|
|
32
|
+
**Details**: Use this extension to synchronize documents from a Cloud Firestore collection to a Meilisearch index. This allows you to use full-text search in your Cloud Firestore documents.
|
|
33
|
+
|
|
34
|
+
This extension listens to each creation, update, or deletion of your documents to keep them in sync with your Meilisearch index. This ensures that the data in Meilisearch mirrors your content in Cloud Firestore. You can then run queries on this mirrored dataset.
|
|
35
|
+
|
|
36
|
+
Note that this extension only listens for changes to _documents_ in a specific collection, but not changes in any _subcollection_. However, you can install additional instances of this extension to listen to other collections in your Firestore database.
|
|
37
|
+
|
|
38
|
+
#### Additional setup
|
|
39
|
+
|
|
40
|
+
Before installing this extension, you'll need to:
|
|
41
|
+
|
|
42
|
+
- [Set up Cloud Firestore in your Firebase project](https://firebase.google.com/docs/firestore/quickstart)
|
|
43
|
+
- Run a Meilisearch instance. There are many easy ways [to download and run a Meilisearch instance](https://docs.meilisearch.com/learn/getting_started/installation.html#download-and-launch)
|
|
44
|
+
|
|
45
|
+
#### Data import format
|
|
46
|
+
|
|
47
|
+
Documents indexed in Meilisearch must have a [unique id](https://docs.meilisearch.com/learn/core_concepts/documents.html#primary-field). The extension will use Firestone's default field: `Document ID` for this purpose. `Document ID` will be renamed to`_firestore_id` to be used as the [document id](https://docs.meilisearch.com/learn/core_concepts/documents.html#document-id). If your documents have another field containing the string `id`, it will not be set as the primary key.
|
|
48
|
+
|
|
49
|
+
**Important:** If your documents contain a field called `_firestore_id`, it will be ignored.
|
|
50
|
+
|
|
51
|
+
[Geosearch](https://docs.meilisearch.com/reference/features/geosearch.html#geosearch) has a specific format in Meilisearch, your documents must have a valid `_geo` field with an object composed of `lat` and `lng`. If a `GeoPoint` from Firestore with the name `_geo` is found, the field `latitude` is renamed to `lat` and `longitude` to `lng`.
|
|
52
|
+
If a `GeoPoint` is found without the name `_geo`, it is added as an array.
|
|
53
|
+
|
|
54
|
+
#### Backfill your Meilisearch data
|
|
55
|
+
|
|
56
|
+
This extension does not export all existing documents into Meilisearch unless they have been modified or created after its installation. You can run the [import script](https://github.com/meilisearch/firestore-meilisearch/) provided by this extension to retrieve your Meilisearch dataset with all the documents present in your Firestore collection
|
|
57
|
+
|
|
58
|
+
#### Billing
|
|
59
|
+
|
|
60
|
+
To install an extension, your project must be on the [Blaze (pay as you go) plan](https://firebase.google.com/pricing)
|
|
61
|
+
|
|
62
|
+
* You will be charged a small amount (typically around $0.01/month) for the Firebase resources required by this extension, even if it is not used.
|
|
63
|
+
* This extension uses other Firebase or Google Cloud services which may have
|
|
64
|
+
associated charges if you exceed the service’s free tier:
|
|
65
|
+
* Cloud Firestore
|
|
66
|
+
* Cloud Functions (Node.js 10+ runtime. [See FAQs](https://firebase.google.com/support/faq#extensions-pricing))
|
|
67
|
+
|
|
68
|
+
When you use Firebase extensions, you're only charged for the underlying
|
|
69
|
+
resources that you use. A paid-tier billing plan is only required if the
|
|
70
|
+
extension uses a service that requires a paid-tier plan, for example calling
|
|
71
|
+
a Google Cloud API or making outbound network requests to non-Google services.
|
|
72
|
+
All Firebase services offer a free tier of usage.
|
|
73
|
+
[Learn more about Firebase billing.](https://firebase.google.com/pricing)
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
**Configuration Parameters:**
|
|
79
|
+
|
|
80
|
+
* Cloud Functions location: Where do you want to deploy the functions created for this extension? If you need help selecting a location, refer to the [location selection guide](https://firebase.google.com/docs/functions/locations).
|
|
81
|
+
|
|
82
|
+
* Collection path: What is the path of the collection you would like to export into Meilisearch?
|
|
83
|
+
|
|
84
|
+
* Fields to index in Meilisearch: What fields do you want to index in Meilisearch? Create a comma-separated list of the field names, or leave it blank to include all fields. The id field is always indexed even when omitted from the list.
|
|
85
|
+
|
|
86
|
+
* Meilisearch Index Name: What Meilisearch index do you want to index your data in?
|
|
87
|
+
|
|
88
|
+
* Meilisearch host: What is the URL of the host of your Meilisearch database? Make sure your URL starts with `http://` or `https://`
|
|
89
|
+
|
|
90
|
+
* Meilisearch API key: What is your Meilisearch API key with permission to perform actions on indexes? Both the API keys and the master key are valid choices but we strongly recommend using an API key for security purposes. Check out our guide on [security](https://docs.meilisearch.com/learn/security/master_api_keys.html).
|
|
91
|
+
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
**Cloud Functions:**
|
|
95
|
+
|
|
96
|
+
* **indexingWorker:** Cloud function triggered by document modification in Firestore to import changes into Meilisearch.
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
## 🧩 Install this extension
|
|
101
|
+
|
|
102
|
+
### Console
|
|
103
|
+
|
|
104
|
+
[][install-link]
|
|
105
|
+
|
|
106
|
+
[install-link]: https://console.firebase.google.com/project/_/extensions/install?ref=publisher_id/extension_name
|
|
107
|
+
|
|
108
|
+
### Firebase CLI
|
|
109
|
+
|
|
110
|
+
```bash
|
|
111
|
+
firebase ext:install meilisearch/firestore-meilisearch --project=[your-project-id]
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
> Learn more about installing extensions in the Firebase Extensions documentation:
|
|
115
|
+
> [console](https://firebase.google.com/docs/extensions/install-extensions?platform=console),
|
|
116
|
+
> [CLI](https://firebase.google.com/docs/extensions/install-extensions?platform=cli)
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
## ⚙️ Development Workflow and Contributing
|
|
121
|
+
|
|
122
|
+
Any new contribution is more than welcome in this project!
|
|
123
|
+
|
|
124
|
+
If you want to know more about the development workflow or wish to contribute, please see our [contributing guidelines](/CONTRIBUTING.md) for detailed instructions!
|
|
125
|
+
|
|
126
|
+
<hr>
|
|
127
|
+
|
|
128
|
+
**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**. If you wish to contribute, make suggestions, or want to know what's going on right now, visit the [integration-guides](https://github.com/meilisearch/integration-guides) repository.
|
package/lib/version.js
CHANGED
package/package.json
CHANGED
package/src/version.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export const version = '0.1.3-beta.
|
|
1
|
+
export const version = '0.1.3-beta.1'
|