@koolbase/js 12.2.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/cjs/platform.js

@@ -137,10 +137,14 @@ function makeResolver() {
                 if (await probe(s))
                     return { tier: 'localstorage', store: s };
             }
+            // Outside a browser (Node, a server rendering pages) memory is the
+            // expected store, not a symptom, so there is nothing to warn about.
+            const inBrowser = typeof window !== 'undefined' && typeof document !== 'undefined';
             // eslint-disable-next-line no-console
-            console.warn('[Koolbase] No persistent storage available in this browser ' +
-                '(private browsing, blocked site data, or an exhausted quota). ' +
-                'The session and the offline queue will not survive a reload.');
+            if (inBrowser)
+                console.warn('[Koolbase] No persistent storage available in this browser ' +
+                    '(private browsing, blocked site data, or an exhausted quota). ' +
+                    'The session and the offline queue will not survive a reload.');
             return { tier: 'memory', store: memoryStorage() };
         })());
         return resolving.then((r) => { resolved = r; return r; });

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/dist/esm/platform.js

@@ -134,10 +134,14 @@ function makeResolver() {
                 if (await probe(s))
                     return { tier: 'localstorage', store: s };
             }
+            // Outside a browser (Node, a server rendering pages) memory is the
+            // expected store, not a symptom, so there is nothing to warn about.
+            const inBrowser = typeof window !== 'undefined' && typeof document !== 'undefined';
             // eslint-disable-next-line no-console
-            console.warn('[Koolbase] No persistent storage available in this browser ' +
-                '(private browsing, blocked site data, or an exhausted quota). ' +
-                'The session and the offline queue will not survive a reload.');
+            if (inBrowser)
+                console.warn('[Koolbase] No persistent storage available in this browser ' +
+                    '(private browsing, blocked site data, or an exhausted quota). ' +
+                    'The session and the offline queue will not survive a reload.');
             return { tier: 'memory', store: memoryStorage() };
         })());
         return resolving.then((r) => { resolved = r; return r; });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koolbase/js",
-  "version": "12.2.0",
+  "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",
@@ -25,7 +25,7 @@
     "url": "https://github.com/koolbase/koolbase-react-native"
   },
   "dependencies": {
-    "@koolbase/core": "12.2.0"
+    "@koolbase/core": "12.4.0"
   },
   "publishConfig": {
     "access": "public"