@koolbase/react-native 12.18.0 → 12.20.0

package/dist/cjs/index.d.ts

@@ -44,3 +44,30 @@ export type { UseRecordResult } from '@koolbase/core/react';
 export declare const useRecord: (collection: string, id: string | null | undefined, options?: {
     live?: boolean;
 }) => import("@koolbase/core/react").UseRecordResult;
+export type { UseFilesResult } from '@koolbase/core/react';
+/**
+ * A bucket's files as React state (storage S4): loading, loaded or error,
+ * with refresh and loadMore -- only the files the signed-in person may view.
+ * Reloads by itself after an upload, delete, move, copy, metadata change or
+ * restore made through this SDK in the bucket. Use it after
+ * Koolbase.initialize().
+ *
+ * ```tsx
+ * const photos = useFiles('photos', { prefix: 'trips/', sort: 'createdAt', descending: true });
+ * ```
+ */
+export declare const useFiles: (bucket: string, query?: import("@koolbase/core/dist/cjs").FilesQuery) => import("@koolbase/core/react").UseFilesResult;
+export type { UseFileResult } from '@koolbase/core/react';
+/**
+ * One file's details as React state (storage S4): loading, loaded, notFound
+ * or error, with refresh -- only a file the signed-in person may view. Reads
+ * it again by itself after a change made through this SDK in the bucket: a
+ * deleted or moved file is notFound. An empty path is notFound, with no
+ * request. Use it after Koolbase.initialize().
+ *
+ * ```tsx
+ * const photo = useFile('photos', path);
+ * if (photo.status === 'loaded') return <Text>{photo.file.name}</Text>;
+ * ```
+ */
+export declare const useFile: (bucket: string, path: string | null | undefined) => import("@koolbase/core/react").UseFileResult;

package/dist/cjs/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useRecord = exports.useCollection = exports.SecureAuthStorage = exports.Koolbase = exports.reactNativePlatform = void 0;
+exports.useFile = exports.useFiles = 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.
 //
@@ -200,3 +200,28 @@ exports.useCollection = (0, react_1.createUseCollection)(() => exports.Koolbase.
  * ```
  */
 exports.useRecord = (0, react_1.createUseRecord)(() => exports.Koolbase.db);
+/**
+ * A bucket's files as React state (storage S4): loading, loaded or error,
+ * with refresh and loadMore -- only the files the signed-in person may view.
+ * Reloads by itself after an upload, delete, move, copy, metadata change or
+ * restore made through this SDK in the bucket. Use it after
+ * Koolbase.initialize().
+ *
+ * ```tsx
+ * const photos = useFiles('photos', { prefix: 'trips/', sort: 'createdAt', descending: true });
+ * ```
+ */
+exports.useFiles = (0, react_1.createUseFiles)(() => exports.Koolbase.storage);
+/**
+ * One file's details as React state (storage S4): loading, loaded, notFound
+ * or error, with refresh -- only a file the signed-in person may view. Reads
+ * it again by itself after a change made through this SDK in the bucket: a
+ * deleted or moved file is notFound. An empty path is notFound, with no
+ * request. Use it after Koolbase.initialize().
+ *
+ * ```tsx
+ * const photo = useFile('photos', path);
+ * if (photo.status === 'loaded') return <Text>{photo.file.name}</Text>;
+ * ```
+ */
+exports.useFile = (0, react_1.createUseFile)(() => exports.Koolbase.storage);

package/dist/esm/index.d.ts

@@ -44,3 +44,30 @@ export type { UseRecordResult } from '@koolbase/core/react';
 export declare const useRecord: (collection: string, id: string | null | undefined, options?: {
     live?: boolean;
 }) => import("@koolbase/core/react").UseRecordResult;
+export type { UseFilesResult } from '@koolbase/core/react';
+/**
+ * A bucket's files as React state (storage S4): loading, loaded or error,
+ * with refresh and loadMore -- only the files the signed-in person may view.
+ * Reloads by itself after an upload, delete, move, copy, metadata change or
+ * restore made through this SDK in the bucket. Use it after
+ * Koolbase.initialize().
+ *
+ * ```tsx
+ * const photos = useFiles('photos', { prefix: 'trips/', sort: 'createdAt', descending: true });
+ * ```
+ */
+export declare const useFiles: (bucket: string, query?: import("@koolbase/core").FilesQuery) => import("@koolbase/core/react").UseFilesResult;
+export type { UseFileResult } from '@koolbase/core/react';
+/**
+ * One file's details as React state (storage S4): loading, loaded, notFound
+ * or error, with refresh -- only a file the signed-in person may view. Reads
+ * it again by itself after a change made through this SDK in the bucket: a
+ * deleted or moved file is notFound. An empty path is notFound, with no
+ * request. Use it after Koolbase.initialize().
+ *
+ * ```tsx
+ * const photo = useFile('photos', path);
+ * if (photo.status === 'loaded') return <Text>{photo.file.name}</Text>;
+ * ```
+ */
+export declare const useFile: (bucket: string, path: string | null | undefined) => import("@koolbase/core/react").UseFileResult;

package/dist/esm/index.js

@@ -9,7 +9,7 @@ export * from '@koolbase/core';
 export { reactNativePlatform } from './platform.js';
 import { KoolbaseAuth, KoolbaseDatabase, KoolbaseFiscal, KoolbaseStorage, KoolbaseRealtime, KoolbaseFunctions, KoolbaseConnectivity, KoolbaseFlags, KoolbaseAnalytics, disabledAnalytics, KoolbaseMessaging, getOrCreateDeviceId, setPlatform, setSessionRenewal } from '@koolbase/core';
 import { reactNativePlatform } from './platform.js';
-import { createUseCollection, createUseRecord } from '@koolbase/core/react';
+import { createUseCollection, createUseFile, createUseFiles, createUseRecord } from '@koolbase/core/react';
 let _auth = null;
 let _db = null;
 let _storage = null;
@@ -181,3 +181,28 @@ export const useCollection = createUseCollection(() => Koolbase.db);
  * ```
  */
 export const useRecord = createUseRecord(() => Koolbase.db);
+/**
+ * A bucket's files as React state (storage S4): loading, loaded or error,
+ * with refresh and loadMore -- only the files the signed-in person may view.
+ * Reloads by itself after an upload, delete, move, copy, metadata change or
+ * restore made through this SDK in the bucket. Use it after
+ * Koolbase.initialize().
+ *
+ * ```tsx
+ * const photos = useFiles('photos', { prefix: 'trips/', sort: 'createdAt', descending: true });
+ * ```
+ */
+export const useFiles = createUseFiles(() => Koolbase.storage);
+/**
+ * One file's details as React state (storage S4): loading, loaded, notFound
+ * or error, with refresh -- only a file the signed-in person may view. Reads
+ * it again by itself after a change made through this SDK in the bucket: a
+ * deleted or moved file is notFound. An empty path is notFound, with no
+ * request. Use it after Koolbase.initialize().
+ *
+ * ```tsx
+ * const photo = useFile('photos', path);
+ * if (photo.status === 'loaded') return <Text>{photo.file.name}</Text>;
+ * ```
+ */
+export const useFile = createUseFile(() => Koolbase.storage);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koolbase/react-native",
-  "version": "12.18.0",
+  "version": "12.20.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.18.0"
+    "@koolbase/core": "12.20.0"
   },
   "peerDependencies": {
     "@react-native-async-storage/async-storage": "^2.2.0 || ^3.0.2",