@koolbase/react-native 12.8.0 → 12.10.0

package/dist/cjs/index.d.ts

@@ -18,7 +18,7 @@ export declare const Koolbase: {
     checkVersion(currentVersion: string): VersionCheckResult;
 };
 export { SecureAuthStorage } from './auth-storage.js';
-export type { UseCollectionResult } from './use-collection.js';
+export type { UseCollectionResult } from '@koolbase/core/react';
 /**
  * A collection as React state: loading, loaded or error, with refresh and
  * loadMore. Equality filters only for now: `where: { field: value }`.
@@ -28,8 +28,8 @@ export type { UseCollectionResult } from './use-collection.js';
  * const songs = useCollection('songs', { where: { genre: 'jazz' }, orderBy: 'title' });
  * ```
  */
-export declare const useCollection: (collection: string, query?: import("@koolbase/core").CollectionQuery) => import("./use-collection.js").UseCollectionResult;
-export type { UseRecordResult } from './use-record.js';
+export declare const useCollection: (collection: string, query?: import("@koolbase/core/dist/cjs").CollectionQuery) => import("@koolbase/core/react").UseCollectionResult;
+export type { UseRecordResult } from '@koolbase/core/react';
 /**
  * One record, by id, as React state: loading, loaded, notFound or error,
  * with refresh. notFound covers a missing id, a record that does not exist,
@@ -40,4 +40,4 @@ export type { UseRecordResult } from './use-record.js';
  * const song = useRecord('songs', songId);
  * ```
  */
-export declare const useRecord: (collection: string, id: string | null | undefined) => import("./use-record.js").UseRecordResult;
+export declare const useRecord: (collection: string, id: string | null | undefined) => import("@koolbase/core/react").UseRecordResult;

package/dist/cjs/index.js

@@ -1,10 +1,4 @@
 "use strict";
-// @koolbase/react-native — composes @koolbase/core for a React Native host.
-//
-// Everything the core exports is re-exported here unchanged, so an app that
-// installed this package before the split sees the same surface. What this
-// file adds is the composition: one Koolbase singleton, initialized with the
-// React Native platform adapter and keychain-backed session storage.
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -21,13 +15,19 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useRecord = exports.useCollection = exports.SecureAuthStorage = exports.Koolbase = exports.reactNativePlatform = void 0;
+const react_native_1 = require("react-native");
+// @koolbase/react-native — composes @koolbase/core for a React Native host.
+//
+// Everything the core exports is re-exported here unchanged, so an app that
+// installed this package before the split sees the same surface. What this
+// file adds is the composition: one Koolbase singleton, initialized with the
+// React Native platform adapter and keychain-backed session storage.
 __exportStar(require("@koolbase/core"), exports);
 var platform_js_1 = require("./platform.js");
 Object.defineProperty(exports, "reactNativePlatform", { enumerable: true, get: function () { return platform_js_1.reactNativePlatform; } });
 const core_1 = require("@koolbase/core");
 const platform_js_2 = require("./platform.js");
-const use_collection_js_1 = require("./use-collection.js");
-const use_record_js_1 = require("./use-record.js");
+const react_1 = require("@koolbase/core/react");
 let _auth = null;
 let _db = null;
 let _storage = null;
@@ -70,7 +70,10 @@ exports.Koolbase = {
             // app catching KoolbaseUnauthenticatedError is already signed out and can
             // route to login, rather than looping on a dead token.
             async () => { await _auth?.clearStoredSession(); });
