{"id":18577454,"url":"https://github.com/ecomplus/search-engine","last_synced_at":"2025-04-10T09:30:51.350Z","repository":{"id":36989792,"uuid":"199517778","full_name":"ecomplus/search-engine","owner":"ecomplus","description":"Isomorphic JS lib to handle products search for E-Com Plus stores","archived":false,"fork":false,"pushed_at":"2025-03-31T16:14:23.000Z","size":2894,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-02T20:57:00.273Z","etag":null,"topics":["ecommerce-search","ecomplus","elasticsearch","products-search","search-algorithms","search-api","search-items"],"latest_commit_sha":null,"homepage":"https://developers.e-com.plus/search-engine/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ecomplus.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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-07-29T19:50:51.000Z","updated_at":"2025-02-17T17:42:20.000Z","dependencies_parsed_at":"2023-02-12T19:45:15.658Z","dependency_job_id":"edfc6292-f8d2-48a3-b05e-c9d44fe00156","html_url":"https://github.com/ecomplus/search-engine","commit_stats":{"total_commits":381,"total_committers":4,"mean_commits":95.25,"dds":"0.36745406824146987","last_synced_commit":"a5d5a23b4e7acc3c9b78d64d52e473368fa3ddc7"},"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ecomplus%2Fsearch-engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ecomplus%2Fsearch-engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ecomplus%2Fsearch-engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ecomplus%2Fsearch-engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ecomplus","download_url":"https://codeload.github.com/ecomplus/search-engine/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248191644,"owners_count":21062544,"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","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":["ecommerce-search","ecomplus","elasticsearch","products-search","search-algorithms","search-api","search-items"],"created_at":"2024-11-06T23:29:15.427Z","updated_at":"2025-04-10T09:30:50.593Z","avatar_url":"https://github.com/ecomplus.png","language":"JavaScript","readme":"# E-Com Plus Search Engine\n\n[![Publish](https://github.com/ecomplus/search-engine/workflows/Publish/badge.svg)](https://github.com/ecomplus/search-engine/actions?workflow=Publish) [![CodeFactor](https://www.codefactor.io/repository/github/ecomplus/search-engine/badge)](https://www.codefactor.io/repository/github/ecomplus/search-engine) [![npm version](https://img.shields.io/npm/v/@ecomplus/search-engine.svg)](https://www.npmjs.org/@ecomplus/search-engine) [![License MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nUMD JS lib to handle products search for E-Com Plus stores\n\n[CHANGELOG](https://github.com/ecomplus/search-engine/blob/master/CHANGELOG.md)\n\n## Usage\n\nThe `@ecomplus/search-engine` package is a wrapper for [E-Com Plus Search API](https://developers.e-com.plus/docs/api/#/search/), can be used to handle a full featured products search system, from simple items search to applying multiple filters and aggregations.\n\nIt's available for both Node.js and browser environments.\n\n- [Get started](https://developers.e-com.plus/search-engine/module-@ecomplus_search-engine.html)\n- [Class reference](https://developers.e-com.plus/search-engine/EcomSearch.html)\n\n### Example\n\n```js\nimport EcomSearch from '@ecomplus/search-engine'\n\nconst search = new EcomSearch()\n\nsearch.setSearchTerm('smartphone').fetch()\n  .then(result =\u003e {\n    search.getItems().forEach(item =\u003e {\n      console.log(item.name)\n    })\n  })\n  .catch(error =\u003e {\n    console.error(error)\n    if (error.response) {\n      console.log(error.response)\n    }\n  })\n```\n\n#### Customize search query before fetch\n\n```js\nimport EcomSearch from '@ecomplus/search-engine'\n\nEcomSearch.dslMiddlewares.push((dsl) =\u003e {\n  dsl.query.bool.filter.push({\n    terms: {\n      channel_id: [123]\n    }\n  })\n})\n```\n\n### Installation\n\nIt _may_ require and doesn't include `core-js` (optional) and [`@ecomplus/utils`](https://developers.e-com.plus/utils/) (peer dependency).\n\n#### Webpack\n\n```bash\nnpm i --save core-js @ecomplus/utils @ecomplus/search-engine\n```\n\n#### Node.js\n\n```bash\nnpm i --save @ecomplus/utils @ecomplus/search-engine\n```\n\n#### CDN\n\n```html\n\u003cscript src=\"https://cdn.jsdelivr.net/npm/@ecomplus/search-engine/dist/ecom-search.var.min.js\"\u003e\u003c/script\u003e\n```\n\nWhen importing from CDN, `_.cloneDeep`, `_.merge`, `ecomUtils` and `ecomClient` libraries **must be included separately** and available on window scope.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fecomplus%2Fsearch-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fecomplus%2Fsearch-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fecomplus%2Fsearch-engine/lists"}