captify 0.1.15

package/dist/files/files.utilities.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Builds the tenant-scoped S3 prefix for a given tenant and optional path.
+ */
+export declare function buildTenantPrefix(tenantId: string, prefix?: string): string;
+/**
+ * Gets the tenant prefix for a given tenant ID.
+ */
+export declare function getTenantPrefix(tenantId: string): string;
+/**
+ * Extracts the folder name from an S3 common prefix.
+ */
+export declare function extractFolderName(commonPrefix: string, fullPrefix: string): string;
+/**
+ * Transforms an S3 object key to be relative to the tenant prefix.
+ */
+export declare function toRelativeKey(key: string, tenantPrefix: string): string;
+/**
+ * Validates and normalizes an S3 key to prevent path traversal attacks.
+ */
+export declare function validateAndNormalizeKey(key: string, tenantId: string): string;
+/**
+ * Sanitizes a filename for use in Content-Disposition header.
+ */
+export declare function sanitizeFilename(filename: string, maxLength?: number): string;
+/**
+ * Extracts filename from an S3 key.
+ */
+export declare function extractFilename(key: string): string;
+/**
+ * Builds a Set of all path segments from a full path.
+ */
+export declare function buildPathHierarchy(path: string): Set<string>;
+/**
+ * Generate a tenant-aware S3 key for file uploads using the template system
+ */
+export declare function generateS3Key(tenantId: string, entity: string, fileName: string, fileId: string, includeDatePath?: boolean, userId?: string): string;
+/**
+ * Generate an S3 key for bucket-aware uploads (without tenant prefix)
+ */
+export declare function generateBucketKey(prefix: string | undefined, fileName: string, fileId: string): string;
+/**
+ * Sanitize file name for safe S3 key usage
+ */
+export declare function sanitizeFileName(fileName: string): string;
+/**
+ * Sanitize user ID for safe S3 key usage
+ */
+export declare function sanitizeUserId(userId: string): string;
+/**
+ * Get file extension from file name
+ */
+export declare function getFileExtension(fileName: string): string;
+/**
+ * Get MIME type from file extension
+ */
+export declare function getMimeType(fileName: string): string;
+/**
+ * Calculate number of parts needed for multipart upload
+ */
+export declare function calculateParts(fileSize: number, partSize?: number): number;
+/**
+ * Determine if file should use multipart upload
+ */
+export declare function shouldUseMultipart(fileSize: number): boolean;
+//# sourceMappingURL=files.utilities.d.ts.map

package/dist/files/files.utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.utilities.d.ts","sourceRoot":"","sources":["../../lib/files/files.utilities.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAS3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGlF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEvE;AAwDD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0B7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAkClF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAc5D;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,eAAe,GAAE,OAAc,EAC/B,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CA8BR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAazD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAEzF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/files/files.utilities.js