-            _storage = new core_1.KoolbaseStorage(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
+            _storage = new core_1.KoolbaseStorage(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); }, 
+            // 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(); });
             _realtime = new core_1.KoolbaseRealtime(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), () => _auth?.currentUser?.id ?? null);
             _functions = new core_1.KoolbaseFunctions(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
@@ -78,6 +81,9 @@ exports.Koolbase = {
             // (code push), and registration keying (messaging) must all agree on it.
             const deviceId = await (0, core_1.getOrCreateDeviceId)();
             _flags = new core_1.KoolbaseFlags(config, deviceId);
+            // The bootstrap payload (flags, config, version policy, project identity),
+            // fetched in the background as Flutter's SDK does: never blocks startup.
+            void _flags.koolbaseFetch(config.appVersion ?? '0.0.0', react_native_1.Platform.OS);
             // Initialize analytics
             // Opt-in: nothing is sent unless the app asks for it.
             if (config.analyticsEnabled === true) {
@@ -164,7 +170,7 @@ Object.defineProperty(exports, "SecureAuthStorage", { enumerable: true, get: fun
  * const songs = useCollection('songs', { where: { genre: 'jazz' }, orderBy: 'title' });
  * ```
  */
-exports.useCollection = (0, use_collection_js_1.createUseCollection)(() => exports.Koolbase.db);
+exports.useCollection = (0, react_1.createUseCollection)(() => exports.Koolbase.db);
 /**
  * One record, by id, as React state: loading, loaded, notFound or error,
  * with refresh. notFound covers a missing id, a record that does not exist,
@@ -175,4 +181,4 @@ exports.useCollection = (0, use_collection_js_1.createUseCollection)(() => expor
  * const song = useRecord('songs', songId);
  * ```
  */
-exports.useRecord = (0, use_record_js_1.createUseRecord)(() => exports.Koolbase.db);
+exports.useRecord = (0, react_1.createUseRecord)(() => exports.Koolbase.db);

package/dist/esm/index.d.ts

@@ -18,7 +18,7 @@ export declare const Koolbase: {
     checkVersion(currentVersion: string): VersionCheckResult;
 };
 export { SecureAuthStorage } from './auth-storage.js';
-export type { UseCollectionResult } from './use-collection.js';
+export type { UseCollectionResult } from '@koolbase/core/react';
 /**
  * A collection as React state: loading, loaded or error, with refresh and
  * loadMore. Equality filters only for now: `where: { field: value }`.
@@ -28,8 +28,8 @@ export type { UseCollectionResult } from './use-collection.js';
  * const songs = useCollection('songs', { where: { genre: 'jazz' }, orderBy: 'title' });
  * ```
  */
-export declare const useCollection: (collection: string, query?: import("@koolbase/core").CollectionQuery) => import("./use-collection.js").UseCollectionResult;
-export type { UseRecordResult } from './use-record.js';
+export declare const useCollection: (collection: string, query?: import("@koolbase/core").CollectionQuery) => import("@koolbase/core/react").UseCollectionResult;
+export type { UseRecordResult } from '@koolbase/core/react';
 /**
  * One record, by id, as React state: loading, loaded, notFound or error,
  * with refresh. notFound covers a missing id, a record that does not exist,
@@ -40,4 +40,4 @@ export type { UseRecordResult } from './use-record.js';
  * const song = useRecord('songs', songId);
  * ```
  */
-export declare const useRecord: (collection: string, id: string | null | undefined) => import("./use-record.js").UseRecordResult;
+export declare const useRecord: (collection: string, id: string | null | undefined) => import("@koolbase/core/react").UseRecordResult;

package/dist/esm/index.js

@@ -1,3 +1,4 @@
+import { Platform } from 'react-native';
 // @koolbase/react-native — composes @koolbase/core for a React Native host.
 //
 // Everything the core exports is re-exported here unchanged, so an app that
@@ -8,8 +9,7 @@ export * from '@koolbase/core';
 export { reactNativePlatform } from './platform.js';
 import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseFlags, KoolbaseAnalytics, disabledAnalytics, KoolbaseMessaging, getOrCreateDeviceId, setPlatform, } from '@koolbase/core';
 import { reactNativePlatform } from './platform.js';
-import { createUseCollection } from './use-collection.js';
-import { createUseRecord } from './use-record.js';
+import { createUseCollection, createUseRecord } from '@koolbase/core/react';
 let _auth = null;
 let _db = null;
 let _storage = null;
@@ -52,7 +52,10 @@ export const Koolbase = {
             // app catching KoolbaseUnauthenticatedError is already signed out and can
             // route to login, rather than looping on a dead token.
             async () => { await _auth?.clearStoredSession(); });
-            _storage = new KoolbaseStorage(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
+            _storage = new KoolbaseStorage(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); }, 
+            // 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(); });
             _realtime = new KoolbaseRealtime(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), () => _auth?.currentUser?.id ?? null);
             _functions = new KoolbaseFunctions(config, () => _auth?.validAccessToken() ?? Promise.resolve(null), async () => { await _auth?.clearStoredSession(); });
@@ -60,6 +63,9 @@ export const Koolbase = {
             // (code push), and registration keying (messaging) must all agree on it.
             const deviceId = await getOrCreateDeviceId();
             _flags = new KoolbaseFlags(config, deviceId);
+            // The bootstrap payload (flags, config, version policy, project identity),
+            // fetched in the background as Flutter's SDK does: never blocks startup.
+            void _flags.koolbaseFetch(config.appVersion ?? '0.0.0', Platform.OS);
             // Initialize analytics
             // Opt-in: nothing is sent unless the app asks for it.
             if (config.analyticsEnabled === true) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@koolbase/react-native",
-  "version": "12.8.0",
-  "description": "React Native SDK for Koolbase — auth, database, storage, realtime, feature flags, and functions in one package.",
+  "version": "12.10.0",
+  "description": "React Native SDK for Koolbase \u2014 auth, database, storage, realtime, feature flags, and functions in one package.",
   "main": "./dist/cjs/index.js",
   "types": "./dist/esm/index.d.ts",
   "files": [
@@ -24,7 +24,7 @@
     "url": "https://github.com/koolbase/koolbase-react-native"
   },
   "dependencies": {
-    "@koolbase/core": "12.8.0"
+    "@koolbase/core": "12.10.0"
   },
   "peerDependencies": {
     "@react-native-async-storage/async-storage": "^2.2.0 || ^3.0.2",

package/dist/cjs/use-collection.d.ts

@@ -1,12 +0,0 @@
-import { type CollectionQuery, type CollectionState, type KoolbaseDatabase } from '@koolbase/core';
-export interface UseCollectionResult extends CollectionState {
-    /** Page one again, from the server. What is shown stays while it runs, and stays if it fails. */
-    refresh: () => Promise<void>;
-    /**
-     * The next page, appended, while hasMore. If rows are added or removed on
-     * the server between pages, one can be skipped until refresh(); none is
-     * ever shown twice.
-     */
-    loadMore: () => Promise<void>;
-}
-export declare function createUseCollection(getDb: () => Pick<KoolbaseDatabase, 'query'>): (collection: string, query?: CollectionQuery) => UseCollectionResult;

package/dist/cjs/use-collection.js

@@ -1,39 +0,0 @@
-"use strict";
-// useCollection: a Koolbase collection as React state.
-//
-// A thin wrapper. Everything about getting the records right lives in
-// @koolbase/core's KoolbaseCollectionController, which is tested there; this
-// file only ties one controller's lifetime to a component's.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createUseCollection = createUseCollection;
-const react_1 = require("react");
-const core_1 = require("@koolbase/core");
-const noop = () => { };
-const done = () => Promise.resolve();
-function createUseCollection(getDb) {
-    return function useCollection(collection, query = {}) {
-        // The query as a value: an inline `where` object is a new object every
-        // render, and must not start a new fetch every render.
-        const key = (0, core_1.collectionQueryKey)(collection, query);
-        const [current, setCurrent] = (0, react_1.useState)(null);
-        (0, react_1.useEffect)(() => {
-            // Created here, not during render. Under React strict mode an effect
-            // runs, cleans up and runs again; each run gets its own controller, so
-            // the one left running is never one that was already disposed.
-            const controller = new core_1.KoolbaseCollectionController(getDb(), collection, query);
-            setCurrent({ key, controller });
-            void controller.load();
-            return () => controller.dispose();
-            // Depends on key alone: key is collection + query, as a value.
-        }, [key]);
-        // A controller from the previous key reads as a fresh load, never as
-        // the previous query's records.
-        const controller = current?.key === key ? current.controller : null;
-        const subscribe = (0, react_1.useCallback)((onChange) => (controller ? controller.subscribe(onChange) : noop), [controller]);
-        const getSnapshot = (0, react_1.useCallback)(() => (controller ? controller.getState() : core_1.initialCollectionState), [controller]);
-        const state = (0, react_1.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
-        const refresh = (0, react_1.useCallback)(() => (controller ? controller.refresh() : done()), [controller]);
-        const loadMore = (0, react_1.useCallback)(() => (controller ? controller.loadMore() : done()), [controller]);
-        return { ...state, refresh, loadMore };
-    };
-}

package/dist/cjs/use-record.d.ts

@@ -1,6 +0,0 @@
-import { type KoolbaseDatabase, type RecordState } from '@koolbase/core';
-export interface UseRecordResult extends RecordState {
-    /** The record again, from the server. What is shown stays while it runs, and stays if it fails. */
-    refresh: () => Promise<void>;
-}
-export declare function createUseRecord(getDb: () => Pick<KoolbaseDatabase, 'get'>): (collection: string, id: string | null | undefined) => UseRecordResult;

package/dist/cjs/use-record.js

@@ -1,35 +0,0 @@
-"use strict";
-// useRecord: one Koolbase record, by id, as React state.
-//
-// A thin wrapper, like useCollection: everything about getting the record
-// right lives in @koolbase/core's KoolbaseRecordController, tested there;
-// this file only ties one controller's lifetime to a component's.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createUseRecord = createUseRecord;
-const react_1 = require("react");
-const core_1 = require("@koolbase/core");
-const noop = () => { };
-const done = () => Promise.resolve();
-function createUseRecord(getDb) {
-    return function useRecord(collection, id) {
-        const key = JSON.stringify([collection, id ?? '']);
-        const [current, setCurrent] = (0, react_1.useState)(null);
-        (0, react_1.useEffect)(() => {
-            // Created here, not during render: under React strict mode an effect
-            // runs, cleans up and runs again, and each run gets its own controller.
-            const controller = new core_1.KoolbaseRecordController(getDb(), collection, id ?? '');
-            setCurrent({ key, controller });
-            void controller.load();
-            return () => controller.dispose();
-            // Depends on key alone: key is collection + id, as a value.
-        }, [key]);
-        // A controller from the previous key reads as a fresh load, never as the
-        // previous record.
-        const controller = current?.key === key ? current.controller : null;
-        const subscribe = (0, react_1.useCallback)((onChange) => (controller ? controller.subscribe(onChange) : noop), [controller]);
-        const getSnapshot = (0, react_1.useCallback)(() => (controller ? controller.getState() : core_1.initialRecordState), [controller]);
-        const state = (0, react_1.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
-        const refresh = (0, react_1.useCallback)(() => (controller ? controller.refresh() : done()), [controller]);
-        return { ...state, refresh };
-    };
-}

package/dist/esm/use-collection.d.ts

@@ -1,12 +0,0 @@
-import { type CollectionQuery, type CollectionState, type KoolbaseDatabase } from '@koolbase/core';
-export interface UseCollectionResult extends CollectionState {
-    /** Page one again, from the server. What is shown stays while it runs, and stays if it fails. */
-    refresh: () => Promise<void>;
-    /**
-     * The next page, appended, while hasMore. If rows are added or removed on
-     * the server between pages, one can be skipped until refresh(); none is
-     * ever shown twice.
-     */
-    loadMore: () => Promise<void>;
-}
-export declare function createUseCollection(getDb: () => Pick<KoolbaseDatabase, 'query'>): (collection: string, query?: CollectionQuery) => UseCollectionResult;

package/dist/esm/use-collection.js

@@ -1,36 +0,0 @@
-// useCollection: a Koolbase collection as React state.
-//
-// A thin wrapper. Everything about getting the records right lives in
-// @koolbase/core's KoolbaseCollectionController, which is tested there; this
-// file only ties one controller's lifetime to a component's.
-import { useCallback, useEffect, useState, useSyncExternalStore } from 'react';
-import { KoolbaseCollectionController, collectionQueryKey, initialCollectionState, } from '@koolbase/core';
-const noop = () => { };
-const done = () => Promise.resolve();
-export function createUseCollection(getDb) {
-    return function useCollection(collection, query = {}) {
-        // The query as a value: an inline `where` object is a new object every
-        // render, and must not start a new fetch every render.
-        const key = collectionQueryKey(collection, query);
-        const [current, setCurrent] = useState(null);
-        useEffect(() => {
-            // Created here, not during render. Under React strict mode an effect
-            // runs, cleans up and runs again; each run gets its own controller, so
-            // the one left running is never one that was already disposed.
-            const controller = new KoolbaseCollectionController(getDb(), collection, query);
-            setCurrent({ key, controller });
-            void controller.load();
-            return () => controller.dispose();
-            // Depends on key alone: key is collection + query, as a value.
-        }, [key]);
-        // A controller from the previous key reads as a fresh load, never as
-        // the previous query's records.
-        const controller = current?.key === key ? current.controller : null;
-        const subscribe = useCallback((onChange) => (controller ? controller.subscribe(onChange) : noop), [controller]);
-        const getSnapshot = useCallback(() => (controller ? controller.getState() : initialCollectionState), [controller]);
-        const state = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
-        const refresh = useCallback(() => (controller ? controller.refresh() : done()), [controller]);
-        const loadMore = useCallback(() => (controller ? controller.loadMore() : done()), [controller]);
-        return { ...state, refresh, loadMore };
-    };
-}

package/dist/esm/use-record.d.ts

@@ -1,6 +0,0 @@
-import { type KoolbaseDatabase, type RecordState } from '@koolbase/core';
-export interface UseRecordResult extends RecordState {
-    /** The record again, from the server. What is shown stays while it runs, and stays if it fails. */
-    refresh: () => Promise<void>;
-}
-export declare function createUseRecord(getDb: () => Pick<KoolbaseDatabase, 'get'>): (collection: string, id: string | null | undefined) => UseRecordResult;

package/dist/esm/use-record.js

@@ -1,32 +0,0 @@
-// useRecord: one Koolbase record, by id, as React state.
-//
-// A thin wrapper, like useCollection: everything about getting the record
-// right lives in @koolbase/core's KoolbaseRecordController, tested there;
-// this file only ties one controller's lifetime to a component's.
-import { useCallback, useEffect, useState, useSyncExternalStore } from 'react';
-import { KoolbaseRecordController, initialRecordState, } from '@koolbase/core';
-const noop = () => { };
-const done = () => Promise.resolve();
-export function createUseRecord(getDb) {
-    return function useRecord(collection, id) {
-        const key = JSON.stringify([collection, id ?? '']);
-        const [current, setCurrent] = useState(null);
-        useEffect(() => {
-            // Created here, not during render: under React strict mode an effect
-            // runs, cleans up and runs again, and each run gets its own controller.
-            const controller = new KoolbaseRecordController(getDb(), collection, id ?? '');
-            setCurrent({ key, controller });
-            void controller.load();
-            return () => controller.dispose();
-            // Depends on key alone: key is collection + id, as a value.
-        }, [key]);
-        // A controller from the previous key reads as a fresh load, never as the
-        // previous record.
-        const controller = current?.key === key ? current.controller : null;
-        const subscribe = useCallback((onChange) => (controller ? controller.subscribe(onChange) : noop), [controller]);
-        const getSnapshot = useCallback(() => (controller ? controller.getState() : initialRecordState), [controller]);
-        const state = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
-        const refresh = useCallback(() => (controller ? controller.refresh() : done()), [controller]);
-        return { ...state, refresh };
-    };
-}