@journium/js 1.1.0 → 1.1.1

package/README.md

@@ -18,10 +18,9 @@ Learn how to use Journium to power your application:
 
 ### Prerequisites
 - Modern browser (ES2017+)
-- Node.js `>=18.17.0` or later
 - An existing Journium application. [Create your account for free](https://dashboard.journium.app/sign-up?utm_source=github&utm_medium=journium_js).
 
-## Installation
+## Installation Option 1: Via package manager
 
 ```bash
 npm install @journium/js
@@ -35,13 +34,58 @@ import { init } from '@journium/js';
 const journium = init({
   publishableKey: "your-publishable-key"
 });
+```
+
+For more detailed examples and configuration options, visit the [Journium documentation](https://journium.app/docs/js/).
 
-journium.track('button_clicked', {
-  button_name: 'signup'
+## Installation Option 2: Adding the JavaScript snippet to your HTML
+
+For websites without module bundlers (Shopify, WordPress, static HTML), use the CDN version with a single global `journium` object.
+
+### Script Tag
+
+```html
+<script>
+!function(j,o,u,r,n,i,u,m){
+    if(!o.__JV){
+        window.journium=o;
+        o._q=[];
+        o._i=null;
+        o.init=function(c,n){o._i=[c,n]};
+        var methods="track identify reset capturePageview startAutocapture stopAutocapture flush getEffectiveOptions onOptionsChange destroy".split(" ");
+        for(var k=0;k<methods.length;k++){
+            !function(method){
+                o[method]=function(){o._q.push([method].concat(Array.prototype.slice.call(arguments)));return o}
+            }(methods[k])
+        }
+        o.__JV=1;
+        (m=j.createElement("script")).type="text/javascript";
+        m.async=!0;
+        m.src="https://cdn.jsdelivr.net/npm/@journium/js@1/dist/journium.min.js";
+        m.onerror=function(){console.warn("Journium: Failed to load SDK from CDN")};
+        (i=j.getElementsByTagName("script")[0]).parentNode.insertBefore(m,i);
+    }
+}(document,window.journium||[]);
+
+journium.init({ 
+    publishableKey: 'YOUR_PUBLISHABLE_KEY'
 });
+</script>
 ```
 
-For more detailed examples and configuration options, visit the [Journium documentation](https://journium.app/docs/js/).
+### Usage Examples
+
+```javascript
+// Track events
+journium.track('page_view', { page: 'home' });
+journium.track('button_click', { button: 'signup' });
+
+// Identify users  
+journium.identify('user123', { 
+    email: 'user@example.com',
+    plan: 'pro' 
+});
+```
 
 ## Other SDKs
 

package/dist/JourniumAnalytics.d.ts

@@ -34,7 +34,6 @@ export declare class JourniumAnalytics {
 export declare const init: (config: JourniumConfig) => JourniumAnalytics;
 declare const _default: {
     init: (config: JourniumConfig) => JourniumAnalytics;
-    JourniumAnalytics: typeof JourniumAnalytics;
 };
 export default _default;
 //# sourceMappingURL=JourniumAnalytics.d.ts.map

package/dist/JourniumAnalytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JourniumAnalytics.d.ts","sourceRoot":"","sources":["../src/JourniumAnalytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAsB,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAK1F,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,kBAAkB,CAAkB;IAC5C,OAAO,CAAC,wBAAwB,CAAC,CAAa;gBAElC,MAAM,EAAE,cAAc;IAqBlC,OAAO,CAAC,yBAAyB;IAiBjC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIxE,KAAK,IAAI,IAAI;IAIb,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,gBAAgB,IAAI,IAAI;IA4BxB,eAAe,IAAI,IAAI;IAMvB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAkCjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6BrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,mBAAmB;IAInB;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;IAI9E,OAAO,IAAI,IAAI;CAQhB;AAED,eAAO,MAAM,IAAI,GAAI,QAAQ,cAAc,KAAG,iBAE7C,CAAC;;mBAF2B,cAAc,KAAG,iBAAiB;;;AAI/D,wBAA2C"}
+{"version":3,"file":"JourniumAnalytics.d.ts","sourceRoot":"","sources":["../src/JourniumAnalytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAsB,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAK1F,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,kBAAkB,CAAkB;IAC5C,OAAO,CAAC,wBAAwB,CAAC,CAAa;gBAElC,MAAM,EAAE,cAAc;IAqBlC,OAAO,CAAC,yBAAyB;IAiBjC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIxE,KAAK,IAAI,IAAI;IAIb,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,gBAAgB,IAAI,IAAI;IA4BxB,eAAe,IAAI,IAAI;IAMvB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAkCjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6BrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,mBAAmB;IAInB;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;IAI9E,OAAO,IAAI,IAAI;CAQhB;AAED,eAAO,MAAM,IAAI,GAAI,QAAQ,cAAc,KAAG,iBAE7C,CAAC;;mBAF2B,cAAc,KAAG,iBAAiB;;AAI/D,wBAAwB"}

package/dist/JourniumClient.d.ts

@@ -9,7 +9,6 @@ export declare class JourniumClient {
     private initializationFailed;
     private identityManager;
     private optionsStorageKey;
-    private disabled;
     private optionsChangeCallbacks;
     constructor(config: JourniumConfig);
     private loadCachedOptions;

package/dist/JourniumClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JourniumClient.d.ts","sourceRoot":"","sources":["../src/JourniumClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,cAAc,EAAE,oBAAoB,EAAyG,MAAM,gBAAgB,CAAC;AAE5L,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,sBAAsB,CAAkB;IAChD,OAAO,CAAC,oBAAoB,CAAkB;IAC9C,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,sBAAsB,CAA2D;gBAE7E,MAAM,EAAE,cAAc;IAoClC,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;YAYX,eAAe;YAwEf,2BAA2B;IA8CzC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;IAQ9E,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,mBAAmB;IA0C3B,OAAO,CAAC,eAAe;YAYT,UAAU;IA0BxB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IA2B5E,KAAK,IAAI,IAAI;IAmBb,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAiE9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB5B,OAAO,IAAI,IAAI;IAQf,mBAAmB,IAAI,oBAAoB;CAG5C"}
+{"version":3,"file":"JourniumClient.d.ts","sourceRoot":"","sources":["../src/JourniumClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,cAAc,EAAyB,oBAAoB,EAAyG,MAAM,gBAAgB,CAAC;AAEnN,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,sBAAsB,CAAkB;IAChD,OAAO,CAAC,oBAAoB,CAAkB;IAC9C,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,sBAAsB,CAA2D;gBAE7E,MAAM,EAAE,cAAc;IAiClC,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;YAYX,eAAe;YAyEf,2BAA2B;IAiDzC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;IAQ9E,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,mBAAmB;IA0C3B,OAAO,CAAC,eAAe;YAYT,UAAU;IA0BxB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAqB5E,KAAK,IAAI,IAAI;IAab,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IA2D9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB5B,OAAO,IAAI,IAAI;IAQf,mBAAmB,IAAI,oBAAoB;CAG5C"}

package/dist/cdn.d.ts

@@ -0,0 +1,40 @@
+/**
+ * CDN Entry Point for Journium Analytics
+ * This file provides global browser integration for script snippet usage
+ * Features: auto method stubbing, error handling, improved queue processing
+ */
+import { init } from './index';
+type JourniumAnalyticsInstance = ReturnType<typeof init>;
+interface JourniumSnippetQueue {
+    _q?: any[][];
+    _i?: [any, string?];
+    __JV?: boolean;
+    _error?: Error | null;
+    _retry?: boolean;
+    [key: string]: any;
+}
+interface GlobalJournium {
+    init: (config: any, instanceName?: string) => JourniumAnalyticsInstance;
+    track?: (event: string, properties?: any) => void;
+    identify?: (distinctId: string, attributes?: any) => void;
+    reset?: () => void;
+    capturePageview?: (properties?: any) => void;
+    startAutocapture?: () => void;
+    stopAutocapture?: () => void;
+    flush?: () => Promise<void>;
+    getEffectiveOptions?: () => any;
+    onOptionsChange?: (callback: (options: any) => void) => () => void;
+    destroy?: () => void;
+    [key: string]: any;
+}
+declare global {
+    interface Window {
+        journium?: JourniumSnippetQueue | GlobalJournium;
+    }
+}
+export { init };
+declare const _default: {
+    init: (config: import("@journium/core").JourniumConfig) => import("./JourniumAnalytics").JourniumAnalytics;
+};
+export default _default;
+//# sourceMappingURL=cdn.d.ts.map

package/dist/cdn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn.d.ts","sourceRoot":"","sources":["../src/cdn.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B,KAAK,yBAAyB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AASzD,UAAU,oBAAoB;IAC5B,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC;IACb,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAGD,UAAU,cAAc;IACtB,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,yBAAyB,CAAC;IACxE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC1D,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,eAAe,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC7C,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,GAAG,CAAC;IAChC,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IACnE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,QAAQ,CAAC,EAAE,oBAAoB,GAAG,cAAc,CAAC;KAClD;CACF;AA6OD,OAAO,EAAE,IAAI,EAAE,CAAC;;;;AAChB,wBAAwB"}

package/dist/index.cjs

@@ -448,9 +448,9 @@ const fetchRemoteOptions = async (apiHost, publishableKey, fetchFn) => {
                 'Content-Type': 'application/json',
             },
         });
-        if (!response.ok) {
-            throw new Error(`Options fetch failed: ${response.status} ${response.statusText}`);
-        }
+        // if (!response.ok) {
+        //   throw new Error(`Options fetch failed: ${response.status} ${response.statusText}`);
+        // }
         const data = await response.json();
         return data;
     }
@@ -705,18 +705,14 @@ class JourniumClient {
         this.flushTimer = null;
         this.initializationComplete = false;
         this.initializationFailed = false;
-        this.disabled = false;
         this.optionsChangeCallbacks = new Set();
-        // Validate required configuration - put in disabled state if invalid
+        // Validate required configuration
         if (!config.publishableKey || config.publishableKey.trim() === '') {
-            this.disabled = true;
+            // Reject initialization with clear error
+            const errorMsg = 'Journium: publishableKey is required but not provided or is empty. SDK cannot be initialized.';
             Logger.setDebug(true);
-            Logger.error('Journium: publishableKey is required but not provided or is empty. SDK will not function.');
-            // Create minimal config to prevent crashes
-            this.config = { publishableKey: '', apiHost: 'https://events.journium.app' };
-            this.effectiveOptions = { debug: true };
-            this.optionsStorageKey = 'jrnm_invalid_options';
-            return;
+            Logger.error(errorMsg);
+            throw new Error(errorMsg);
         }
         // Set default apiHost if not provided
         this.config = {
@@ -780,24 +776,23 @@ class JourniumClient {
             }
             else {
                 // Step 4: Fallback to cached config if fresh fetch failed
-                const cachedRemoteOptions = this.loadCachedOptions();
+                /* const cachedRemoteOptions = this.loadCachedOptions();
+                
                 if (cachedRemoteOptions) {
-                    if (this.config.options) {
-                        this.effectiveOptions = mergeOptions(this.config.options, cachedRemoteOptions);
-                        Logger.log('Journium: Fresh config failed, using cached remote config merged with local options:', this.effectiveOptions);
-                    }
-                    else {
-                        this.effectiveOptions = cachedRemoteOptions;
-                        Logger.log('Journium: Fresh config failed, using cached remote config:', this.effectiveOptions);
-                    }
-                }
-                else {
-                    // Step 5: No remote config and no cached config - initialization fails
-                    Logger.error('Journium: Initialization failed - no remote config available and no cached config found');
-                    this.initializationFailed = true;
-                    this.initializationComplete = false;
-                    return;
-                }
+                  if (this.config.options) {
+                    this.effectiveOptions = mergeOptions(this.config.options, cachedRemoteOptions);
+                    Logger.log('Journium: Fresh config failed, using cached remote config merged with local options:', this.effectiveOptions);
+                  } else {
+                    this.effectiveOptions = cachedRemoteOptions;
+                    Logger.log('Journium: Fresh config failed, using cached remote config:', this.effectiveOptions);
+                  }
+                } else {
+                  // Step 5: No remote config and no cached config - initialization fails
+                  Logger.error('Journium: Initialization failed - no remote config available and no cached config found');
+                  this.initializationFailed = true;
+                  this.initializationComplete = false;
+                  return;
+                } */
             }
             // Step 6: Update identity manager session timeout if provided
             if (this.effectiveOptions.sessionTimeout) {
@@ -837,11 +832,15 @@ class JourniumClient {
                 // Race fetch against timeout
                 const fetchPromise = fetchRemoteOptions(this.config.apiHost, this.config.publishableKey);
                 const remoteOptionsResponse = await Promise.race([fetchPromise, timeoutPromise]);
-                if (remoteOptionsResponse && remoteOptionsResponse.success) {
+                if (remoteOptionsResponse && remoteOptionsResponse.status === 'success') {
                     Logger.log('Journium: Successfully fetched fresh remote config:', remoteOptionsResponse.config);
-                    return remoteOptionsResponse.config;
+                    return remoteOptionsResponse.config || null;
                 }
-                else {
+                else if (remoteOptionsResponse && remoteOptionsResponse.status === 'error' && remoteOptionsResponse.errorCode === 'J_ERR_TENANT_NOT_FOUND') {
+                    Logger.error('Journium: Invalid publishableKey is being used.');
+                    return null;
+                }
+                {
                     throw new Error('Remote config fetch unsuccessful');
                 }
             }
@@ -949,11 +948,6 @@ class JourniumClient {
         }
     }
     identify(distinctId, attributes = {}) {
-        // Don't identify if SDK is not properly configured or disabled
-        if (this.disabled || !this.config || !this.config.publishableKey) {
-            Logger.warn('Journium: identify() call rejected - SDK not ready or disabled');
-            return;
-        }
         // Don't identify if initialization failed
         if (this.initializationFailed) {
             Logger.warn('Journium: identify() call rejected - initialization failed');
@@ -970,11 +964,6 @@ class JourniumClient {
         Logger.log('Journium: User identified', { distinctId, attributes, previousDistinctId });
     }
     reset() {
-        // Don't reset if SDK is not properly configured or disabled
-        if (this.disabled || !this.config || !this.config.publishableKey) {
-            Logger.warn('Journium: reset() call rejected - SDK not ready or disabled');
-            return;
-        }
         // Don't reset if initialization failed
         if (this.initializationFailed) {
             Logger.warn('Journium: reset() call rejected - initialization failed');
@@ -985,11 +974,6 @@ class JourniumClient {
         Logger.log('Journium: User identity reset');
     }
     track(event, properties = {}) {
-        // Don't track if SDK is not properly configured or disabled
-        if (this.disabled || !this.config || !this.config.publishableKey) {
-            Logger.warn('Journium: track() call rejected - SDK not ready or disabled');
-            return;
-        }
         // Create minimal event without identity properties (will be added later if staging)
         const journiumEvent = {
             uuid: generateUuidv7(),
@@ -1041,10 +1025,6 @@ class JourniumClient {
         }
     }
     async flush() {
-        // Don't flush if SDK is not properly configured
-        if (!this.config || !this.config.publishableKey) {
-            return;
-        }
         // Don't flush if initialization failed
         if (this.initializationFailed) {
             Logger.warn('Journium: flush() call rejected - initialization failed');
@@ -1669,7 +1649,6 @@ const init = (config) => {
 
 exports.AutocaptureTracker = AutocaptureTracker;
 exports.BrowserIdentityManager = BrowserIdentityManager;
-exports.JourniumAnalytics = JourniumAnalytics;
 exports.JourniumClient = JourniumClient;
 exports.Logger = Logger;
 exports.PageviewTracker = PageviewTracker;