event-builder v1.0.0

ES6 client JS that helps you log events to your server very easily.

Idea

I should be able to track user events from my Web apps easily.

Install

npm install git+ssh://git@github.com:hussaintamboli/event-builder.git

Upgrade to latest version

npm install -f git+ssh://git@github.com:hussaintamboli/event-builder.git

Import

import Event from 'event-builder';

Usage

1. Basic event builder

   let builder = new Event.Builder("http://localhost:8090/api/v1/event");
   builder = builder.app("CMS", "2.1", "en").user(234992, "Hussain", "CMS", "ade23-29df3402034-23ddl");

2. Login event

   // where builder is above basic builder
   builder = builder.type("Login")
   builder.send();

3. Page view

   builder = builder.type("PageView").page('Deal', 'Deal100');
   builder.send();

4. Button click

   builder = builder.type("ContentUpload").page("content_upload").section("upload_button").action("click");
   builder.send();

5. Create builder from json

   Basic builder is needed to send an event. But creating it everytime you want to send an event won't be feasible in your app (let's say angular app).

   You can store a json in localStorage and get it when you want to send an event. Just pass that json string to fromJson and get the builder object.

   let json = "{"url":"http://localhost:8090/api/v1/event","app_name":"CMS","version":"0.2.0","language":"en","user_id":1000,"user_info":{"name":"Hussain Tamboli","source":"Web-2","X-Authorization-Token":"293492-2932492-29349skdf-234"}}";
   let builder = new Event.Builder().fromJson(json);
   builder.send();

6. Create builder from obj

   let obj = {
           "url": "http://localhost:8090/api/v1/event",
           "app_name": "CMS",
           "version": "0.2.0",
           "language": "en",
           "user_id": 1000,
           "user_info": {
               "name": "Hussain Tamboli", 
               "source": "Web-1", 
               "X-Authorization-Token": "b29349-29349-293499-2934"
           }
   };
   let builder = new Event.Builder().fromObj(obj);
   builder.send();