@koolbase/react-native 12.19.0 → 12.21.0

package/dist/cjs/index.d.ts

@@ -57,3 +57,34 @@ export type { UseFilesResult } from '@koolbase/core/react';
  * ```
  */
 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;
+export type { UseUploadQueueResult } from '@koolbase/core/react';
+/**
+ * Several uploads as React state (storage S4): three at a time unless set,
+ * each file with its own status ('queued' | 'uploading' | 'verifying' |
+ * 'done' | 'failed' | 'cancelled'), progress and error, and cancel and retry
+ * by id. A failed file never stops the others. Use it after
+ * Koolbase.initialize().
+ *
+ * ```tsx
+ * const queue = useUploadQueue();
+ * queue.add(picked.map((f) => ({ bucket: 'photos', path: `trips/${f.name}`, file: f })));
+ * queue.items.map((u) => <Row key={u.id} name={u.name} progress={u.progress} />);
+ * ```
+ */
+export declare const useUploadQueue: (options?: {
+    concurrency?: number;
+}) => import("@koolbase/core/react").UseUploadQueueResult;

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.useFiles = exports.useRecord = exports.useCollection = exports.SecureAuthStorage = exports.Koolbase = exports.reactNativePlatform = void 0;
+exports.useUploadQueue = 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.
 //
@@ -212,3 +212,30 @@ exports.useRecord = (0, react_1.createUseRecord)(() => exports.Koolbase.db);
  * ```
  */
 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);
+/**
+ * Several uploads as React state (storage S4): three at a time unless set,
+ * each file with its own status ('queued' | 'uploading' | 'verifying' |
+ * 'done' | 'failed' | 'cancelled'), progress and error, and cancel and retry
+ * by id. A failed file never stops the others. Use it after
+ * Koolbase.initialize().
+ *
+ * ```tsx
+ * const queue = useUploadQueue();
+ * queue.add(picked.map((f) => ({ bucket: 'photos', path: `trips/${f.name}`, file: f })));
+ * queue.items.map((u) => <Row key={u.id} name={u.name} progress={u.progress} />);
+ * ```
+ */
+exports.useUploadQueue = (0, react_1.createUseUploadQueue)(() => exports.Koolbase.storage);

package/dist/esm/index.d.ts

@@ -57,3 +57,34 @@ export type { UseFilesResult } from '@koolbase/core/react';
  * ```
  */
 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;
+export type { UseUploadQueueResult } from '@koolbase/core/react';
+/**
+ * Several uploads as React state (storage S4): three at a time unless set,
+ * each file with its own status ('queued' | 'uploading' | 'verifying' |
+ * 'done' | 'failed' | 'cancelled'), progress and error, and cancel and retry
+ * by id. A failed file never stops the others. Use it after
+ * Koolbase.initialize().
+ *
+ * ```tsx
+ * const queue = useUploadQueue();
+ * queue.add(picked.map((f) => ({ bucket: 'photos', path: `trips/${f.name}`, file: f })));
+ * queue.items.map((u) => <Row key={u.id} name={u.name} progress={u.progress} />);
+ * ```
+ */
+export declare const useUploadQueue: (options?: {
+    concurrency?: number;
+}) => import("@koolbase/core/react").UseUploadQueueResult;

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, createUseFiles, createUseRecord } from '@koolbase/core/react';
+import { createUseCollection, createUseFile, createUseFiles, createUseRecord, createUseUploadQueue } from '@koolbase/core/react';
 let _auth = null;
 let _db = null;
 let _storage = null;
@@ -193,3 +193,30 @@ export const useRecord = createUseRecord(() => Koolbase.db);
  * ```
  */
 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);
+/**
+ * Several uploads as React state (storage S4): three at a time unless set,
+ * each file with its own status ('queued' | 'uploading' | 'verifying' |
+ * 'done' | 'failed' | 'cancelled'), progress and error, and cancel and retry
+ * by id. A failed file never stops the others. Use it after
+ * Koolbase.initialize().
+ *
+ * ```tsx
+ * const queue = useUploadQueue();
+ * queue.add(picked.map((f) => ({ bucket: 'photos', path: `trips/${f.name}`, file: f })));
+ * queue.items.map((u) => <Row key={u.id} name={u.name} progress={u.progress} />);
+ * ```
+ */
+export const useUploadQueue = createUseUploadQueue(() => Koolbase.storage);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koolbase/react-native",
-  "version": "12.19.0",
+  "version": "12.21.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.19.0"
+    "@koolbase/core": "12.21.0"
   },
   "peerDependencies": {
     "@react-native-async-storage/async-storage": "^2.2.0 || ^3.0.2",