saasco-sdk 0.1.11 → 0.1.13

package/README.md

@@ -35,8 +35,8 @@ export const saasco = new Saasco({ projectId: 'YOUR-PROJECT-ID' });
 
 ## Init Automatic Page View Tracking
 
-When you initial the lib Saasco will automatically start tracking all page views in your app. There is no other configuration. It will automatically track url changes, even for SPAs like NextJs and Vue.
-You can also [manually track pages](https://www.notion.so/Manual-Page-Tracking-in-SPAs-2442fc7586dc4208ae8f669eb7561b1a?pvs=21) by opting our of automatic page tracking. For most use cases you don't need to do this.
+When you initiate the lib Saasco will automatically start tracking all page views in your app. There is no other configuration. It will automatically track url changes, even for SPAs like NextJs and Vue.
+You can also [manually track pages](https://www.notion.so/Manual-Page-Tracking-in-SPAs-2442fc7586dc4208ae8f669eb7561b1a?pvs=21) by opting out of automatic page tracking. For most use cases you don't need to do this.
 
 ```ts
 // ./app/index

package/index.cjs.js

@@ -434,7 +434,7 @@ const timezones = {
   'Asia/Calcutta': 'IN'
 };
 
-var version = "0.1.11";
+var version = "0.1.13";
 
 const isBrowser = typeof window !== 'undefined';
 let userId = null;
@@ -547,6 +547,10 @@ class Saasco {
     this.config = config;
     this.lastPageViewHref = '';
     this.isInitialized = false;
+    if (!config.projectId) {
+      this.error("Project ID is required but has not been provided. If you are using an env variable make sure it's set correctly.");
+      return;
+    }
     // default enabled to true
     this.config.enabled = this.config.enabled === undefined ? true : this.config.enabled;
   }
@@ -583,6 +587,9 @@ class Saasco {
   track(name,
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   properties, context) {
+    if (!this.config.projectId) {
+      return this.error("Unable to track event. Project ID is required but has not been provided. If you are using an env variable make sure it's set correctly.");
+    }
     // Prevent duplicate Page View tracking
     if (name === 'Page View') {
       if (!isBrowser) {
@@ -622,6 +629,9 @@ class Saasco {
     return this.track('Page View');
   }
   identify(distinctIdOrProperties, propertiesOrContext, contextOrNothing) {
+    if (!this.config.projectId) {
+      return this.error("Unable to identify user. Project ID is required but has not been provided. If you are using an env variable make sure it's set correctly.");
+    }
     const hasId = typeof distinctIdOrProperties === 'string' || typeof distinctIdOrProperties === 'number' || distinctIdOrProperties === null;
     const distinctId = hasId ? distinctIdOrProperties === null || distinctIdOrProperties === void 0 ? void 0 : distinctIdOrProperties.toString() : `soft_${uuid.v4()}`;
     const properties = hasId ? propertiesOrContext : distinctIdOrProperties;
@@ -678,13 +688,13 @@ class Saasco {
           body: JSON.stringify(data)
         });
         if (!response.ok) {
-          throw new Error(response.status.toString());
+          const errorBody = yield response.json();
+          throw new Error(`${errorBody.message}: ${errorBody.errors ? `[${errorBody.errors.join(', ')}]` : ''}` || JSON.stringify(errorBody));
         }
         return response;
       } catch (error) {
-        const errorMessage = 'Error with Saasco request: ' + error.message;
-        console.error(errorMessage, path, data);
-        return errorMessage;
+        this.error(`\nError Message: "${error.message}"`, `\nPath: "/${path}"`, `\nRequest Data: ${JSON.stringify(data, null, 2)}`);
+        return error.message;
       }
     });
   }
@@ -698,6 +708,15 @@ class Saasco {
     // Message highlighted for easy finding
     ...args]);
   }
+  /**
+   * @param args Arguments to be logged
+   */
+  error(...args) {
+    const message = '◍ Saasco Error';
+    console.error(...[`\x1b[41m\x1b[37m ${message} \x1b[0m`,
+    // Message highlighted for easy finding
+    ...args]);
+  }
   /**
    * If autoPageTracking is enabled, this will automatically track page views
    * It listens to url changes to track new pages every time the url changes

package/index.esm.js

@@ -430,7 +430,7 @@ const timezones = {
   'Asia/Calcutta': 'IN'
 };
 
-var version = "0.1.11";
+var version = "0.1.13";
 
 const isBrowser = typeof window !== 'undefined';
 let userId = null;
@@ -543,6 +543,10 @@ class Saasco {
     this.config = config;
     this.lastPageViewHref = '';
     this.isInitialized = false;
+    if (!config.projectId) {
+      this.error("Project ID is required but has not been provided. If you are using an env variable make sure it's set correctly.");
+      return;
+    }
     // default enabled to true
     this.config.enabled = this.config.enabled === undefined ? true : this.config.enabled;
   }
@@ -579,6 +583,9 @@ class Saasco {
   track(name,
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   properties, context) {
+    if (!this.config.projectId) {
+      return this.error("Unable to track event. Project ID is required but has not been provided. If you are using an env variable make sure it's set correctly.");
+    }
     // Prevent duplicate Page View tracking
     if (name === 'Page View') {
       if (!isBrowser) {
@@ -618,6 +625,9 @@ class Saasco {
     return this.track('Page View');
   }
   identify(distinctIdOrProperties, propertiesOrContext, contextOrNothing) {
+    if (!this.config.projectId) {
+      return this.error("Unable to identify user. Project ID is required but has not been provided. If you are using an env variable make sure it's set correctly.");
+    }
     const hasId = typeof distinctIdOrProperties === 'string' || typeof distinctIdOrProperties === 'number' || distinctIdOrProperties === null;
     const distinctId = hasId ? distinctIdOrProperties === null || distinctIdOrProperties === void 0 ? void 0 : distinctIdOrProperties.toString() : `soft_${v4()}`;
     const properties = hasId ? propertiesOrContext : distinctIdOrProperties;
@@ -674,13 +684,13 @@ class Saasco {
           body: JSON.stringify(data)
         });
         if (!response.ok) {
-          throw new Error(response.status.toString());
+          const errorBody = yield response.json();
+          throw new Error(`${errorBody.message}: ${errorBody.errors ? `[${errorBody.errors.join(', ')}]` : ''}` || JSON.stringify(errorBody));
         }
         return response;
       } catch (error) {
-        const errorMessage = 'Error with Saasco request: ' + error.message;
-        console.error(errorMessage, path, data);
-        return errorMessage;
+        this.error(`\nError Message: "${error.message}"`, `\nPath: "/${path}"`, `\nRequest Data: ${JSON.stringify(data, null, 2)}`);
+        return error.message;
       }
     });
   }
@@ -694,6 +704,15 @@ class Saasco {
     // Message highlighted for easy finding
     ...args]);
   }
+  /**
+   * @param args Arguments to be logged
+   */
+  error(...args) {
+    const message = '◍ Saasco Error';
+    console.error(...[`\x1b[41m\x1b[37m ${message} \x1b[0m`,
+    // Message highlighted for easy finding
+    ...args]);
+  }
   /**
    * If autoPageTracking is enabled, this will automatically track page views
    * It listens to url changes to track new pages every time the url changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "saasco-sdk",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "dependencies": {
     "tslib": "^2.3.0",
     "@lukeed/uuid": "^2.0.1",

package/src/lib/analytics.d.ts

@@ -37,14 +37,14 @@ export declare class Saasco {
      */
     track(name: string, properties?: Record<string, any>, context?: {
         active?: boolean;
-    }): Promise<string | Response | undefined> | undefined;
+    }): void | Promise<any>;
     /**
      * The page method lets you record page views on your website
      * This records the page title and path and names the event useing the reserved property "Page Viewed"
      *
      * Before implementing this make sure you have disabled the autoPageTracking in the config or you will get duplicate page views
      */
-    page(): Promise<string | Response | undefined> | undefined;
+    page(): void | Promise<any>;
     /**
      * The identify method lets you tie a user to their actions and record traits about them.
      * We recommend you call this when the user logs in and when any traits get updated.
@@ -71,6 +71,10 @@ export declare class Saasco {
      * @param args Arguments to be logged
      */
     private log;
+    /**
+     * @param args Arguments to be logged
+     */
+    private error;
     /**
      * If autoPageTracking is enabled, this will automatically track page views
      * It listens to url changes to track new pages every time the url changes