{"id":15044624,"url":"https://github.com/elastic/app-search-javascript","last_synced_at":"2025-09-15T02:09:25.835Z","repository":{"id":35066812,"uuid":"201478061","full_name":"elastic/app-search-javascript","owner":"elastic","description":"Elastic App Search Official JavaScript Client ","archived":false,"fork":false,"pushed_at":"2024-08-08T16:09:08.000Z","size":736,"stargazers_count":67,"open_issues_count":12,"forks_count":21,"subscribers_count":30,"default_branch":"master","last_synced_at":"2025-09-14T00:36:54.468Z","etag":null,"topics":["api-client","browser","elastic","elastic-app-search","javascript","search","swiftype"],"latest_commit_sha":null,"homepage":"https://www.elastic.co/products/app-search","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/elastic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-09T13:59:19.000Z","updated_at":"2025-09-09T18:54:27.000Z","dependencies_parsed_at":"2024-09-25T01:54:14.502Z","dependency_job_id":"a27ba901-8bd4-4073-98fd-88bebe967a62","html_url":"https://github.com/elastic/app-search-javascript","commit_stats":{"total_commits":120,"total_committers":11,"mean_commits":"10.909090909090908","dds":0.3583333333333333,"last_synced_commit":"77cdb7c4ad4fe0a0ddc26ade5958e483079799bf"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/elastic/app-search-javascript","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elastic%2Fapp-search-javascript","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elastic%2Fapp-search-javascript/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elastic%2Fapp-search-javascript/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elastic%2Fapp-search-javascript/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elastic","download_url":"https://codeload.github.com/elastic/app-search-javascript/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elastic%2Fapp-search-javascript/sbom","scorecard":{"id":371173,"data":{"date":"2025-08-11","repo":{"name":"github.com/elastic/app-search-javascript","commit":"3b036678639679f55f9226a9b3de020dcd6c18ec"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.4,"checks":[{"name":"Code-Review","score":1,"reason":"Found 3/30 approved changesets -- score normalized to 1","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE.txt:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE.txt:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":5,"reason":"branch protection is not maximal on development and all release branches","details":["Info: 'allow deletion' disabled on branch 'master'","Info: 'force pushes' disabled on branch 'master'","Warn: 'branch protection settings apply to administrators' is disabled on branch 'master'","Warn: 'stale review dismissal' is disabled on branch 'master'","Warn: required approving review count is 1 on branch 'master'","Warn: codeowners review is not required on branch 'master'","Warn: 'last push approval' is disabled on branch 'master'","Info: status check found to merge onto on branch 'master'","Info: PRs are required in order to make changes on branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: github.com/elastic/.github/SECURITY.md:1","Info: Found linked content: github.com/elastic/.github/SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: github.com/elastic/.github/SECURITY.md:1","Info: Found text in security policy: github.com/elastic/.github/SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 5 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"27 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-cwfw-4gq5-mrqx","Warn: Project is vulnerable to: GHSA-g95f-p29q-9xw4","Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-jc84-3g44-wf2q","Warn: Project is vulnerable to: GHSA-jchw-25xp-jwwc","Warn: Project is vulnerable to: GHSA-cxjh-pqwp-8mfp","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h","Warn: Project is vulnerable to: GHSA-4xcv-9jjx-gfj3","Warn: Project is vulnerable to: GHSA-7wpw-2hjm-89gp","Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv","Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m","Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h","Warn: Project is vulnerable to: GHSA-w7rc-rwvf-8q5r","Warn: Project is vulnerable to: GHSA-r683-j2x4-v87g","Warn: Project is vulnerable to: GHSA-5fw9-fq32-wv5p","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-gcx4-mw62-g8wm","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw","Warn: Project is vulnerable to: GHSA-52f5-9888-hmc6","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3","Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7","Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q","Warn: Project is vulnerable to: GHSA-p9pc-299p-vxgp"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-18T12:59:56.412Z","repository_id":35066812,"created_at":"2025-08-18T12:59:56.412Z","updated_at":"2025-08-18T12:59:56.412Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275194018,"owners_count":25421441,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-15T02:00:09.272Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-client","browser","elastic","elastic-app-search","javascript","search","swiftype"],"created_at":"2024-09-24T20:50:49.125Z","updated_at":"2025-09-15T02:09:25.760Z","avatar_url":"https://github.com/elastic.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://github.com/elastic/app-search-javascript/blob/master/logo-app-search.png?raw=true\" alt=\"Elastic App Search Logo\"\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://circleci.com/gh/elastic/app-search-javascript\"\u003e\u003cimg src=\"https://circleci.com/gh/elastic/app-search-javascript.svg?style=svg\" alt=\"CircleCI buidl\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n\u003e A first-party JavaScript client for building excellent, relevant search experiences with [Elastic App Search](https://www.elastic.co/products/app-search).\n\n## Contents\n\n- [Getting started](#getting-started-)\n- [Versioning](#versioning)\n- [Browser support](#browser-support)\n- [Usage](#usage)\n- [Running tests](#running-tests)\n- [Development](#development)\n- [FAQ](#faq-)\n- [Contribute](#contribute-)\n- [License](#license-)\n\n---\n\n## Getting started 🐣\n\n### Install from a CDN\n\nThe easiest way to install this client is to simply include the built distribution from the [jsDelivr](https://www.jsdelivr.com/) CDN.\n\n```html\n\u003cscript src=\"https://cdn.jsdelivr.net/npm/@elastic/app-search-javascript@8.13.0/dist/elastic_app_search.umd.js\"\u003e\u003c/script\u003e\n```\n\nThis will make the client available globally at:\n\n```javascript\nwindow.ElasticAppSearch;\n```\n\n### Install from NPM\n\nThis package can also be installed with `npm` or `yarn`.\n\n```\nnpm install --save @elastic/app-search-javascript\n```\n\nThe client could then be included into your project like follows:\n\n```javascript\n// CommonJS\nvar ElasticAppSearch = require(\"@elastic/app-search-javascript\");\n\n// ES\nimport * as ElasticAppSearch from \"@elastic/app-search-javascript\";\n```\n\n## Versioning\n\nThis client is versioned and released alongside App Search.\n\nTo guarantee compatibility, use the most recent version of this library within the major version of the corresponding App Search implementation.\n\nFor example, for App Search `7.3`, use `7.3` of this library or above, but not `8.0`.\n\nIf you are using the [SaaS version available on swiftype.com](https://app.swiftype.com/as) of App Search, you should use the version 7.5.x of the client.\n\n## Browser support\n\nThe client is compatible with all modern browsers.\n\nNote that this library depends on the [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API).\n\nThis is not supported by Internet Explorer. If you need backwards compatibility\nfor Internet Explorer, you'll need to polyfill the Fetch API with something\nlike https://github.com/github/fetch.\n\n## Usage\n\n### Setup: Configuring the client and authentication\n\nUsing this client assumes that you have already an instance of [Elastic App Search](https://www.elastic.co/products/app-search) up and running.\n\nThe client is configured using the `searchKey`, `endpointBase`, and `engineName` parameters.\n\n```javascript\nvar client = ElasticAppSearch.createClient({\n  searchKey: \"search-mu75psc5egt9ppzuycnc2mc3\",\n  endpointBase: \"http://127.0.0.1:3002\",\n  engineName: \"favorite-videos\"\n});\n```\n\n\\* Please note that you should only ever use a **Public Search Key** within Javascript code on the browser. By default, your account should have a Key prefixed with `search-` that is read-only. More information can be found in the [documentation](https://swiftype.com/documentation/app-search/authentication).\n\n### Swiftype.com App Search users:\n\nWhen using the [SaaS version available on swiftype.com](https://app.swiftype.com/as) of App Search, you can configure the client using your `hostIdentifier` instead of the `endpointBase` parameter.\nThe `hostIdentifier` can be found within the [Credentials](https://app.swiftype.com/as#/credentials) menu.\n\n```javascript\nvar client = ElasticAppSearch.createClient({\n  hostIdentifier: \"host-c5s2mj\",\n  searchKey: \"search-mu75psc5egt9ppzuycnc2mc3\",\n  engineName: \"favorite-videos\"\n});\n```\n\n### List of configuration options:\n\n| Option            | Required | Description                                                                                                                                                                                                                                                                                                                                         |\n| ----------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| hostIdentifier    | No       | Your **Host Identifier**, should start with `host-`. Required unless explicitly setting `endpointBase`                                                                                                                                                                                                                                              |\n| searchKey         | No       | Your **Public Search Key**. It should start with `search-`.\u003cbr/\u003e\u003cbr/\u003eNOTE: This is not _technically_ required, but in 99% of cases it should be provided. There is a small edge case for not providing this, mainly useful for internal App Search usage, where this can be ommited in order to leverage App Search's session based authentication. |\n| engineName        | Yes      |                                                                                                                                                                                                                                                                                                                                                     |\n| endpointBase      | No       | Overrides the base of the App Search API endpoint completely. Useful when proxying the App Search API, developing against a local server, or a Self-Managed or Cloud Deployment. Ex. \"http://localhost:3002\"                                                                                                                                        |\n| cacheResponses    | No       | Whether or not API responses should be cached. Default: `true`.                                                                                                                                                                                                                                                                                     |\n| additionalHeaders | No       | An Object with keys and values that will be converted to header names and values on all API requests                                                                                                                                                                                                                                                |\n\n### API Methods\n\nThis client is a thin interface to the Elastic App Search API. Additional details for requests and responses can be\nfound in the [documentation](https://swiftype.com/documentation/app-search).\n\n#### Searching\n\nFor the query term `lion`, a search call is constructed as follows:\n\n```javascript\nvar options = {\n  search_fields: { title: {} },\n  result_fields: { id: { raw: {} }, title: { raw: {} } }\n};\n\nclient\n  .search(\"lion\", options)\n  .then(resultList =\u003e {\n    resultList.results.forEach(result =\u003e {\n      console.log(`id: ${result.getRaw(\"id\")} raw: ${result.getRaw(\"title\")}`);\n    });\n  })\n  .catch(error =\u003e {\n    console.log(`error: ${error}`);\n  });\n```\n\nNote that `options` supports all options listed here: https://swiftype.com/documentation/app-search/guides/search.\n\nIn addition to the supported options above, we also support the following fields:\n\n| Name                           | Type          | Description                                                                                                                                                                                                                                                                                                   |\n| ------------------------------ | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| disjunctiveFacets              | Array[String] | An array of field names. Every field listed here must also be provided as a facet in the `facet` field. It denotes that a facet should be considered disjunctive. When returning counts for disjunctive facets, the counts will be returned as if no filter is applied on this field, even if one is applied. |\n| disjunctiveFacetsAnalyticsTags | Array[String] | Used in conjunction with the `disjunctiveFacets` parameter. Queries will be tagged with \"Facet-Only\" in the Analytics Dashboard unless specified here.                                                                                                                                                        |\n\n_Response_\n\nThe search method returns the response wrapped in a `ResultList` type:\n\n```javascript\nResultList {\n  rawResults: [], // List of raw `results` from JSON response\n  rawInfo: { // Object wrapping the raw `meta` property from JSON response\n    meta: {}\n  },\n  results: [ResultItem], // List of `results` wrapped in `ResultItem` type\n  info: { // Currently the same as `rawInfo`\n    meta: {}\n  }\n}\n\nResultItem {\n  getRaw(fieldName), // Returns the HTML-unsafe raw value for a field, if it exists\n  getSnippet(fieldName) // Returns the HTML-safe snippet value for a field, if it exists\n}\n```\n\n#### Query Suggestion\n\n```javascript\nvar options = {\n  size: 3,\n  types: {\n    documents: {\n      fields: [\"name\"]\n    }\n  }\n};\n\nclient\n  .querySuggestion(\"cat\", options)\n  .then(response =\u003e {\n    response.results.documents.forEach(document =\u003e {\n      console.log(document.suggestion);\n    });\n  })\n  .catch(error =\u003e {\n    console.log(`error: ${error}`);\n  });\n```\n\n#### Multi Search\n\nIt is possible to run multiple queries at once using the `multiSearch` method.\n\nTo search for the term `lion` and `tiger`, a search call is constructed as follows:\n\n```javascript\nvar options = {\n  search_fields: { name: {} },\n  result_fields: { id: { raw: {} }, title: { raw: {} } }\n};\n\nclient\n  .multiSearch([{ query: \"node\", options }, { query: \"java\", options }])\n  .then(allResults =\u003e {\n    allResults.forEach(resultList =\u003e {\n      resultList.results.forEach(result =\u003e {\n        console.log(\n          `id: ${result.getRaw(\"id\")} raw: ${result.getRaw(\"title\")}`\n        );\n      });\n    });\n  })\n  .catch(error =\u003e {\n    console.log(`error: ${error}`);\n  });\n```\n\n#### Clickthrough Tracking\n\n```javascript\nclient\n  .click({\n    query: \"lion\",\n    documentId: \"1234567\",\n    requestId: \"8b55561954484f13d872728f849ffd22\",\n    tags: [\"Animal\"]\n  })\n  .catch(error =\u003e {\n    console.log(`error: ${error}`);\n  });\n```\n\nClickthroughs can be tracked by binding `client.click` calls to click events on individual search result links.\n\nThe following example shows how this can be implemented declaratively by annotating links with class and data attributes.\n\n```javascript\ndocument.addEventListener(\"click\", function(e) {\n  const el = e.target;\n  if (!el.classList.contains(\"track-click\")) return;\n\n  client.click({\n    query: el.getAttribute(\"data-query\"),\n    documentId: el.getAttribute(\"data-document-id\"),\n    requestId: el.getAttribute(\"data-request-id\"),\n    tags: [el.getAttribute(\"data-tag\")]\n  });\n});\n```\n\n```html\n\u003ca\n  href=\"/items/1234567\"\n  class=\"track-click\"\n  data-request-id=\"8b55561954484f13d872728f849ffd22\"\n  data-document-id=\"1234567\"\n  data-query=\"lion\"\n  data-tag=\"Animal\"\n\u003e\n  Item 1\n\u003c/a\u003e\n```\n\n## Running tests\n\nThe specs in this project use [node-replay](https://github.com/assaf/node-replay) to capture responses.\n\nThe responses are then checked against Jest snapshots.\n\nTo capture new responses and update snapshots, run:\n\n```\nnvm use\nREPLAY=record npm run test -u\n```\n\nTo run tests:\n\n```\nnvm use\nnpm run test\n```\n\n## Development\n\n### Node\n\nYou will probably want to install a node version manager, like nvm.\n\nWe depend upon the version of node defined in [.nvmrc](.nvmrc).\n\nTo install and use the correct node version with nvm:\n\n```\nnvm install\n```\n\n### Dev Server\n\nInstall dependencies:\n\n```bash\nnvm use\nnpm install\n```\n\nBuild artifacts in `dist` directory:\n\n```bash\n# This will create files in the `dist` directory\nnpm run build\n```\n\nAdd an `index.html` file to your `dist` directory\n\n```html\n\u003chtml\u003e\n  \u003chead\u003e\n    \u003cscript src=\"elastic_app_search.umd.js\"\u003e\u003c/script\u003e\n  \u003c/head\u003e\n  \u003cbody\u003e\n\n  \u003c/body\u003e\n\u003c/html\u003e\n```\n\nRun dev server:\n\n```bash\n# This will serve files in the `dist` directory\nnpm run dev\n```\n\nNavigate to http://127.0.0.1:8080 and execute JavaScript commands through the browser Dev Console.\n\n### Build\n\n```\nnvm use\nnpm run build\n```\n\n### Publish\n\n```\nnvm use\nnpm run publish\n```\n\n## FAQ 🔮\n\n### What if I need write operations?\n\nApp Search has a first-party [Node.js](https://github.com/elastic/app-search-node) client which supports write operations like indexing.\n\n### Where do I report issues with the client?\n\nIf something is not working as expected, please open an [issue](https://github.com/elastic/app-search-javascript/issues/new).\n\n### Where can I learn more about App Search?\n\nYour best bet is to read the [documentation](https://swiftype.com/documentation/app-search).\n\n### Where else can I go to get help?\n\nYou can checkout the [Elastic App Search community discuss forums](https://discuss.elastic.co/c/app-search).\n\n## Contribute 🚀\n\nWe welcome contributors to the project. Before you begin, a couple notes...\n\n- Prior to opening a pull request, please create an issue to [discuss the scope of your proposal](https://github.com/elastic/app-search-javascript/issues).\n- Please write simple code and concise documentation, when appropriate.\n\n## License 📗\n\n[Apache 2.0](https://github.com/elastic/app-search-javascript/blob/master/LICENSE.txt) © [Elastic](https://github.com/elastic)\n\nThank you to all the [contributors](https://github.com/elastic/app-search-javascript/graphs/contributors)!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felastic%2Fapp-search-javascript","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felastic%2Fapp-search-javascript","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felastic%2Fapp-search-javascript/lists"}