@koolbase/js 12.3.0 → 12.4.0

package/dist/cjs/index.js

@@ -38,6 +38,8 @@ let _realtime = null;
 let _functions = null;
 let _flags = null;
 let _analytics = null;
+// While analytics is off, calls are harmless no-ops rather than a crash.
+const analyticsOff = (0, core_1.disabledAnalytics)();
 let _initialized = false;
 // The in-flight initialize, so overlapping callers await the same one.
 //
@@ -69,7 +71,8 @@ exports.Koolbase = {
             _functions = new core_1.KoolbaseFunctions(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
             const deviceId = await (0, core_1.getOrCreateDeviceId)();
             _flags = new core_1.KoolbaseFlags(config, deviceId);
-            if (config.analyticsEnabled !== false) {
+            // Opt-in: nothing is sent unless the app asks for it.
+            if (config.analyticsEnabled === true) {
                 _analytics = new core_1.KoolbaseAnalytics(config, () => _auth?.currentUser?.id ?? null);
                 await _analytics.init(config.appVersion);
             }
@@ -92,9 +95,7 @@ exports.Koolbase = {
     get functions() { ensureInitialized(); return _functions; },
     get analytics() {
         ensureInitialized();
-        if (!_analytics)
-            throw new Error('Analytics is disabled (analyticsEnabled: false).');
-        return _analytics;
+        return _analytics ?? analyticsOff;
     },
     isEnabled(key) { ensureInitialized(); return _flags.isEnabled(key); },
     configString(key, fallback = '') { ensureInitialized(); return _flags.getString(key, fallback); },

package/dist/esm/index.js

@@ -9,7 +9,7 @@
 export * from '@koolbase/core';
 export { BrowserAuthStorage } from './auth-storage.js';
 export { browserPlatform } from './platform.js';
-import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseFlags, KoolbaseAnalytics, getOrCreateDeviceId, setPlatform, } from '@koolbase/core';
+import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseFlags, KoolbaseAnalytics, disabledAnalytics, getOrCreateDeviceId, setPlatform, } from '@koolbase/core';
 import { browserPlatform } from './platform.js';
 let _auth = null;
 let _db = null;
@@ -19,6 +19,8 @@ let _realtime = null;
 let _functions = null;
 let _flags = null;
 let _analytics = null;
+// While analytics is off, calls are harmless no-ops rather than a crash.
+const analyticsOff = disabledAnalytics();
 let _initialized = false;
 // The in-flight initialize, so overlapping callers await the same one.
 //
@@ -50,7 +52,8 @@ export const Koolbase = {
             _functions = new KoolbaseFunctions(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
             const deviceId = await getOrCreateDeviceId();
             _flags = new KoolbaseFlags(config, deviceId);
-            if (config.analyticsEnabled !== false) {
+            // Opt-in: nothing is sent unless the app asks for it.
+            if (config.analyticsEnabled === true) {
                 _analytics = new KoolbaseAnalytics(config, () => _auth?.currentUser?.id ?? null);
                 await _analytics.init(config.appVersion);
             }
@@ -73,9 +76,7 @@ export const Koolbase = {
     get functions() { ensureInitialized(); return _functions; },
     get analytics() {
         ensureInitialized();
-        if (!_analytics)
-            throw new Error('Analytics is disabled (analyticsEnabled: false).');
-        return _analytics;
+        return _analytics ?? analyticsOff;
     },
     isEnabled(key) { ensureInitialized(); return _flags.isEnabled(key); },
     configString(key, fallback = '') { ensureInitialized(); return _flags.getString(key, fallback); },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@koolbase/js",
-  "version": "12.3.0",
-  "description": "Koolbase SDK for the browser — auth, database, storage, realtime, functions, flags and offline sync in one package.",
+  "version": "12.4.0",
+  "description": "Koolbase SDK for the browser \u2014 auth, database, storage, realtime, functions, flags and offline sync in one package.",
   "main": "./dist/cjs/index.js",
   "types": "./dist/esm/index.d.ts",
   "files": [
@@ -25,7 +25,7 @@
     "url": "https://github.com/koolbase/koolbase-react-native"
   },
   "dependencies": {
-    "@koolbase/core": "12.3.0"
+    "@koolbase/core": "12.4.0"
   },
   "publishConfig": {
     "access": "public"