@uploadista/react-native-core 0.1.3-beta.7 → 0.1.3-beta.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uploadista/react-native-core",
-  "version": "0.1.3-beta.7",
+  "version": "0.1.3-beta.9",
   "type": "module",
   "description": "Core React Native client for Uploadista",
   "license": "MIT",
@@ -15,8 +15,8 @@
   "dependencies": {
     "uuid": "^13.0.0",
     "js-base64": "^3.7.7",
-    "@uploadista/client-core": "0.1.3-beta.7",
-    "@uploadista/core": "0.1.3-beta.7"
+    "@uploadista/client-core": "0.1.3-beta.9",
+    "@uploadista/core": "0.1.3-beta.9"
   },
   "peerDependencies": {
     "react": ">=16.8.0",
@@ -31,7 +31,7 @@
   "devDependencies": {
     "@types/react": ">=18.0.0",
     "tsdown": "0.20.1",
-    "@uploadista/typescript-config": "0.1.3-beta.7"
+    "@uploadista/typescript-config": "0.1.3-beta.9"
   },
   "scripts": {
     "build": "tsc --noEmit && tsdown",

package/src/components/flow-primitives.tsx

@@ -45,6 +45,8 @@ export interface FlowContextValue {
   upload: (file: FilePickResult) => Promise<void>;
   /** Abort the current upload */
   abort: () => void;
+  /** Pause the current upload */
+  pause: () => void;
   /** Reset the upload state and clear all inputs */
   reset: () => void;
 
@@ -56,6 +58,8 @@ export interface FlowContextValue {
   isProcessing: boolean;
   /** Whether the hook is discovering flow inputs */
   isDiscoveringInputs: boolean;
+  /** Whether the flow is currently paused */
+  isPaused: boolean;
 
   /** Pick a file and set it for a specific input node */
   pickFileForInput: (nodeId: string) => Promise<void>;
@@ -241,11 +245,13 @@ function FlowRoot({
     execute: flow.execute,
     upload: flow.upload,
     abort: flow.abort,
+    pause: flow.pause,
     reset: flow.reset,
     isActive: flow.isActive,
     isUploadingFile: flow.isUploadingFile,
     isProcessing: flow.isProcessing,
     isDiscoveringInputs: flow.isDiscoveringInputs,
+    isPaused: flow.isPaused,
     pickFileForInput,
     pickAndUpload,
   };
@@ -726,6 +732,43 @@ function FlowReset({ children }: FlowResetProps) {
   );
 }
 
+/**
+ * Render props for Flow.Pause component.
+ */
+export interface FlowPauseRenderProps {
+  /** Pause the flow */
+  pause: () => void;
+  /** Whether the button should be disabled */
+  isDisabled: boolean;
+  /** Whether currently paused */
+  isPaused: boolean;
+}
+
+/**
+ * Props for Flow.Pause component.
+ */
+export interface FlowPauseProps {
+  /** Render function receiving pause state */
+  children: ReactNode | ((props: FlowPauseRenderProps) => ReactNode);
+}
+
+/**
+ * Pause primitive that pauses the current upload.
+ */
+function FlowPause({ children }: FlowPauseProps) {
+  const flow = useFlowContext();
+
+  const renderProps: FlowPauseRenderProps = {
+    pause: flow.pause,
+    isDisabled: !flow.isActive || flow.isPaused,
+    isPaused: flow.isPaused,
+  };
+
+  return (
+    <>{typeof children === "function" ? children(renderProps) : children}</>
+  );
+}
+
 // ============ QUICK UPLOAD PRIMITIVE ============
 
 /**
@@ -842,6 +885,7 @@ export const Flow = Object.assign(FlowRoot, {
   Error: FlowError,
   Submit: FlowSubmit,
   Cancel: FlowCancel,
+  Pause: FlowPause,
   Reset: FlowReset,
   QuickUpload: FlowQuickUpload,
 });

package/src/components/index.ts

@@ -27,6 +27,8 @@ export {
   type FlowInputProps,
   type FlowInputsProps,
   type FlowInputsRenderProps,
+  type FlowPauseProps,
+  type FlowPauseRenderProps,
   type FlowProgressProps,
   type FlowProgressRenderProps,
   type FlowProps,

package/src/hooks/use-flow.ts

@@ -166,6 +166,16 @@ export interface UseFlowReturn {
    * Whether a retry is possible (after error or abort with stored inputs)
    */
   canRetry: boolean;
+
+  /**
+   * Pause the current upload
+   */
+  pause: () => void;
+
+  /**
+   * Whether the flow is currently paused
+   */
+  isPaused: boolean;
 }
 
 const initialState: FlowUploadState = {
@@ -179,6 +189,7 @@ const initialState: FlowUploadState = {
   currentNodeName: null,
   currentNodeType: null,
   flowOutputs: null,
+  pausedAtNodeId: null,
 };
 
 /**
@@ -529,6 +540,10 @@ export function useFlow(options: UseFlowOptions): UseFlowReturn {
     managerRef.current?.abort();
   }, []);
 
+  const pause = useCallback(() => {
+    managerRef.current?.pause();
+  }, []);
+
   const reset = useCallback(() => {
     managerRef.current?.reset();
     setInputs({});
@@ -552,6 +567,7 @@ export function useFlow(options: UseFlowOptions): UseFlowReturn {
     state.status === "uploading" || state.status === "processing";
   const isUploadingFile = state.status === "uploading";
   const isProcessing = state.status === "processing";
+  const isPaused = state.status === "paused";
   const canRetry =
     (state.status === "error" || state.status === "aborted") &&
     lastInputsRef.current !== null;
@@ -565,6 +581,7 @@ export function useFlow(options: UseFlowOptions): UseFlowReturn {
     execute,
     upload,
     abort,
+    pause,
     reset,
     retry,
     isActive,
@@ -572,5 +589,6 @@ export function useFlow(options: UseFlowOptions): UseFlowReturn {
     isProcessing,
     isDiscoveringInputs,
     canRetry,
+    isPaused,
   };
 }

package/src/index.ts

@@ -48,6 +48,8 @@ export {
   type FlowInputProps,
   type FlowInputsProps,
   type FlowInputsRenderProps,
+  type FlowPauseProps,
+  type FlowPauseRenderProps,
   type FlowProgressProps,
   type FlowProgressRenderProps,
   type FlowProps,