saasco-sdk 0.1.11 → 0.1.12

package/index.cjs.js

@@ -434,7 +434,7 @@ const timezones = {
   'Asia/Calcutta': 'IN'
 };
 
-var version = "0.1.11";
+var version = "0.1.12";
 
 const isBrowser = typeof window !== 'undefined';
 let userId = null;
@@ -547,10 +547,17 @@ 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;
   }
   init() {
+    if (!this.config.projectId) {
+      return this.error("Unable to initialize Saasco. Project ID is required but has not been provided. If you are using an env variable make sure it's set correctly.");
+    }
     if (this.isInitialized) {
       this.log('Saasco is already initialized. Please check your code to ensure that init() is not being called multiple times.');
       return;
@@ -583,6 +590,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 +632,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;
@@ -698,6 +711,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.12";
 
 const isBrowser = typeof window !== 'undefined';
 let userId = null;
@@ -543,10 +543,17 @@ 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;
   }
   init() {
+    if (!this.config.projectId) {
+      return this.error("Unable to initialize Saasco. Project ID is required but has not been provided. If you are using an env variable make sure it's set correctly.");
+    }
     if (this.isInitialized) {
       this.log('Saasco is already initialized. Please check your code to ensure that init() is not being called multiple times.');
       return;
@@ -579,6 +586,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 +628,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;
@@ -694,6 +707,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.12",
   "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<string | Response | undefined>;
     /**
      * 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<string | Response | undefined>;
     /**
      * 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