captify 0.1.15

package/dist/hooks/use-file-download.js

@@ -0,0 +1,191 @@
+/* eslint-disable no-console */
+import { DEFAULT_LARGE_FILE_WARNING_THRESHOLD, DEFAULT_MAX_RETRIES, DEFAULT_PROGRESS_TRACKING_MAX_SIZE, DEFAULT_PROGRESS_TRACKING_MIN_SIZE, } from "../constants";
+import { downloadWithProgress, isCorsError, mapDownloadErrorMessage, triggerDirectDownload, } from "../utils/file-download-utilities";
+import { useCallback, useEffect, useRef, useState } from "react";
+export function useFileDownload({ file, canDownload, disabled = false, showProgress = false, largeFileWarningThreshold = DEFAULT_LARGE_FILE_WARNING_THRESHOLD, progressTrackingMinSize = DEFAULT_PROGRESS_TRACKING_MIN_SIZE, progressTrackingMaxSize = DEFAULT_PROGRESS_TRACKING_MAX_SIZE, generateDownloadUrl, logDownload, onDownloaded, onError, onProgress, maxRetries = DEFAULT_MAX_RETRIES, }) {
+    const [isDownloading, setIsDownloading] = useState(false);
+    const [error, setError] = useState(null);
+    const [success, setSuccess] = useState(false);
+    const [retryCount, setRetryCount] = useState(0);
+    const [downloadProgress, setDownloadProgress] = useState(0);
+    const [showLargeFileDialog, setShowLargeFileDialog] = useState(false);
+    const abortControllerRef = useRef(null);
+    const timeoutRefs = useRef(new Set());
+    const proceedWithDownloadRef = useRef(undefined);
+    // Cleanup on unmount
+    useEffect(() => {
+        const timeouts = timeoutRefs.current;
+        return () => {
+            var _a;
+            (_a = abortControllerRef.current) === null || _a === void 0 ? void 0 : _a.abort();
+            timeouts.forEach((timeoutId) => clearTimeout(timeoutId));
+            timeouts.clear();
+        };
+    }, []);
+    const proceedWithDownload = useCallback(async () => {
+        setShowLargeFileDialog(false);
+        setIsDownloading(true);
+        setError(null);
+        setSuccess(false);
+        setDownloadProgress(0);
+        // Create new AbortController for this download
+        abortControllerRef.current = new AbortController();
+        const { signal } = abortControllerRef.current;
+        try {
+            // Request pre-signed URL
+            const result = await generateDownloadUrl(file.id, file.key);
+            if (!result.success || !result.url) {
+                throw new Error("Failed to generate download URL");
+            }
+            if (signal.aborted) {
+                return;
+            }
+            const useProgressTracking = showProgress && file.size > progressTrackingMinSize && file.size <= progressTrackingMaxSize;
+            let downloadSuccess = false;
+            if (useProgressTracking) {
+                try {
+                    await downloadWithProgress(result.url, file.originalName, file.size, signal, (percentage, loaded) => {
+                        setDownloadProgress(percentage);
+                        onProgress === null || onProgress === void 0 ? void 0 : onProgress({ loaded, total: file.size, percentage });
+                    });
+                    downloadSuccess = true;
+                }
+                catch (fetchError) {
+                    if (isCorsError(fetchError)) {
+                        console.info(`📥 Download continuing via direct method (progress tracking unavailable due to CORS).\n` +
+                            `   File: ${file.originalName}\n` +
+                            `   ℹ️  To enable progress tracking, see: app/(group)/file-download-demo/S3-CORS-SETUP.md`);
+                        // Fall through to direct download
+                    }
+                    else {
+                        throw fetchError;
+                    }
+                }
+            }
+            if (!downloadSuccess) {
+                triggerDirectDownload(result.url, file.originalName);
+                downloadSuccess = true;
+            }
+            if (signal.aborted) {
+                return;
+            }
+            if (logDownload) {
+                try {
+                    await logDownload(file.id, file.key);
+                }
+                catch (logError) {
+                    console.warn(`Failed to log download for ${file.originalName}:`, logError instanceof Error ? logError.message : "unknown");
+                }
+            }
+            setSuccess(true);
+            setDownloadProgress(100);
+            if (onDownloaded) {
+                try {
+                    onDownloaded(file.id);
+                }
+                catch (callbackError) {
+                    console.warn("Download callback error:", callbackError);
+                }
+            }
+            // Reset success state after 3 seconds
+            const successTimeoutId = setTimeout(() => {
+                timeoutRefs.current.delete(successTimeoutId);
+                setSuccess(false);
+                setDownloadProgress(0);
+            }, 3000);
+            timeoutRefs.current.add(successTimeoutId);
+        }
+        catch (err) {
+            if (signal.aborted) {
+                return;
+            }
+            const error = err instanceof Error ? err : new Error("Download failed");
+            // Handle URL expiry with retry
+            if ((error.message.includes("expired") || error.message.includes("403")) &&
+                retryCount < maxRetries) {
+                setRetryCount((prev) => prev + 1);
+                // Call proceedWithDownload via ref to bypass the large file dialog check
+                // and avoid stale closure issues
+                const retryTimeoutId = setTimeout(() => {
+                    var _a;
+                    timeoutRefs.current.delete(retryTimeoutId);
+                    (_a = proceedWithDownloadRef.current) === null || _a === void 0 ? void 0 : _a.call(proceedWithDownloadRef);
+                }, 500);
+                timeoutRefs.current.add(retryTimeoutId);
+                return;
+            }
+            // Map error to user-friendly message
+            const errorMessage = mapDownloadErrorMessage(error);
+            setError(errorMessage);
+            onError === null || onError === void 0 ? void 0 : onError(new Error(errorMessage));
+            // Reset error state after 5 seconds
+            const errorTimeoutId = setTimeout(() => {
+                timeoutRefs.current.delete(errorTimeoutId);
+                setError(null);
+                setRetryCount(0);
+                setDownloadProgress(0);
+            }, 5000);
+            timeoutRefs.current.add(errorTimeoutId);
+        }
+        finally {
+            setIsDownloading(false);
+        }
+    }, [
+        file.id,
+        file.key,
+        file.originalName,
+        file.size,
+        generateDownloadUrl,
+        logDownload,
+        maxRetries,
+        onDownloaded,
+        onError,
+        onProgress,
+        progressTrackingMaxSize,
+        progressTrackingMinSize,
+        retryCount,
+        showProgress,
+    ]);
+    // Keep ref updated with latest proceedWithDownload for retry calls
+    useEffect(() => {
+        proceedWithDownloadRef.current = proceedWithDownload;
+    }, [proceedWithDownload]);
+    const handleDownload = useCallback(async () => {
+        if (!canDownload || disabled) {
+            return;
+        }
+        // Warn for very large files
+        if (file.size > largeFileWarningThreshold) {
+            setShowLargeFileDialog(true);
+            return;
+        }
+        await proceedWithDownload();
+    }, [canDownload, disabled, file.size, largeFileWarningThreshold, proceedWithDownload]);
+    const cancelDownload = useCallback(() => {
+        if (abortControllerRef.current) {
+            abortControllerRef.current.abort();
+            abortControllerRef.current = null;
+        }
+        timeoutRefs.current.forEach((timeoutId) => clearTimeout(timeoutId));
+        timeoutRefs.current.clear();
+        setIsDownloading(false);
+        setDownloadProgress(0);
+        setRetryCount(0);
+        setError(null);
+        setSuccess(false);
+        setShowLargeFileDialog(false);
+    }, []);
+    return {
+        isDownloading,
+        error,
+        success,
+        retryCount,
+        downloadProgress,
+        showLargeFileDialog,
+        handleDownload,
+        proceedWithDownload,
+        cancelDownload,
+        setShowLargeFileDialog,
+    };
+}
+//# sourceMappingURL=use-file-download.js.map

