@koolbase/js 12.13.1 → 12.15.0

package/dist/cjs/index.d.ts

@@ -1,7 +1,7 @@
 export * from '@koolbase/core';
 export { BrowserAuthStorage } from './auth-storage.js';
 export { browserPlatform } from './platform.js';
-import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseAnalytics, type KoolbaseConfig, type VersionCheckResult } from '@koolbase/core';
+import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseConnectivity, KoolbaseAnalytics, type KoolbaseConfig, type VersionCheckResult } from '@koolbase/core';
 export declare const Koolbase: {
     initialize(config: KoolbaseConfig): Promise<void>;
     readonly auth: KoolbaseAuth;
@@ -9,6 +9,7 @@ export declare const Koolbase: {
     readonly storage: KoolbaseStorage;
     readonly fiscal: KoolbaseFiscal;
     readonly realtime: KoolbaseRealtime;
+    readonly connectivity: KoolbaseConnectivity;
     readonly functions: KoolbaseFunctions;
     readonly analytics: KoolbaseAnalytics;
     isEnabled(key: string): boolean;

package/dist/cjs/index.js

@@ -35,6 +35,7 @@ let _db = null;
 let _storage = null;
 let _fiscal = null;
 let _realtime = null;
+let _connectivity = null;
 let _functions = null;
 let _flags = null;
 let _analytics = null;
@@ -64,17 +65,27 @@ exports.Koolbase = {
         _initializing = (async () => {
             (0, core_1.setPlatform)(config.platform ?? (0, platform_js_2.browserPlatform)());
             _auth = new core_1.KoolbaseAuth(config);
-            _db = new core_1.KoolbaseDatabase(config, () => _auth?.currentUser?.id ?? null, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
-            _storage = new core_1.KoolbaseStorage(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); }, 
+            // A data request refused with the signed-in person's token renews the
+            // session once and goes again (#96); only a refused renewal ends it.
+            (0, core_1.setSessionRenewal)((refused) => (_auth ? _auth.renewRejected(refused) : Promise.resolve(null)));
+            _db = new core_1.KoolbaseDatabase(config, () => _auth?.currentUser?.id ?? null, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.sessionRejected(); });
+            _storage = new core_1.KoolbaseStorage(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.sessionRejected(); }, 
             // Project identity for publicUrlFor, from the bootstrap payload; a
             // missing one nudges a refresh (as Flutter's storage client).
             () => _flags?.projectId() ?? '', () => { void _flags?.refresh(); });
-            _fiscal = new core_1.KoolbaseFiscal(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
+            _fiscal = new core_1.KoolbaseFiscal(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.sessionRejected(); });
             _realtime = new core_1.KoolbaseRealtime(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), () => _auth?.currentUser?.id ?? null);
             // Signed in, signed out, another user: the realtime connection is
             // replaced to match (signed out, collections anyone can read only).
-            _auth?.onAuthStateChange(() => _realtime?.sessionChanged());
-            _functions = new core_1.KoolbaseFunctions(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
+            _auth?.onAuthStateChange(() => {
+                _realtime?.sessionChanged();
+                // Pending writes and conflicts are per-user: watchers read again.
+                _db?.sessionChanged();
+            });
+            // Whether the device reports a connection: unknown until it first answers.
+            _connectivity = new core_1.KoolbaseConnectivity();
+            _connectivity.start();
+            _functions = new core_1.KoolbaseFunctions(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.sessionRejected(); });
             const deviceId = await (0, core_1.getOrCreateDeviceId)();
             _flags = new core_1.KoolbaseFlags(config, deviceId);
             // The bootstrap payload (flags, config, version policy, project identity),
@@ -101,6 +112,7 @@ exports.Koolbase = {
     get storage() { ensureInitialized(); return _storage; },
     get fiscal() { ensureInitialized(); return _fiscal; },
     get realtime() { ensureInitialized(); return _realtime; },
+    get connectivity() { ensureInitialized(); return _connectivity; },
     get functions() { ensureInitialized(); return _functions; },
     get analytics() {
         ensureInitialized();

package/dist/cjs/platform.js

@@ -232,7 +232,13 @@ function browserPlatform() {
     return {
         storageTier,
         storage,
+        broadcast: browserBroadcast(),
         network: {
+            // navigator.onLine: false is reliable; true means an interface is up.
+            // A hint either way, like the events below. No window: cannot tell.
+            current: async () => typeof window !== 'undefined' && typeof navigator !== 'undefined' && typeof navigator.onLine === 'boolean'
+                ? navigator.onLine
+                : null,
             onChange: (cb) => {
                 // navigator.onLine is a hint that the interface is up, not that
                 // Koolbase is reachable. The sync engine treats a false positive as
@@ -278,3 +284,24 @@ function browserPlatform() {
         authStorage: () => new auth_storage_js_1.BrowserAuthStorage(),
     };
 }
+/**
+ * Other tabs of this origin, told when offline state changes, so a sync badge
+ * in one tab moves when another tab's sync drains the queue. Absent outside a
+ * browser or where BroadcastChannel is not supported.
+ */
+function browserBroadcast() {
+    if (typeof window === 'undefined' || typeof BroadcastChannel === 'undefined')
+        return undefined;
+    const channel = new BroadcastChannel('koolbase');
+    return {
+        post: (message) => channel.postMessage(message),
+        on: (callback) => {
+            const handler = (event) => {
+                if (typeof event.data === 'string')
+                    callback(event.data);
+            };
+            channel.addEventListener('message', handler);
+            return () => channel.removeEventListener('message', handler);
+        },
+    };
+}

package/dist/esm/index.d.ts

@@ -1,7 +1,7 @@
 export * from '@koolbase/core';
 export { BrowserAuthStorage } from './auth-storage.js';
 export { browserPlatform } from './platform.js';
-import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseAnalytics, type KoolbaseConfig, type VersionCheckResult } from '@koolbase/core';
+import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseConnectivity, KoolbaseAnalytics, type KoolbaseConfig, type VersionCheckResult } from '@koolbase/core';
 export declare const Koolbase: {
     initialize(config: KoolbaseConfig): Promise<void>;
     readonly auth: KoolbaseAuth;
@@ -9,6 +9,7 @@ export declare const Koolbase: {
     readonly storage: KoolbaseStorage;
     readonly fiscal: KoolbaseFiscal;
     readonly realtime: KoolbaseRealtime;
+    readonly connectivity: KoolbaseConnectivity;
     readonly functions: KoolbaseFunctions;
     readonly analytics: KoolbaseAnalytics;
     isEnabled(key: string): boolean;

package/dist/esm/index.js

@@ -9,13 +9,14 @@
 export * from '@koolbase/core';
 export { BrowserAuthStorage } from './auth-storage.js';
 export { browserPlatform } from './platform.js';
-import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseFlags, KoolbaseAnalytics, disabledAnalytics, getOrCreateDeviceId, setPlatform, } from '@koolbase/core';
+import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseConnectivity, KoolbaseFlags, KoolbaseAnalytics, disabledAnalytics, getOrCreateDeviceId, setPlatform, setSessionRenewal } from '@koolbase/core';
 import { browserPlatform } from './platform.js';
 let _auth = null;
 let _db = null;
 let _storage = null;
 let _fiscal = null;
 let _realtime = null;
+let _connectivity = null;
 let _functions = null;
 let _flags = null;
 let _analytics = null;
@@ -45,17 +46,27 @@ export const Koolbase = {
         _initializing = (async () => {
             setPlatform(config.platform ?? browserPlatform());
             _auth = new KoolbaseAuth(config);
-            _db = new KoolbaseDatabase(config, () => _auth?.currentUser?.id ?? null, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
-            _storage = new KoolbaseStorage(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); }, 
+            // A data request refused with the signed-in person's token renews the
+            // session once and goes again (#96); only a refused renewal ends it.
+            setSessionRenewal((refused) => (_auth ? _auth.renewRejected(refused) : Promise.resolve(null)));
+            _db = new KoolbaseDatabase(config, () => _auth?.currentUser?.id ?? null, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.sessionRejected(); });
+            _storage = new KoolbaseStorage(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.sessionRejected(); }, 
             // Project identity for publicUrlFor, from the bootstrap payload; a
             // missing one nudges a refresh (as Flutter's storage client).
             () => _flags?.projectId() ?? '', () => { void _flags?.refresh(); });
-            _fiscal = new KoolbaseFiscal(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
+            _fiscal = new KoolbaseFiscal(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.sessionRejected(); });
             _realtime = new KoolbaseRealtime(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), () => _auth?.currentUser?.id ?? null);
             // Signed in, signed out, another user: the realtime connection is
             // replaced to match (signed out, collections anyone can read only).
-            _auth?.onAuthStateChange(() => _realtime?.sessionChanged());
-            _functions = new KoolbaseFunctions(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
+            _auth?.onAuthStateChange(() => {
+                _realtime?.sessionChanged();
+                // Pending writes and conflicts are per-user: watchers read again.
+                _db?.sessionChanged();
+            });
+            // Whether the device reports a connection: unknown until it first answers.
+            _connectivity = new KoolbaseConnectivity();
+            _connectivity.start();
+            _functions = new KoolbaseFunctions(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.sessionRejected(); });
             const deviceId = await getOrCreateDeviceId();
             _flags = new KoolbaseFlags(config, deviceId);
             // The bootstrap payload (flags, config, version policy, project identity),
@@ -82,6 +93,7 @@ export const Koolbase = {
     get storage() { ensureInitialized(); return _storage; },
     get fiscal() { ensureInitialized(); return _fiscal; },
     get realtime() { ensureInitialized(); return _realtime; },
+    get connectivity() { ensureInitialized(); return _connectivity; },
     get functions() { ensureInitialized(); return _functions; },
     get analytics() {
         ensureInitialized();

package/dist/esm/platform.js

@@ -229,7 +229,13 @@ export function browserPlatform() {
     return {
         storageTier,
         storage,
+        broadcast: browserBroadcast(),
         network: {
+            // navigator.onLine: false is reliable; true means an interface is up.
+            // A hint either way, like the events below. No window: cannot tell.
+            current: async () => typeof window !== 'undefined' && typeof navigator !== 'undefined' && typeof navigator.onLine === 'boolean'
+                ? navigator.onLine
+                : null,
             onChange: (cb) => {
                 // navigator.onLine is a hint that the interface is up, not that
                 // Koolbase is reachable. The sync engine treats a false positive as
@@ -275,3 +281,24 @@ export function browserPlatform() {
         authStorage: () => new BrowserAuthStorage(),
     };
 }
+/**
+ * Other tabs of this origin, told when offline state changes, so a sync badge
+ * in one tab moves when another tab's sync drains the queue. Absent outside a
+ * browser or where BroadcastChannel is not supported.
+ */
+function browserBroadcast() {
+    if (typeof window === 'undefined' || typeof BroadcastChannel === 'undefined')
+        return undefined;
+    const channel = new BroadcastChannel('koolbase');
+    return {
+        post: (message) => channel.postMessage(message),
+        on: (callback) => {
+            const handler = (event) => {
+                if (typeof event.data === 'string')
+                    callback(event.data);
+            };
+            channel.addEventListener('message', handler);
+            return () => channel.removeEventListener('message', handler);
+        },
+    };
+}

package/package.json

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