@koolbase/js 12.37.0 → 12.38.1

package/CHANGELOG.md

@@ -7,6 +7,13 @@ is based on [Keep a Changelog][kac], and this project adheres to
 [kac]: https://keepachangelog.com/en/1.1.0/
 [semver]: https://semver.org/
 
+## 12.38.1
+
+A shown record follows the app's own writes (R125). Same contract as koolbase_flutter 12.52.7.
+
+- **`useRecord` / `KoolbaseRecordController`**: after the app updates the record -- or anything in its collection -- it shows the device's saved copy at once (which holds the change, made online or queued offline), then the server's, without `refreshing`. Before, a shown record kept its old values until the screen was opened again.
+- **An offline `update`** now tells what shows its collection, as an online one does.
+
 ## 12.33.0
 
 Search by meaning takes the typed filter (#173). Same contract as koolbase_flutter 12.43.0.

package/dist/cjs/index.d.ts

@@ -1,9 +1,27 @@
 export * from '@koolbase/core';
 export { BrowserAuthStorage } from './auth-storage.js';
 export { browserPlatform } from './platform.js';
-import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseConnectivity, KoolbaseAnalytics, type KoolbaseConfig, type VersionCheckResult } from '@koolbase/core';
+import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseConnectivity, KoolbaseAnalytics, type KoolbaseConfig, type VersionCheckResult, type FetchLike } from '@koolbase/core';
 export declare const Koolbase: {
     initialize(config: KoolbaseConfig): Promise<void>;
+    /**
+     * For tests (R49): the real initialize, against a server you give as
+     * `fetch` -- the SDK's own auth and data code runs; only the server is
+     * yours -- with storage and the session in memory, and no analytics or
+     * messaging. Call resetForTesting after each test.
+     *
+     * ```ts
+     * await Koolbase.initializeForTesting({ fetch: myFakeServer });
+     * await Koolbase.auth.login({ email, password });
+     * ```
+     */
+    initializeForTesting(options: {
+        fetch: FetchLike;
+        baseUrl?: string;
+        publicKey?: string;
+    }): Promise<void>;
+    /** After a test (R49): everything initialize made is dropped, so the next one starts from nothing. */
+    resetForTesting(): void;
     readonly auth: KoolbaseAuth;
     readonly db: KoolbaseDatabase;
     readonly storage: KoolbaseStorage;

package/dist/cjs/index.js

@@ -64,6 +64,8 @@ exports.Koolbase = {
             return _initializing;
         _initializing = (async () => {
             (0, core_1.setPlatform)(config.platform ?? (0, platform_js_2.browserPlatform)());
+            // Every JSON request the SDK makes goes through config.fetch, when one is given (R49).
+            (0, core_1.setFetch)(config.fetch ?? null);
             _auth = new core_1.KoolbaseAuth(config);
             // 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.
@@ -107,6 +109,45 @@ exports.Koolbase = {
             _initializing = null;
         }
     },
+    /**
+     * For tests (R49): the real initialize, against a server you give as
+     * `fetch` -- the SDK's own auth and data code runs; only the server is
+     * yours -- with storage and the session in memory, and no analytics or
+     * messaging. Call resetForTesting after each test.
+     *
+     * ```ts
+     * await Koolbase.initializeForTesting({ fetch: myFakeServer });
+     * await Koolbase.auth.login({ email, password });
+     * ```
+     */
+    async initializeForTesting(options) {
+        await exports.Koolbase.initialize({
+            baseUrl: options.baseUrl ?? 'http://koolbase.test',
+            publicKey: options.publicKey ?? 'pk_test',
+            platform: (0, core_1.memoryPlatform)(),
+            authStorage: new core_1.MemoryAuthStorage(),
+            fetch: options.fetch,
+            analyticsEnabled: false,
+            messagingEnabled: false,
+        });
+    },
+    /** After a test (R49): everything initialize made is dropped, so the next one starts from nothing. */
+    resetForTesting() {
+        _connectivity?.stop?.();
+        (0, core_1.setSessionRenewal)(null);
+        (0, core_1.setFetch)(null);
+        _auth = null;
+        _db = null;
+        _storage = null;
+        _fiscal = null;
+        _realtime = null;
+        _connectivity = null;
+        _functions = null;
+        _flags = null;
+        _analytics = null;
+        _initialized = false;
+        _initializing = null;
+    },
     get auth() { ensureInitialized(); return _auth; },
     get db() { ensureInitialized(); return _db; },
     get storage() { ensureInitialized(); return _storage; },

package/dist/esm/index.d.ts

@@ -1,9 +1,27 @@
 export * from '@koolbase/core';
 export { BrowserAuthStorage } from './auth-storage.js';
 export { browserPlatform } from './platform.js';
-import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseConnectivity, KoolbaseAnalytics, type KoolbaseConfig, type VersionCheckResult } from '@koolbase/core';
+import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseConnectivity, KoolbaseAnalytics, type KoolbaseConfig, type VersionCheckResult, type FetchLike } from '@koolbase/core';
 export declare const Koolbase: {
     initialize(config: KoolbaseConfig): Promise<void>;
+    /**
+     * For tests (R49): the real initialize, against a server you give as
+     * `fetch` -- the SDK's own auth and data code runs; only the server is
+     * yours -- with storage and the session in memory, and no analytics or
+     * messaging. Call resetForTesting after each test.
+     *
+     * ```ts
+     * await Koolbase.initializeForTesting({ fetch: myFakeServer });
+     * await Koolbase.auth.login({ email, password });
+     * ```
+     */
+    initializeForTesting(options: {
+        fetch: FetchLike;
+        baseUrl?: string;
+        publicKey?: string;
+    }): Promise<void>;
+    /** After a test (R49): everything initialize made is dropped, so the next one starts from nothing. */
+    resetForTesting(): void;
     readonly auth: KoolbaseAuth;
     readonly db: KoolbaseDatabase;
     readonly storage: KoolbaseStorage;

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, KoolbaseConnectivity, KoolbaseFlags, KoolbaseAnalytics, disabledAnalytics, getOrCreateDeviceId, setPlatform, setSessionRenewal } from '@koolbase/core';
+import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseConnectivity, KoolbaseFlags, KoolbaseAnalytics, disabledAnalytics, getOrCreateDeviceId, setPlatform, setSessionRenewal, setFetch, memoryPlatform, MemoryAuthStorage } from '@koolbase/core';
 import { browserPlatform } from './platform.js';
 let _auth = null;
 let _db = null;