package/dist/hooks/use-file-download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-file-download.js","sourceRoot":"","sources":["../../lib/hooks/use-file-download.ts"],"names":[],"mappings":"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"}

package/dist/hooks/use-file-upload.d.ts

@@ -0,0 +1,44 @@
+import type { UploadingFile, UseFileUploadOptions } from "../interfaces/file-upload";
+export declare function useFileUpload({ entity, onSuccess, onError }: UseFileUploadOptions): {
+    uploadingFiles: UploadingFile[];
+    upload: (files: File[]) => Promise<void>;
+    cancel: (id: string) => Promise<void>;
+    retry: (id: string) => Promise<void>;
+    removeFile: (id: string) => void;
+    clearCompleted: () => void;
+    isUploading: boolean;
+    mutations: {
+        getUploadUrl: import("@tanstack/react-query").UseMutationResult<import("../services/file-upload").UploadUrlResponse, Error, {
+            entity: string;
+            fileName: string;
+            fileSize: number;
+            contentType: string;
+        }, unknown>;
+        initiateMultipart: import("@tanstack/react-query").UseMutationResult<import("../services/file-upload").MultipartUploadInitResponse, Error, {
+            entity: string;
+            fileName: string;
+            fileSize: number;
+            contentType: string;
+        }, unknown>;
+        getPartUrl: import("@tanstack/react-query").UseMutationResult<import("../services/file-upload").PartUploadUrlResponse, Error, {
+            key: string;
+            uploadId: string;
+            partNumber: number;
+        }, unknown>;
+        completeMultipart: import("@tanstack/react-query").UseMutationResult<import("../services/file-upload").CompletedUploadResponse, Error, {
+            key: string;
+            uploadId: string;
+            fileSize: number;
+            contentType: string;
+            parts: {
+                partNumber: number;
+                etag: string;
+            }[];
+        }, unknown>;
+        abortMultipart: import("@tanstack/react-query").UseMutationResult<void, Error, {
+            key: string;
+            uploadId: string;
+        }, unknown>;
+    };
+};
+//# sourceMappingURL=use-file-upload.d.ts.map

