itemsjs/docs/minisearch-integration.md

Created to perform fast search on small json dataset (up to 1000 elements).

# MiniSearch integration

```js
const MiniSearch = require('minisearch');
const ItemsJS = require('itemsjs');

const data = [{
  id: 1,
  title: 'Moby Dick',
  text: 'Call me Ishmael. Some years ago...',
  category: 'fiction'
},
{
  id: 2,
  title: 'Zen and the Art of Motorcycle Maintenance',
  text: 'I can see by my watch...',
  category: 'fiction'
},
{
  id: 3,
  title: 'Neuromancer',
  text: 'The sky above the port was...',
  category: 'fiction'
},
{
  id: 4,
  title: 'Zen and the Art of Archery',
  text: 'At first sight it must seem...',
  category: 'non-fiction'
}];

// minisearch full text instance
let miniSearch = new MiniSearch({
  fields: ['title', 'text', 'category'],
});

// indexing documents into minisearch
miniSearch.addAll(data);

// configuration for itemsjs faceted search
const configuration = {
  native_search_enabled: false,
  aggregations: {
    category: {
      title: 'Categories',
      size: 10,
      conjunction: true
    }
  }
}

// indexing data into itemsjs
const itemsjs = ItemsJS(data, configuration);



// full text search 
const search_results = miniSearch.search('sky')

const result = itemsjs.search({
  per_page: 3,
  // important! providing ids from full text search
  ids: search_results.map(v => v.id),
  filters: {
    category: ['fiction'],
  }
});

console.log(result);
```