@koolbase/react-native 12.9.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

@@ -27,8 +27,7 @@ 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;
@@ -171,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,
@@ -182,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

@@ -9,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koolbase/react-native",
-  "version": "12.9.0",
+  "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",
@@ -24,7 +24,7 @@
     "url": "https://github.com/koolbase/koolbase-react-native"
   },
   "dependencies": {
-    "@koolbase/core": "12.9.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 };
-    };
-}