package/dist/hooks/use-file-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-file-upload.d.ts","sourceRoot":"","sources":["../../lib/hooks/use-file-upload.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAExF,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,oBAAoB;;oBAgMhE,IAAI,EAAE;iBA8BT,MAAM;gBA0BN,MAAM;qBAhPiB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2R3C"}

package/dist/hooks/use-file-upload.js

@@ -0,0 +1,234 @@
+"use client";
+import { useMutation } from "@tanstack/react-query";
+import { useCallback, useRef, useState } from "react";
+import { requestMultipartAbort, requestMultipartComplete, requestMultipartInit, requestPartUploadUrl, requestUploadUrl, uploadPartToPresignedUrl, uploadToPresignedUrl, } from "../api/files/client";
+import { MULTIPART_THRESHOLD } from "../constants/file-upload";
+export function useFileUpload({ entity, onSuccess, onError }) {
+    const [uploadingFiles, setUploadingFiles] = useState([]);
+    const abortControllersRef = useRef(new Map());
+    const updateFile = useCallback((id, updates) => {
+        setUploadingFiles((prev) => prev.map((f) => (f.id === id ? Object.assign(Object.assign({}, f), updates) : f)));
+    }, []);
+    const removeFile = useCallback((id) => {
+        setUploadingFiles((prev) => prev.filter((f) => f.id !== id));
+        abortControllersRef.current.delete(id);
+    }, []);
+    const getUploadUrlMutation = useMutation({
+        mutationFn: requestUploadUrl,
+    });
+    const initiateMultipartMutation = useMutation({
+        mutationFn: requestMultipartInit,
+    });
+    const getPartUrlMutation = useMutation({
+        mutationFn: requestPartUploadUrl,
+    });
+    const completeMultipartMutation = useMutation({
+        mutationFn: requestMultipartComplete,
+    });
+    const abortMultipartMutation = useMutation({
+        mutationFn: requestMultipartAbort,
+    });
+    const uploadSmallFile = useCallback(async (uploadingFile) => {
+        const { id, file } = uploadingFile;
+        const abortController = new AbortController();
+        abortControllersRef.current.set(id, abortController);
+        try {
+            const urlResponse = await getUploadUrlMutation.mutateAsync({
+                entity,
+                fileName: file.name,
+                fileSize: file.size,
+                contentType: file.type || "application/octet-stream",
+            });
+            await uploadToPresignedUrl(urlResponse.url, file, (progress) => {
+                updateFile(id, { progress });
+            }, abortController.signal);
+            const result = {
+                fileId: urlResponse.fileId,
+                bucket: urlResponse.bucket,
+                key: urlResponse.key,
+                etag: "", // Not available for simple PUT
+                size: file.size,
+                contentType: file.type || "application/octet-stream",
+                createdAt: new Date().toISOString(),
+            };
+            updateFile(id, { status: "success", progress: 100, result });
+            onSuccess === null || onSuccess === void 0 ? void 0 : onSuccess(Object.assign(Object.assign({}, uploadingFile), { status: "success", result }), result);
+            return result;
+        }
+        catch (error) {
+            const errorInstance = error instanceof Error ? error : new Error("Upload failed");
+            updateFile(id, { status: "error", error: errorInstance.message });
+            onError === null || onError === void 0 ? void 0 : onError(Object.assign(Object.assign({}, uploadingFile), { status: "error", error: errorInstance.message }), errorInstance);
+            throw error;
+        }
+        finally {
+            abortControllersRef.current.delete(id);
+        }
+    }, [entity, updateFile, onSuccess, onError, getUploadUrlMutation]);
+    const uploadLargeFile = useCallback(async (uploadingFile) => {
+        const { id, file } = uploadingFile;
+        const abortController = new AbortController();
+        abortControllersRef.current.set(id, abortController);
+        // Local variables for cleanup - avoids stale closure issues
+        let uploadId;
+        let key;
+        try {
+            const initResponse = await initiateMultipartMutation.mutateAsync({
+                entity,
+                fileName: file.name,
+                fileSize: file.size,
+                contentType: file.type || "application/octet-stream",
+            });
+            // Store in local variables for reliable cleanup
+            uploadId = initResponse.uploadId;
+            key = initResponse.key;
+            updateFile(id, {
+                uploadId,
+                key,
+            });
+            const { partSize, totalParts } = initResponse;
+            const parts = [];
+            let totalUploaded = 0;
+            for (let partNumber = 1; partNumber <= totalParts; partNumber++) {
+                const start = (partNumber - 1) * partSize;
+                const end = Math.min(start + partSize, file.size);
+                const blob = file.slice(start, end);
+                const partUrlResponse = await getPartUrlMutation.mutateAsync({
+                    key,
+                    uploadId,
+                    partNumber,
+                });
+                const etag = await uploadPartToPresignedUrl(partUrlResponse.url, blob, (loaded) => {
+                    const currentProgress = totalUploaded + loaded;
+                    const progress = Math.round((currentProgress / file.size) * 100);
+                    updateFile(id, { progress });
+                }, abortController.signal);
+                parts.push({ partNumber, etag });
+                totalUploaded += blob.size;
+            }
+            const result = await completeMultipartMutation.mutateAsync({
+                key,
+                uploadId,
+                fileSize: file.size,
+                contentType: file.type || "application/octet-stream",
+                parts,
+            });
+            updateFile(id, { status: "success", progress: 100, result });
+            onSuccess === null || onSuccess === void 0 ? void 0 : onSuccess(Object.assign(Object.assign({}, uploadingFile), { status: "success", result }), result);
+            return result;
+        }
+        catch (error) {
+            const errorInstance = error instanceof Error ? error : new Error("Upload failed");
+            updateFile(id, { status: "error", error: errorInstance.message });
+            onError === null || onError === void 0 ? void 0 : onError(Object.assign(Object.assign({}, uploadingFile), { status: "error", error: errorInstance.message }), errorInstance);
+            // Use local variables for reliable cleanup
+            if (uploadId && key) {
+                try {
+                    await abortMultipartMutation.mutateAsync({
+                        key,
+                        uploadId,
+                    });
+                }
+                catch (_a) {
+                    // Best-effort cleanup - abort failure doesn't affect the main error
+                }
+            }
+            throw error;
+        }
+        finally {
+            abortControllersRef.current.delete(id);
+        }
+    }, [
+        entity,
+        updateFile,
+        onSuccess,
+        onError,
+        initiateMultipartMutation,
+        getPartUrlMutation,
+        completeMultipartMutation,
+        abortMultipartMutation,
+    ]);
+    const upload = useCallback(async (files) => {
+        const newUploadingFiles = files.map((file) => ({
+            id: crypto.randomUUID(),
+            file,
+            progress: 0,
+            status: "pending",
+        }));
+        setUploadingFiles((prev) => [...prev, ...newUploadingFiles]);
+        for (const uploadingFile of newUploadingFiles) {
+            updateFile(uploadingFile.id, { status: "uploading" });
+            const shouldUseMultipart = uploadingFile.file.size > MULTIPART_THRESHOLD;
+            try {
+                if (shouldUseMultipart) {
+                    await uploadLargeFile(uploadingFile);
+                }
+                else {
+                    await uploadSmallFile(uploadingFile);
+                }
+            }
+            catch (_a) {
+                // Error already handled in uploadSmallFile/uploadLargeFile
+            }
+        }
+    }, [updateFile, uploadSmallFile, uploadLargeFile]);
+    const cancel = useCallback(async (id) => {
+        const file = uploadingFiles.find((f) => f.id === id);
+        if (!file)
+            return;
+        const abortController = abortControllersRef.current.get(id);
+        if (abortController) {
+            abortController.abort();
+        }
+        if (file.uploadId && file.key) {
+            try {
+                await abortMultipartMutation.mutateAsync({
+                    key: file.key,
+                    uploadId: file.uploadId,
+                });
+            }
+            catch (_a) {
+                // Best-effort cleanup - file will be removed regardless
+            }
+        }
+        removeFile(id);
+    }, [uploadingFiles, removeFile, abortMultipartMutation]);
+    const retry = useCallback(async (id) => {
+        const file = uploadingFiles.find((f) => f.id === id);
+        if (!file || file.status !== "error")
+            return;
+        updateFile(id, { status: "uploading", progress: 0, error: undefined });
+        const shouldUseMultipart = file.file.size > MULTIPART_THRESHOLD;
+        try {
+            if (shouldUseMultipart) {
+                await uploadLargeFile(file);
+            }
+            else {
+                await uploadSmallFile(file);
+            }
+        }
+        catch (_a) {
+            // Error already handled in uploadSmallFile/uploadLargeFile
+        }
+    }, [uploadingFiles, updateFile, uploadSmallFile, uploadLargeFile]);
+    const clearCompleted = useCallback(() => {
+        setUploadingFiles((prev) => prev.filter((f) => f.status === "pending" || f.status === "uploading"));
+    }, []);
+    return {
+        uploadingFiles,
+        upload,
+        cancel,
+        retry,
+        removeFile,
+        clearCompleted,
+        isUploading: uploadingFiles.some((f) => f.status === "uploading"),
+        mutations: {
+            getUploadUrl: getUploadUrlMutation,
+            initiateMultipart: initiateMultipartMutation,
+            getPartUrl: getPartUrlMutation,
+            completeMultipart: completeMultipartMutation,
+            abortMultipart: abortMultipartMutation,
+        },
+    };
+}
+//# sourceMappingURL=use-file-upload.js.map