@@ -45,6 +45,8 @@ export const Koolbase = {
             return _initializing;
         _initializing = (async () => {
             setPlatform(config.platform ?? browserPlatform());
+            // Every JSON request the SDK makes goes through config.fetch, when one is given (R49).
+            setFetch(config.fetch ?? null);
             _auth = new KoolbaseAuth(config);
             // 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.
@@ -88,6 +90,45 @@ export const Koolbase = {
             _initializing = null;
         }
     },
+    /**
+     * For tests (R49): the real initialize, against a server you give as
+     * `fetch` -- the SDK's own auth and data code runs; only the server is
+     * yours -- with storage and the session in memory, and no analytics or
+     * messaging. Call resetForTesting after each test.
+     *
+     * ```ts
+     * await Koolbase.initializeForTesting({ fetch: myFakeServer });
+     * await Koolbase.auth.login({ email, password });
+     * ```
+     */
+    async initializeForTesting(options) {
+        await Koolbase.initialize({
+            baseUrl: options.baseUrl ?? 'http://koolbase.test',
+            publicKey: options.publicKey ?? 'pk_test',
+            platform: memoryPlatform(),
+            authStorage: new MemoryAuthStorage(),
+            fetch: options.fetch,
+            analyticsEnabled: false,
+            messagingEnabled: false,
+        });
+    },
+    /** After a test (R49): everything initialize made is dropped, so the next one starts from nothing. */
+    resetForTesting() {
+        _connectivity?.stop?.();
+        setSessionRenewal(null);
+        setFetch(null);
+        _auth = null;
+        _db = null;
+        _storage = null;
+        _fiscal = null;
+        _realtime = null;
+        _connectivity = null;
+        _functions = null;
+        _flags = null;
+        _analytics = null;
+        _initialized = false;
+        _initializing = null;
+    },
     get auth() { ensureInitialized(); return _auth; },
     get db() { ensureInitialized(); return _db; },
     get storage() { ensureInitialized(); return _storage; },

package/package.json

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