@@ -0,0 +1,258 @@
+import { buildS3KeyFromTemplate, EXTENSION_TO_MIME, generateS3KeyFromTemplate, getS3KeyTemplate, MIN_PART_SIZE, MULTIPART_THRESHOLD, S3_KEY_TEMPLATE, TENANT_PREFIX_TEMPLATE, USER_S3_KEY_TEMPLATE, } from "./files.constants";
+import { FileListCrossTenantError, FileListPathTraversalError, FileListValidationError, } from "./files.errors";
+// ============================================================================
+// File List Service Utilities
+// ============================================================================
+/**
+ * Builds the tenant-scoped S3 prefix for a given tenant and optional path.
+ */
+export function buildTenantPrefix(tenantId, prefix) {
+    const tenantPrefix = TENANT_PREFIX_TEMPLATE.replace("{tenantId}", tenantId);
+    if (!prefix) {
+        return tenantPrefix;
+    }
+    const normalizedPrefix = prefix.endsWith("/") ? prefix : `${prefix}/`;
+    return `${tenantPrefix}${normalizedPrefix}`;
+}
+/**
+ * Gets the tenant prefix for a given tenant ID.
+ */
+export function getTenantPrefix(tenantId) {
+    return TENANT_PREFIX_TEMPLATE.replace("{tenantId}", tenantId);
+}
+/**
+ * Extracts the folder name from an S3 common prefix.
+ */
+export function extractFolderName(commonPrefix, fullPrefix) {
+    const relativePath = commonPrefix.substring(fullPrefix.length).replace(/\/$/, "");
+    return relativePath.split("/")[0];
+}
+/**
+ * Transforms an S3 object key to be relative to the tenant prefix.
+ */
+export function toRelativeKey(key, tenantPrefix) {
+    return key.substring(tenantPrefix.length);
+}
+/**
+ * Dangerous path patterns that indicate path traversal attempts
+ */
+const DANGEROUS_PATTERNS = [
+    /\.\.\//, // ../
+    /\.\.\\/, // ..\
+    /(^|[\\/])\.\.($|[\\/])/, // standalone .. segment
+    /\.\//, // ./
+    /\.\\/, // .\
+    /^\/+/, // Leading slashes
+    /\/\/+/, // Multiple consecutive slashes
+];
+/**
+ * Normalizes a string by converting Unicode to NFKC form.
+ */
+function normalizeUnicode(str) {
+    return str.normalize("NFKC");
+}
+/**
+ * Decodes a URL-encoded key safely.
+ */
+function decodeKey(key) {
+    try {
+        return decodeURIComponent(key);
+    }
+    catch (_a) {
+        throw new FileListValidationError("Invalid file path - malformed encoding");
+    }
+}
+/**
+ * Checks if a path contains dangerous traversal patterns
+ */
+function containsDangerousPatterns(path) {
+    if (path.includes("\0")) {
+        return true;
+    }
+    return DANGEROUS_PATTERNS.some((pattern) => pattern.test(path));
+}
+/**
+ * Normalizes a path by removing empty segments and single dots
+ */
+function normalizePath(path) {
+    const segments = path.split("/").filter((segment) => segment !== "" && segment !== ".");
+    if (segments.some((segment) => segment === "..")) {
+        throw new FileListPathTraversalError();
+    }
+    return segments.join("/");
+}
+/**
+ * Validates and normalizes an S3 key to prevent path traversal attacks.
+ */
+export function validateAndNormalizeKey(key, tenantId) {
+    if (!key || key.trim() === "") {
+        throw new FileListValidationError("File key is required");
+    }
+    const decodedKey = decodeKey(key);
+    const normalizedKey = normalizeUnicode(decodedKey);
+    if (containsDangerousPatterns(normalizedKey)) {
+        throw new FileListPathTraversalError();
+    }
+    const cleanKey = normalizePath(normalizedKey);
+    if (cleanKey === "") {
+        throw new FileListValidationError("File key cannot be empty after normalization");
+    }
+    const tenantPrefix = getTenantPrefix(tenantId);
+    const fullKey = `${tenantPrefix}${cleanKey}`;
+    if (!fullKey.startsWith(tenantPrefix)) {
+        throw new FileListCrossTenantError();
+    }
+    return fullKey;
+}
+/**
+ * Sanitizes a filename for use in Content-Disposition header.
+ */
+export function sanitizeFilename(filename, maxLength = 255) {
+    if (!filename) {
+        return "download";
+    }
+    let sanitized = filename.replace(/^.*[\\/]/, "");
+    sanitized = Array.from(sanitized)
+        .filter((char) => {
+        const code = char.charCodeAt(0);
+        return code >= 32 && code !== 127;
+    })
+        .join("");
+    sanitized = sanitized.replace(/[<>:"|?*]/g, "");
+    sanitized = sanitized.trim();
+    sanitized = sanitized.replace(/^\.+/, "").replace(/\.{2,}/g, ".");
+    if (!sanitized) {
+        return "download";
+    }
+    if (sanitized.length > maxLength) {
+        const lastDot = sanitized.lastIndexOf(".");
+        if (lastDot > 0 && sanitized.length - lastDot <= 10) {
+            const ext = sanitized.substring(lastDot);
+            const name = sanitized.substring(0, maxLength - ext.length);
+            sanitized = name + ext;
+        }
+        else {
+            sanitized = sanitized.substring(0, maxLength);
+        }
+    }
+    return sanitized;
+}
+/**
+ * Extracts filename from an S3 key.
+ */
+export function extractFilename(key) {
+    const segments = key.split("/").filter((s) => s !== "");
+    if (segments.length > 0) {
+        return segments[segments.length - 1];
+    }
+    const extensionMatch = key.match(/\.([a-zA-Z0-9]+)$/);
+    if (extensionMatch) {
+        return `download.${extensionMatch[1]}`;
+    }
+    return "download";
+}
+/**
+ * Builds a Set of all path segments from a full path.
+ */
+export function buildPathHierarchy(path) {
+    const normalizedPath = normalizeUnicode(path);
+    if (containsDangerousPatterns(normalizedPath)) {
+        throw new FileListPathTraversalError();
+    }
+    const parts = path.split("/").filter((part) => part !== "");
+    const paths = new Set();
+    let currentPath = "";
+    for (const part of parts) {
+        currentPath = currentPath ? `${currentPath}/${part}` : part;
+        paths.add(currentPath);
+    }
+    return paths;
+}
+// ============================================================================
+// File Upload Service Utilities
+// ============================================================================
+/**
+ * Generate a tenant-aware S3 key for file uploads using the template system
+ */
+export function generateS3Key(tenantId, entity, fileName, fileId, includeDatePath = true, userId) {
+    const safeFileName = sanitizeFileName(fileName);
+    const context = Object.assign({ tenantId,
+        entity,
+        fileId, fileName: safeFileName }, (userId ? { userId: sanitizeUserId(userId) } : {}));
+    const templateConfig = getS3KeyTemplate(entity);
+    if (!includeDatePath && templateConfig.includeDatePartition) {
+        const templateRequiresUserId = templateConfig.template.includes("{userId}");
+        if (templateRequiresUserId && !context.userId) {
+            throw new Error(`Entity '${entity}' requires userId but none was provided. ` +
+                `Either provide userId or use an entity that doesn't require user-specific paths.`);
+        }
+        const simpleTemplate = templateRequiresUserId || context.userId ? USER_S3_KEY_TEMPLATE : S3_KEY_TEMPLATE;
+        return buildS3KeyFromTemplate(simpleTemplate, context);
+    }
+    return generateS3KeyFromTemplate(context);
+}
+/**
+ * Generate an S3 key for bucket-aware uploads (without tenant prefix)
+ */
+export function generateBucketKey(prefix, fileName, fileId) {
+    const safeFileName = sanitizeFileName(fileName);
+    const normalizedPrefix = prefix === null || prefix === void 0 ? void 0 : prefix.replace(/\/$/, "");
+    if (normalizedPrefix) {
+        return `${normalizedPrefix}/${fileId}-${safeFileName}`;
+    }
+    return `${fileId}-${safeFileName}`;
+}
+/**
+ * Sanitize file name for safe S3 key usage
+ */
+export function sanitizeFileName(fileName) {
+    const lastDot = fileName.lastIndexOf(".");
+    const name = lastDot > 0 ? fileName.substring(0, lastDot) : fileName;
+    const ext = lastDot > 0 ? fileName.substring(lastDot + 1).toLowerCase() : "";
+    const safeName = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "")
+        .substring(0, 100);
+    return ext ? `${safeName}.${ext}` : safeName;
+}
+/**
+ * Sanitize user ID for safe S3 key usage
+ */
+export function sanitizeUserId(userId) {
+    return userId
+        .replace(/[^a-zA-Z0-9_-]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "")
+        .substring(0, 128);
+}
+/**
+ * Get file extension from file name
+ */
+export function getFileExtension(fileName) {
+    const lastDot = fileName.lastIndexOf(".");
+    if (lastDot <= 0)
+        return "";
+    return fileName.substring(lastDot + 1).toLowerCase();
+}
+/**
+ * Get MIME type from file extension
+ */
+export function getMimeType(fileName) {
+    const ext = getFileExtension(fileName);
+    return EXTENSION_TO_MIME[ext] || "application/octet-stream";
+}
+/**
+ * Calculate number of parts needed for multipart upload
+ */
+export function calculateParts(fileSize, partSize = MIN_PART_SIZE) {
+    return Math.ceil(fileSize / partSize);
+}
+/**
+ * Determine if file should use multipart upload
+ */
+export function shouldUseMultipart(fileSize) {
+    return fileSize > MULTIPART_THRESHOLD;
+}
+//# sourceMappingURL=files.utilities.js.map

package/dist/files/files.utilities.js.map

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

package/dist/files/hooks/index.d.ts

@@ -0,0 +1,9 @@
+export { useBucketActions } from "./use-bucket-actions";
+export type { UseBucketActionsOptions, UseBucketActionsReturn, } from "./use-bucket-actions";
+export { useBucketQueries } from "./use-bucket-queries";
+export type { UseBucketQueriesOptions, UseBucketQueriesReturn, } from "./use-bucket-queries";
+export { useFileDownload } from "./use-file-download";
+export { useFileUpload } from "./use-file-upload";
+export { useSubfolderQueries } from "./use-subfolder-queries";
+export type { SubfolderData, UseSubfolderQueriesOptions, UseSubfolderQueriesReturn, } from "./use-subfolder-queries";
+//# sourceMappingURL=index.d.ts.map

package/dist/files/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/files/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,YAAY,EACV,aAAa,EACb,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,yCAAyC,CAAC"}

package/dist/files/hooks/index.js

@@ -0,0 +1,6 @@
+export { useBucketActions } from "./use-bucket-actions";
+export { useBucketQueries } from "./use-bucket-queries";
+export { useFileDownload } from "./use-file-download";
+export { useFileUpload } from "./use-file-upload";
+export { useSubfolderQueries } from "./use-subfolder-queries";
+//# sourceMappingURL=index.js.map

package/dist/files/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/files/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAKxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAKxE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/files/hooks/use-bucket-actions.d.ts

@@ -0,0 +1,27 @@
+import { FolderInfo } from "../../shared/shared.interfaces";
+import { BucketInfo } from "../files.interfaces";
+export interface UseBucketActionsOptions {
+    /** Currently selected bucket */
+    selectedBucket: BucketInfo | null;
+    /** Currently selected folder within the bucket */
+    selectedFolder: FolderInfo | null;
+    /** Callback to reset pagination state */
+    resetPagination: () => void;
+}
+export interface UseBucketActionsReturn {
+    /** Generate a download URL for a file in the selected bucket */
+    generateDownloadUrl: (fileId: string, key: string) => Promise<{
+        success: boolean;
+        url: string;
+    }>;
+    /** Refresh the current view */
+    handleRefresh: () => void;
+    /** Refresh buckets list */
+    handleRefreshBuckets: () => void;
+}
+/**
+ * Hook for managing all action handlers for bucket-based document browsing.
+ * Handles download URL generation and refresh operations.
+ */
+export declare function useBucketActions({ selectedBucket, selectedFolder, resetPagination, }: UseBucketActionsOptions): UseBucketActionsReturn;
+//# sourceMappingURL=use-bucket-actions.d.ts.map

package/dist/files/hooks/use-bucket-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-bucket-actions.d.ts","sourceRoot":"","sources":["../../../lib/files/hooks/use-bucket-actions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI1D,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,cAAc,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,kDAAkD;IAClD,cAAc,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,yCAAyC;IACzC,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjG,+BAA+B;IAC/B,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,2BAA2B;IAC3B,oBAAoB,EAAE,MAAM,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,cAAc,EACd,cAAc,EACd,eAAe,GAChB,EAAE,uBAAuB,GAAG,sBAAsB,CA4DlD"}

package/dist/files/hooks/use-bucket-actions.js

@@ -0,0 +1,62 @@
+"use client";
+import { requestDownloadUrl } from "../api/files.client";
+import { DOCUMENTS_QUERY_KEY_PREFIX } from "../files.constants";
+import { useQueryClient } from "@tanstack/react-query";
+import { useCallback } from "react";
+/**
+ * Hook for managing all action handlers for bucket-based document browsing.
+ * Handles download URL generation and refresh operations.
+ */
+export function useBucketActions({ selectedBucket, selectedFolder, resetPagination, }) {
+    const queryClient = useQueryClient();
+    const generateDownloadUrl = useCallback(async (_fileId, key) => {
+        var _a;
+        if (!selectedBucket) {
+            return { success: false, url: "" };
+        }
+        // Reconstruct the full S3 key by prepending the folder path if we're inside a folder
+        // The key passed here is relative (prefix stripped by transformBucketObjects)
+        // The prefix used when listing includes a trailing slash, so we need to add it here too
+        const fullKey = (selectedFolder === null || selectedFolder === void 0 ? void 0 : selectedFolder.path)
+            ? `${selectedFolder.path}${selectedFolder.path.endsWith("/") ? "" : "/"}${key}`
+            : key;
+        const fileName = key.split("/").pop() || key;
+        const result = await requestDownloadUrl({
+            bucketName: selectedBucket.name,
+            key: fullKey,
+            fileName,
+        });
+        return { success: !!result.url, url: (_a = result.url) !== null && _a !== void 0 ? _a : "" };
+    }, [selectedBucket, selectedFolder]);
+    const handleRefresh = useCallback(() => {
+        var _a;
+        resetPagination();
+        if (!selectedBucket)
+            return;
+        // Invalidate the current content view (use partial match to cover all pagination states)
+        queryClient.invalidateQueries({
+            queryKey: [
+                DOCUMENTS_QUERY_KEY_PREFIX,
+                "content",
+                selectedBucket.name,
+                (_a = selectedFolder === null || selectedFolder === void 0 ? void 0 : selectedFolder.path) !== null && _a !== void 0 ? _a : "root",
+            ],
+            exact: false,
+        });
+        // Also invalidate root folders for the bucket
+        queryClient.invalidateQueries({
+            queryKey: [DOCUMENTS_QUERY_KEY_PREFIX, "root-folders", selectedBucket.name],
+        });
+    }, [queryClient, resetPagination, selectedBucket, selectedFolder]);
+    const handleRefreshBuckets = useCallback(() => {
+        queryClient.invalidateQueries({
+            queryKey: [DOCUMENTS_QUERY_KEY_PREFIX, "buckets"],
+        });
+    }, [queryClient]);
+    return {
+        generateDownloadUrl,
+        handleRefresh,
+        handleRefreshBuckets,
+    };
+}
+//# sourceMappingURL=use-bucket-actions.js.map

package/dist/files/hooks/use-bucket-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-bucket-actions.js","sourceRoot":"","sources":["../../../lib/files/hooks/use-bucket-actions.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAGzE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAoBpC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,cAAc,EACd,cAAc,EACd,eAAe,GACS;IACxB,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,mBAAmB,GAAG,WAAW,CACrC,KAAK,EAAE,OAAe,EAAE,GAAW,EAAE,EAAE;;QACrC,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;QACrC,CAAC;QAED,qFAAqF;QACrF,8EAA8E;QAC9E,wFAAwF;QACxF,MAAM,OAAO,GAAG,CAAA,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,IAAI;YAClC,CAAC,CAAC,GAAG,cAAc,CAAC,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE;YAC/E,CAAC,CAAC,GAAG,CAAC;QAER,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;YACtC,UAAU,EAAE,cAAc,CAAC,IAAI;YAC/B,GAAG,EAAE,OAAO;YACZ,QAAQ;SACT,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,MAAA,MAAM,CAAC,GAAG,mCAAI,EAAE,EAAE,CAAC;IAC1D,CAAC,EACD,CAAC,cAAc,EAAE,cAAc,CAAC,CACjC,CAAC;IAEF,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;;QACrC,eAAe,EAAE,CAAC;QAElB,IAAI,CAAC,cAAc;YAAE,OAAO;QAE5B,yFAAyF;QACzF,WAAW,CAAC,iBAAiB,CAAC;YAC5B,QAAQ,EAAE;gBACR,0BAA0B;gBAC1B,SAAS;gBACT,cAAc,CAAC,IAAI;gBACnB,MAAA,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,IAAI,mCAAI,MAAM;aAC/B;YACD,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QAEH,8CAA8C;QAC9C,WAAW,CAAC,iBAAiB,CAAC;YAC5B,QAAQ,EAAE,CAAC,0BAA0B,EAAE,cAAc,EAAE,cAAc,CAAC,IAAI,CAAC;SAC5E,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC;IAEnE,MAAM,oBAAoB,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5C,WAAW,CAAC,iBAAiB,CAAC;YAC5B,QAAQ,EAAE,CAAC,0BAA0B,EAAE,SAAS,CAAC;SAClD,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAElB,OAAO;QACL,mBAAmB;QACnB,aAAa;QACb,oBAAoB;KACrB,CAAC;AACJ,CAAC"}

package/dist/files/hooks/use-bucket-queries.d.ts

@@ -0,0 +1,68 @@
+import { ListBucketsResponse, ListFilesResponse } from "../api/files.client";
+import { SubfolderCache } from "../components";
+import { FolderInfo } from "../../shared/shared.interfaces";
+import { BucketInfo } from "../files.interfaces";
+import { UseQueryResult } from "@tanstack/react-query";
+export interface UseBucketQueriesOptions {
+    /** Currently selected bucket (null if none selected) */
+    selectedBucket: BucketInfo | null;
+    /** Currently selected folder within the bucket */
+    selectedFolder: FolderInfo | null;
+    /** Set of expanded folder paths for lazy loading */
+    expandedFolders: Set<string>;
+    /** Path currently being navigated to (used to prevent duplicate API calls) */
+    navigatingToPath?: string | null;
+    /** Paths to skip when fetching subfolders (provided by context) */
+    skipPaths?: Set<string>;
+    /** Cached subfolder data from context (for hydration) */
+    subfolderCache?: SubfolderCache;
+    /** Callback to update subfolder cache in context */
+    updateSubfolderCache?: (path: string, folders: string[]) => void;
+    /** Number of items per page */
+    pageSize: number;
+    /** Current page number */
+    currentPage: number;
+    /** Continuation token for pagination */
+    currentToken: string | undefined;
+    /** Callback to store next pagination token */
+    storeNextToken: (token: string) => void;
+    /** Callback to clear pagination token */
+    clearNextToken: () => void;
+}
+export interface UseBucketQueriesReturn {
+    /** Query for listing all accessible buckets */
+    bucketsQuery: UseQueryResult<ListBucketsResponse, Error>;
+    /** Query for listing root folders in selected bucket */
+    rootFoldersQuery: UseQueryResult<ListFilesResponse, Error>;
+    /** Query for listing content of selected folder */
+    contentQuery: UseQueryResult<ListFilesResponse, Error>;
+    /** Function to get subfolders for a path */
+    getSubfolders: (path: string) => {
+        folders: string[];
+        isLoading: boolean;
+    };
+    /** List of available buckets */
+    buckets: BucketInfo[];
+    /** List of root folders in selected bucket */
+    rootFolders: string[];
+    /** List of folders to display in content area */
+    foldersToDisplay: string[];
+    /** List of files to display in content area */
+    filesToDisplay: any[];
+    /** Whether there are more pages */
+    hasNextPage: boolean;
+    /** Whether content is loading */
+    isLoading: boolean;
+    /** Whether any query is fetching */
+    isFetching: boolean;
+    /** Whether buckets are loading */
+    isBucketsLoading: boolean;
+    /** Whether root folders are loading (uses contentQuery at root level) */
+    isRootFoldersLoading: boolean;
+}
+/**
+ * Hook for managing all React Query logic for bucket-based document browsing.
+ * Supports listing buckets, browsing files within buckets, and pagination.
+ */
+export declare function useBucketQueries({ selectedBucket, selectedFolder, expandedFolders, navigatingToPath, skipPaths: externalSkipPaths, subfolderCache, updateSubfolderCache, pageSize, currentPage, currentToken, storeNextToken, clearNextToken, }: UseBucketQueriesOptions): UseBucketQueriesReturn;
+//# sourceMappingURL=use-bucket-queries.d.ts.map

package/dist/files/hooks/use-bucket-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-bucket-queries.d.ts","sourceRoot":"","sources":["../../../lib/files/hooks/use-bucket-queries.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EAGlB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAqB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAA4B,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGjF,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,cAAc,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,kDAAkD;IAClD,cAAc,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,oDAAoD;IACpD,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mEAAmE;IACnE,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,yDAAyD;IACzD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,oDAAoD;IACpD,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACjE,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,8CAA8C;IAC9C,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,yCAAyC;IACzC,cAAc,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,YAAY,EAAE,cAAc,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IACzD,wDAAwD;IACxD,gBAAgB,EAAE,cAAc,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAC3D,mDAAmD;IACnD,YAAY,EAAE,cAAc,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IACvD,4CAA4C;IAC5C,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3E,gCAAgC;IAChC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,+CAA+C;IAC/C,cAAc,EAAE,GAAG,EAAE,CAAC;IACtB,mCAAmC;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,UAAU,EAAE,OAAO,CAAC;IACpB,kCAAkC;IAClC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,cAAc,EACd,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,SAAS,EAAE,iBAAiB,EAC5B,cAAc,EACd,oBAAoB,EACpB,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,GACf,EAAE,uBAAuB,GAAG,sBAAsB,CA6PlD"}