@hellotext/hellotext 1.0.7 → 1.0.8

package/README.md

@@ -34,6 +34,8 @@ You can find it from the business's settings page.
 Hellotext.initialize("HELLOTEXT_BUSINESS_ID");
 ```
 
+Failing to initialize the class before calling any other method will throw a `NotInitializedError`.
+
 ## Usage
 
 Tracking events is straightforward and perhaps the simplest example is tracking a page view:
@@ -55,7 +57,7 @@ You can create the associated object directly by defining its attributes in a ha
 Hellotext.track("order.placed", {
     amount: 395.00, 
     currency: "USD",
-    order: {
+    order_attributes: {
         "amount": "395.00",
         "reference": "654321",
     }
@@ -135,7 +137,7 @@ It is possible to obtain the current session by simply calling `Hellotext.sessio
 
 ```javascript
 Hellotext.session
-// Returns c7a42761-f34d-41a2-b078-6a8172690350
+// Returns bBJn9vR15yPaYkWmR2QK0jopMeNxrA6l
 ```
 
 You may want to store the session on your backend when customers are unidentified so you can later [attach it to a profile](https://www.hellotext.com/api#attach_session) when it becomes known.

package/lib/errors/notInitializedError.js

@@ -0,0 +1,8 @@
+class NotInitializedError extends Error {
+  constructor() {
+    super("You need to initialize before tracking events. Call Hellotext.initialize and pass your public business id");
+    this.name = "NotInitializedError"
+  }
+}
+
+export { NotInitializedError }

package/lib/hellotext.js

@@ -1,3 +1,5 @@
+import { NotInitializedError } from "./errors/notInitializedError";
+
 const apiUrl = 'https://api.hellotext.com/v1/'
 
 class Hellotext {
@@ -29,6 +31,8 @@ class Hellotext {
    * @returns {Promise}
    */
   static async track(action, params, url = null) {
+    if(this.notInitialized) { throw new NotInitializedError() }
+
     const response = await fetch(apiUrl + "track/events", {
       headers: this.headers,
       method: "post",
@@ -48,6 +52,8 @@ class Hellotext {
    * @returns {Promise<any>|String}
    */
   static get session() {
+    if(this.notInitialized) { throw new NotInitializedError() }
+
     if (this._session) return this._session
 
     return this.mintAnonymousSession().then(response => {
@@ -59,6 +65,8 @@ class Hellotext {
   // private
 
   static async mintAnonymousSession() {
+    if(this.notInitialized) { throw new NotInitializedError() }
+
     const trackingUrl = apiUrl + 'track/sessions'
 
     this.mintingPromise = await fetch(trackingUrl, {
@@ -70,6 +78,8 @@ class Hellotext {
   }
 
   static get headers() {
+    if(this.notInitialized) { throw new NotInitializedError() }
+
     return {
       Authorization: `Bearer ${this.business_id}`,
       Accept: 'application.json',
@@ -78,8 +88,14 @@ class Hellotext {
   }
 
   static setSessionCookie(session) {
+    if(this.notInitialized) { throw new NotInitializedError() }
+
     document.cookie = `hello_session=${session}`
   }
+
+  static get notInitialized() {
+    return this.business_id === undefined
+  }
 }
 
 const getCookieValue = name => document.cookie.match('(^|;)\\s*' + name + '\\s*=\\s*([^;]+)')?.pop()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hellotext/hellotext",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Hellotext javascript client",
   "main": "index.js",
   "author": "Hellotext",