package/dist/hooks/use-file-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-file-upload.js","sourceRoot":"","sources":["../../lib/hooks/use-file-upload.ts"],"names":[],"mappings":"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"}

package/dist/hooks/use-folder-navigation.d.ts

@@ -0,0 +1,40 @@
+import { FolderInfo } from "../interfaces";
+export interface UseFolderNavigationOptions {
+    /** Initial selected folder */
+    initialFolder?: FolderInfo | null;
+    /** Initial expanded folders */
+    initialExpanded?: Set<string>;
+    /** Enable sessionStorage persistence (default: false) */
+    persistState?: boolean;
+    /** Custom storage key prefix for multiple instances */
+    storageKeyPrefix?: string;
+}
+export interface UseFolderNavigationReturn {
+    /** Currently selected folder */
+    selectedFolder: FolderInfo | null;
+    /** Set of expanded folder paths */
+    expandedFolders: Set<string>;
+    /** Whether the state has been hydrated from storage (always true if persistState is false) */
+    isHydrated: boolean;
+    /** Select a folder (updates selection only) */
+    selectFolder: (folder: FolderInfo | null) => void;
+    /** Toggle folder expansion */
+    toggleFolder: (path: string) => void;
+    /** Navigate to a folder (select + expand parent folders) */
+    navigateToFolder: (folder: FolderInfo | null) => void;
+    /** Check if a folder is expanded */
+    isFolderExpanded: (path: string) => boolean;
+    /** Expand a folder */
+    expandFolder: (path: string) => void;
+    /** Collapse a folder */
+    collapseFolder: (path: string) => void;
+    /** Reset navigation state (also clears persisted state if persistState is enabled) */
+    reset: () => void;
+}
+/**
+ * Hook for managing folder navigation state.
+ * Handles folder selection, expansion, and navigation with parent folder expansion.
+ * Optionally persists state to sessionStorage to survive page refreshes.
+ */
+export declare function useFolderNavigation(options?: UseFolderNavigationOptions): UseFolderNavigationReturn;
+//# sourceMappingURL=use-folder-navigation.d.ts.map

package/dist/hooks/use-folder-navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-folder-navigation.d.ts","sourceRoot":"","sources":["../../lib/hooks/use-folder-navigation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAW9C,MAAM,WAAW,0BAA0B;IACzC,8BAA8B;IAC9B,aAAa,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,+BAA+B;IAC/B,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,gCAAgC;IAChC,cAAc,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,mCAAmC;IACnC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,8FAA8F;IAC9F,UAAU,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,YAAY,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD,8BAA8B;IAC9B,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,4DAA4D;IAC5D,gBAAgB,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IACtD,oCAAoC;IACpC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,sBAAsB;IACtB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,wBAAwB;IACxB,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,sFAAsF;IACtF,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CA0I3B"}