@journium/js 1.1.0 → 1.2.0

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;IA+BrB,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

@@ -1,15 +1,18 @@
 import { JourniumConfig, JourniumLocalOptions } from '@journium/core';
 export declare class JourniumClient {
+    private static readonly REMOTE_OPTIONS_REFRESH_INTERVAL;
     private config;
     private effectiveOptions;
     private queue;
     private stagedEvents;
     private flushTimer;
+    private remoteOptionsRefreshTimer;
+    private isRefreshing;
+    private lastRemoteOptions;
     private initializationComplete;
     private initializationFailed;
     private identityManager;
     private optionsStorageKey;
-    private disabled;
     private optionsChangeCallbacks;
     constructor(config: JourniumConfig);
     private loadCachedOptions;
@@ -23,6 +26,10 @@ export declare class JourniumClient {
     private notifyOptionsChange;
     private processStagedEvents;
     private startFlushTimer;
+    private startRemoteOptionsRefreshTimer;
+    private refreshRemoteOptions;
+    private applyRemoteOptions;
+    private buildIdentityProperties;
     private sendEvents;
     identify(distinctId: string, attributes?: Record<string, unknown>): void;
     reset(): void;
@@ -30,5 +37,6 @@ export declare class JourniumClient {
     flush(): Promise<void>;
     destroy(): void;
     getEffectiveOptions(): JourniumLocalOptions;
+    private get ingestionPaused();
 }
 //# sourceMappingURL=JourniumClient.d.ts.map

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,CAAC,QAAQ,CAAC,+BAA+B,CAAkB;IAEzE,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,yBAAyB,CAA+C;IAChF,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,iBAAiB,CAAsC;IAC/D,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;YAoCf,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;IA2B3B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,8BAA8B;YAcxB,oBAAoB;IA6ClC,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,uBAAuB;YAiBjB,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;IAsC9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB5B,OAAO,IAAI,IAAI;IAYf,mBAAmB,IAAI,oBAAoB;IAI3C,OAAO,KAAK,eAAe,GAE1B;CACF"}

package/dist/PageviewTracker.d.ts

@@ -9,9 +9,10 @@ export declare class PageviewTracker {
     capturePageview(customProperties?: Record<string, unknown>): void;
     /**
      * Start automatic autocapture for pageviews
-     * @returns void
+     * @param captureInitialPageview - whether to fire a $pageview immediately on start (default: true).
+     *   Pass false when restarting after a remote options update to avoid a spurious pageview.
      */
-    startAutoPageviewTracking(): void;
+    startAutoPageviewTracking(captureInitialPageview?: boolean): void;
     /**
      * Stop automatic autocapture for pageviews
      * @returns void

package/dist/PageviewTracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageviewTracker.d.ts","sourceRoot":"","sources":["../src/PageviewTracker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,iBAAiB,CAAgD;IACzE,OAAO,CAAC,oBAAoB,CAAmD;IAC/E,OAAO,CAAC,eAAe,CAA6B;gBAExC,MAAM,EAAE,cAAc;IAIlC,eAAe,CAAC,gBAAgB,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAkBrE;;;OAGG;IACH,yBAAyB,IAAI,IAAI;IA0BjC;;;OAGG;IACH,eAAe,IAAI,IAAI;CAmBxB"}
+{"version":3,"file":"PageviewTracker.d.ts","sourceRoot":"","sources":["../src/PageviewTracker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,iBAAiB,CAAgD;IACzE,OAAO,CAAC,oBAAoB,CAAmD;IAC/E,OAAO,CAAC,eAAe,CAA6B;gBAExC,MAAM,EAAE,cAAc;IAIlC,eAAe,CAAC,gBAAgB,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAkBrE;;;;OAIG;IACH,yBAAyB,CAAC,sBAAsB,GAAE,OAAc,GAAG,IAAI;IA4BvE;;;OAGG;IACH,eAAe,IAAI,IAAI;CAmBxB"}

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;
     }
@@ -703,20 +703,19 @@ class JourniumClient {
         this.queue = [];
         this.stagedEvents = [];
         this.flushTimer = null;
+        this.remoteOptionsRefreshTimer = null;
+        this.isRefreshing = false;
+        this.lastRemoteOptions = 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 = {
@@ -760,62 +759,24 @@ class JourniumClient {
         }
     }
     async initializeAsync() {
-        var _a;
         try {
             Logger.log('Journium: Starting initialization - fetching fresh remote config...');
-            // Step 1: Try to fetch fresh remote config with timeout and retry
             const remoteOptions = await this.fetchRemoteOptionsWithRetry();
-            if (remoteOptions) {
-                // Step 2: Cache the fresh remote config
-                this.saveCachedOptions(remoteOptions);
-                // Step 3: Merge local options over remote config (local overrides remote)
-                if (this.config.options) {
-                    this.effectiveOptions = mergeOptions(this.config.options, remoteOptions);
-                    Logger.log('Journium: Using fresh remote config merged with local options:', this.effectiveOptions);
-                }
-                else {
-                    this.effectiveOptions = remoteOptions;
-                    Logger.log('Journium: Using fresh remote config:', this.effectiveOptions);
-                }
-            }
-            else {
-                // Step 4: Fallback to cached config if fresh fetch failed
-                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;
-                }
-            }
-            // Step 6: Update identity manager session timeout if provided
-            if (this.effectiveOptions.sessionTimeout) {
-                this.identityManager.updateSessionTimeout(this.effectiveOptions.sessionTimeout);
+            if (!remoteOptions) {
+                Logger.error('Journium: Initialization failed - no remote config available');
+                this.initializationFailed = true;
+                return;
             }
-            // Step 7: Update Logger debug setting
-            Logger.setDebug((_a = this.effectiveOptions.debug) !== null && _a !== void 0 ? _a : false);
-            // Step 8: Mark initialization as complete
+            this.applyRemoteOptions(remoteOptions);
+            Logger.log('Journium: Effective options after init:', this.effectiveOptions);
             this.initializationComplete = true;
             this.initializationFailed = false;
-            // Step 9: Process any staged events
             this.processStagedEvents();
-            // Step 10: Start flush timer
             if (this.effectiveOptions.flushInterval && this.effectiveOptions.flushInterval > 0) {
                 this.startFlushTimer();
             }
-            Logger.log('Journium: Initialization complete with options:', this.effectiveOptions);
-            // Step 11: Notify callbacks about options
+            this.startRemoteOptionsRefreshTimer();
+            Logger.log('Journium: Initialization complete');
             this.notifyOptionsChange();
         }
         catch (error) {
@@ -837,11 +798,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');
                 }
             }
@@ -882,35 +847,21 @@ class JourniumClient {
     processStagedEvents() {
         if (this.stagedEvents.length === 0)
             return;
+        if (this.ingestionPaused) {
+            Logger.warn(`Journium: Ingestion is paused — discarding ${this.stagedEvents.length} staged events`);
+            this.stagedEvents = [];
+            return;
+        }
         Logger.log(`Journium: Processing ${this.stagedEvents.length} staged events`);
-        // Move staged events to main queue, adding identity properties now
-        const identity = this.identityManager.getIdentity();
-        const userAgentInfo = this.identityManager.getUserAgentInfo();
         for (const stagedEvent of this.stagedEvents) {
-            // Add identity properties that weren't available during staging
-            const eventWithIdentity = {
+            this.queue.push({
                 ...stagedEvent,
-                properties: {
-                    $device_id: identity === null || identity === void 0 ? void 0 : identity.$device_id,
-                    distinct_id: identity === null || identity === void 0 ? void 0 : identity.distinct_id,
-                    $session_id: identity === null || identity === void 0 ? void 0 : identity.$session_id,
-                    $is_identified: (identity === null || identity === void 0 ? void 0 : identity.$user_state) === 'identified',
-                    $current_url: typeof window !== 'undefined' ? window.location.href : '',
-                    $pathname: typeof window !== 'undefined' ? window.location.pathname : '',
-                    ...userAgentInfo,
-                    $lib_version: '0.1.0', // TODO: Get from package.json
-                    $platform: 'web',
-                    ...stagedEvent.properties, // Original properties override system properties
-                },
-            };
-            this.queue.push(eventWithIdentity);
+                properties: this.buildIdentityProperties(stagedEvent.properties),
+            });
         }
-        // Clear staged events
         this.stagedEvents = [];
         Logger.log('Journium: Staged events processed and moved to main queue');
-        // Check if we should flush immediately
         if (this.queue.length >= this.effectiveOptions.flushAt) {
-            // console.log('1 Journium: Flushing events...'+JSON.stringify(this.effectiveOptions));
             this.flush();
         }
     }
@@ -918,12 +869,88 @@ class JourniumClient {
         if (this.flushTimer) {
             clearInterval(this.flushTimer);
         }
-        // Use universal setInterval (works in both browser and Node.js)
         this.flushTimer = setInterval(() => {
-            // console.log('2 Journium: Flushing events...'+JSON.stringify(this.effectiveOptions));
             this.flush();
         }, this.effectiveOptions.flushInterval);
     }
+    startRemoteOptionsRefreshTimer() {
+        // Clear any existing timer to prevent duplicate intervals
+        if (this.remoteOptionsRefreshTimer) {
+            clearInterval(this.remoteOptionsRefreshTimer);
+            this.remoteOptionsRefreshTimer = null;
+        }
+        this.remoteOptionsRefreshTimer = setInterval(() => {
+            this.refreshRemoteOptions();
+        }, JourniumClient.REMOTE_OPTIONS_REFRESH_INTERVAL);
+        Logger.log(`Journium: Scheduling remote options refresh every ${JourniumClient.REMOTE_OPTIONS_REFRESH_INTERVAL}ms`);
+    }
+    async refreshRemoteOptions() {
+        if (this.isRefreshing) {
+            Logger.log('Journium: Remote options refresh already in progress, skipping');
+            return;
+        }
+        this.isRefreshing = true;
+        Logger.log('Journium: Periodic remote options refresh triggered');
+        try {
+            const remoteOptions = await this.fetchRemoteOptionsWithRetry();
+            if (!remoteOptions) {
+                Logger.warn('Journium: Periodic remote options refresh failed, keeping current options');
+                return;
+            }
+            const prevRemoteSnapshot = JSON.stringify(this.lastRemoteOptions);
+            const prevFlushInterval = this.effectiveOptions.flushInterval;
+            this.applyRemoteOptions(remoteOptions);
+            if (prevRemoteSnapshot === JSON.stringify(this.lastRemoteOptions)) {
+                Logger.log('Journium: Remote options unchanged after refresh, no update needed');
+                return;
+            }
+            Logger.log('Journium: Remote options updated after refresh:', this.effectiveOptions);
+            if (this.effectiveOptions.flushInterval !== prevFlushInterval) {
+                if (this.effectiveOptions.flushInterval && this.effectiveOptions.flushInterval > 0) {
+                    this.startFlushTimer();
+                }
+                else if (this.flushTimer) {
+                    clearInterval(this.flushTimer);
+                    this.flushTimer = null;
+                }
+            }
+            this.notifyOptionsChange();
+        }
+        catch (error) {
+            Logger.error('Journium: Periodic remote options refresh encountered an error:', error);
+        }
+        finally {
+            this.isRefreshing = false;
+        }
+    }
+    applyRemoteOptions(remoteOptions) {
+        var _a;
+        this.lastRemoteOptions = remoteOptions;
+        this.effectiveOptions = this.config.options
+            ? mergeOptions(this.config.options, remoteOptions)
+            : remoteOptions;
+        this.saveCachedOptions(remoteOptions);
+        if (this.effectiveOptions.sessionTimeout) {
+            this.identityManager.updateSessionTimeout(this.effectiveOptions.sessionTimeout);
+        }
+        Logger.setDebug((_a = this.effectiveOptions.debug) !== null && _a !== void 0 ? _a : false);
+    }
+    buildIdentityProperties(userProperties = {}) {
+        const identity = this.identityManager.getIdentity();
+        const userAgentInfo = this.identityManager.getUserAgentInfo();
+        return {
+            $device_id: identity === null || identity === void 0 ? void 0 : identity.$device_id,
+            distinct_id: identity === null || identity === void 0 ? void 0 : identity.distinct_id,
+            $session_id: identity === null || identity === void 0 ? void 0 : identity.$session_id,
+            $is_identified: (identity === null || identity === void 0 ? void 0 : identity.$user_state) === 'identified',
+            $current_url: typeof window !== 'undefined' ? window.location.href : '',
+            $pathname: typeof window !== 'undefined' ? window.location.pathname : '',
+            ...userAgentInfo,
+            $lib_version: '0.1.0', // TODO: Get from package.json
+            $platform: 'web',
+            ...userProperties,
+        };
+    }
     async sendEvents(events) {
         if (!events.length)
             return;
@@ -949,11 +976,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 +992,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 +1002,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(),
@@ -998,9 +1010,7 @@ class JourniumClient {
             event,
             properties: { ...properties }, // Only user properties for now
         };
-        // Stage events during initialization, add to queue after initialization
         if (!this.initializationComplete) {
-            // If initialization failed, reject events
             if (this.initializationFailed) {
                 Logger.warn('Journium: track() call rejected - initialization failed');
                 return;
@@ -1009,42 +1019,21 @@ class JourniumClient {
             Logger.log('Journium: Event staged during initialization', journiumEvent);
             return;
         }
-        // If initialization failed, reject events
-        if (this.initializationFailed) {
-            Logger.warn('Journium: track() call rejected - initialization failed');
+        if (this.ingestionPaused) {
+            Logger.warn('Journium: Ingestion is paused — event dropped:', journiumEvent.event);
             return;
         }
-        // Add identity properties for immediate events (after initialization)
-        const identity = this.identityManager.getIdentity();
-        const userAgentInfo = this.identityManager.getUserAgentInfo();
         const eventWithIdentity = {
             ...journiumEvent,
-            properties: {
-                $device_id: identity === null || identity === void 0 ? void 0 : identity.$device_id,
-                distinct_id: identity === null || identity === void 0 ? void 0 : identity.distinct_id,
-                $session_id: identity === null || identity === void 0 ? void 0 : identity.$session_id,
-                $is_identified: (identity === null || identity === void 0 ? void 0 : identity.$user_state) === 'identified',
-                $current_url: typeof window !== 'undefined' ? window.location.href : '',
-                $pathname: typeof window !== 'undefined' ? window.location.pathname : '',
-                ...userAgentInfo,
-                $lib_version: '0.1.0', // TODO: Get from package.json
-                $platform: 'web',
-                ...properties, // User-provided properties override system properties
-            },
+            properties: this.buildIdentityProperties(properties),
         };
         this.queue.push(eventWithIdentity);
         Logger.log('Journium: Event tracked', eventWithIdentity);
-        // Only flush if we have effective options (after initialization)
         if (this.effectiveOptions.flushAt && this.queue.length >= this.effectiveOptions.flushAt) {
-            // console.log('3 Journium: Flushing events...'+JSON.stringify(this.effectiveOptions));
             this.flush();
         }
     }
     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');
@@ -1067,12 +1056,20 @@ class JourniumClient {
             clearInterval(this.flushTimer);
             this.flushTimer = null;
         }
+        if (this.remoteOptionsRefreshTimer) {
+            clearInterval(this.remoteOptionsRefreshTimer);
+            this.remoteOptionsRefreshTimer = null;
+        }
         this.flush();
     }
     getEffectiveOptions() {
         return this.effectiveOptions;
     }
+    get ingestionPaused() {
+        return this.effectiveOptions['ingestionPaused'] === true;
+    }
 }
+JourniumClient.REMOTE_OPTIONS_REFRESH_INTERVAL = 15 * 60 * 1000; // 15 minutes
 
 class PageviewTracker {
     constructor(client) {
@@ -1099,10 +1096,13 @@ class PageviewTracker {
     }
     /**
      * Start automatic autocapture for pageviews
-     * @returns void
+     * @param captureInitialPageview - whether to fire a $pageview immediately on start (default: true).
+     *   Pass false when restarting after a remote options update to avoid a spurious pageview.
      */
-    startAutoPageviewTracking() {
-        this.capturePageview();
+    startAutoPageviewTracking(captureInitialPageview = true) {
+        if (captureInitialPageview) {
+            this.capturePageview();
+        }
         if (typeof window !== 'undefined') {
             // Store original methods for cleanup
             this.originalPushState = window.history.pushState;
@@ -1621,21 +1621,22 @@ class JourniumAnalytics {
      * Handle effective options change (e.g., when remote options are fetched)
      */
     handleOptionsChange(effectiveOptions) {
-        // Stop current autocapture if it was already started
+        // If autocapture was never started before, this is the initial options application
+        // (async init completed) — treat it like a page load and capture a pageview.
+        // If it was already started, this is a periodic remote options update — only
+        // re-register listeners without emitting a spurious pageview.
+        const isFirstStart = !this.autocaptureStarted;
         if (this.autocaptureStarted) {
             this.pageviewTracker.stopAutocapture();
             this.autocaptureTracker.stop();
             this.autocaptureStarted = false;
         }
-        // Evaluate if autocapture should be enabled with new options
         const autoTrackPageviews = effectiveOptions.autoTrackPageviews !== false;
         const autocaptureEnabled = effectiveOptions.autocapture !== false;
-        // Update autocapture tracker options
         const autocaptureOptions = this.resolveAutocaptureOptions(effectiveOptions.autocapture);
         this.autocaptureTracker.updateOptions(autocaptureOptions);
-        // Start autocapture based on new options (even if it wasn't started before)
         if (autoTrackPageviews) {
-            this.pageviewTracker.startAutoPageviewTracking();
+            this.pageviewTracker.startAutoPageviewTracking(isFirstStart);
         }
         if (autocaptureEnabled) {
             this.autocaptureTracker.start();
@@ -1669,7 +1670,6 @@ const init = (config) => {
 
 exports.AutocaptureTracker = AutocaptureTracker;
 exports.BrowserIdentityManager = BrowserIdentityManager;
-exports.JourniumAnalytics = JourniumAnalytics;
 exports.JourniumClient = JourniumClient;
 exports.Logger = Logger;
 exports.PageviewTracker = PageviewTracker;