@koolbase/js 10.0.0 → 10.0.1

package/CHANGELOG.md

@@ -7,6 +7,22 @@ is based on [Keep a Changelog][kac], and this project adheres to
 [kac]: https://keepachangelog.com/en/1.1.0/
 [semver]: https://semver.org/
 
+## 10.0.1
+
+### Fixed
+
+- **`restoreSession()` threw in Node.** With no `indexedDB`, the adapter fell
+  through to `localStorage`, which does not exist on a server either — so a
+  Next.js server render, or any tooling that imports the SDK, crashed with
+  `ReferenceError: localStorage is not defined`. Storage now falls back to an
+  in-memory store when neither is present, and a server render reports
+  `NoSession` rather than failing.
+
+  Note what this is not: server-side authentication. This package holds one
+  session per process, which is correct for a browser tab and wrong for a
+  server handling many users. It renders without crashing; it is not a way to
+  sign users in on a server.
+
 ## 10.0.0
 
 The first release. Numbered to match `@koolbase/react-native` and

package/README.md

@@ -11,7 +11,8 @@ feature flags, remote config, and an offline write queue with conflict
 resolution — one package, one `initialize()` call, TypeScript throughout.
 
 Same core as [`@koolbase/react-native`](https://www.npmjs.com/package/@koolbase/react-native).
-Same behaviour, proven by the same test suite on both hosts.
+Same behaviour, proven by the same test suite on both hosts. The whole SDK
+is about 16 kB gzipped.
 
 ---
 
@@ -261,7 +262,10 @@ Stated here so nothing is discovered as a method that fails:
 - **Code push** — a native-bundle concept. The web already ships on deploy.
 - **Push messaging** — FCM device tokens come from a native module. Use Web
   Push through your own service worker and your backend.
-- **Native Google / Apple sign-in** — use the web OAuth flows, above.
+- **The native sign-in libraries** — `signInWithGoogle` and
+  `signInWithApple` themselves are here and work; what a browser cannot do
+  is fetch the credential from a native module. Run the provider's web
+  OAuth flow and pass the ID token, as above.
 
 ---
 

package/dist/cjs/platform.js

@@ -94,10 +94,25 @@ function browserVersion() {
     const m = /(Chrome|Firefox|Safari|Edg)\/([\d.]+)/.exec(ua);
     return m ? `${m[1]} ${m[2]}` : '';
 }
+// Neither store exists during server-side rendering, in a Node tool, or in
+// a worker without storage access. Persisting nothing is the correct answer
+// there: a server render has no session to restore, and the client hydrates
+// with the real one. Throwing instead — which it did — crashes the render.
+function memoryStorage() {
+    const m = new Map();
+    return {
+        getItem: async (k) => m.get(k) ?? null,
+        setItem: async (k, v) => { m.set(k, v); },
+        removeItem: async (k) => { m.delete(k); },
+        getAllKeys: async () => Array.from(m.keys()),
+    };
+}
 function browserPlatform() {
-    const hasIDB = typeof indexedDB !== 'undefined';
+    const storage = typeof indexedDB !== 'undefined' ? indexedDBStorage()
+        : typeof localStorage !== 'undefined' ? localStorageStorage()
+            : memoryStorage();
     return {
-        storage: hasIDB ? indexedDBStorage() : localStorageStorage(),
+        storage,
         network: {
             onChange: (cb) => {
                 // navigator.onLine is a hint that the interface is up, not that

package/dist/esm/platform.js

@@ -91,10 +91,25 @@ function browserVersion() {
     const m = /(Chrome|Firefox|Safari|Edg)\/([\d.]+)/.exec(ua);
     return m ? `${m[1]} ${m[2]}` : '';
 }
+// Neither store exists during server-side rendering, in a Node tool, or in
+// a worker without storage access. Persisting nothing is the correct answer
+// there: a server render has no session to restore, and the client hydrates
+// with the real one. Throwing instead — which it did — crashes the render.
+function memoryStorage() {
+    const m = new Map();
+    return {
+        getItem: async (k) => m.get(k) ?? null,
+        setItem: async (k, v) => { m.set(k, v); },
+        removeItem: async (k) => { m.delete(k); },
+        getAllKeys: async () => Array.from(m.keys()),
+    };
+}
 export function browserPlatform() {
-    const hasIDB = typeof indexedDB !== 'undefined';
+    const storage = typeof indexedDB !== 'undefined' ? indexedDBStorage()
+        : typeof localStorage !== 'undefined' ? localStorageStorage()
+            : memoryStorage();
     return {
-        storage: hasIDB ? indexedDBStorage() : localStorageStorage(),
+        storage,
         network: {
             onChange: (cb) => {
                 // navigator.onLine is a hint that the interface is up, not that

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koolbase/js",
-  "version": "10.0.0",
+  "version": "10.0.1",
   "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": "10.0.0"
+    "@koolbase/core": "10.0.1"
   },
   "publishConfig": {
     "access": "public"