@m5kdev/frontend 0.8.6 → 0.8.8

package/dist/src/modules/file/hooks/useS3Upload.js

@@ -0,0 +1,80 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+//#region src/modules/file/hooks/useS3Upload.ts
+async function getPresignedUrl(filename, filetype, serverUrl = "") {
+	const res = await fetch(`${serverUrl}/upload/s3-presigned-url`, {
+		method: "POST",
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify({
+			filename,
+			filetype
+		})
+	});
+	if (!res.ok) throw new Error("Failed to get presigned URL");
+	return (await res.json()).url;
+}
+function useS3Upload(serverUrl = "") {
+	const [progress, setProgress] = (0, react.useState)(0);
+	const [status, setStatus] = (0, react.useState)("idle");
+	const [error, setError] = (0, react.useState)(null);
+	const [uploadedUrl, setUploadedUrl] = (0, react.useState)(null);
+	return {
+		upload: (0, react.useCallback)(async (file, prefix) => {
+			setProgress(0);
+			setStatus("uploading");
+			setError(null);
+			setUploadedUrl(null);
+			try {
+				const extension = (file instanceof File ? file.name : `upload-${Date.now()}`).split(".").pop() || "";
+				const uuid = crypto.randomUUID();
+				const filename = prefix ? `${prefix}/${uuid}.${extension}` : `${uuid}.${extension}`;
+				const filetype = file instanceof File ? file.type : "application/octet-stream";
+				const presignedUrl = await getPresignedUrl(filename, filetype, serverUrl);
+				return await new Promise((resolve, reject) => {
+					const xhr = new XMLHttpRequest();
+					xhr.open("PUT", presignedUrl);
+					xhr.setRequestHeader("Content-Type", filetype);
+					xhr.upload.onprogress = (event) => {
+						if (event.lengthComputable) setProgress(Math.round(event.loaded * 100 / event.total));
+					};
+					xhr.onload = () => {
+						if (xhr.status >= 200 && xhr.status < 300) {
+							setProgress(100);
+							setStatus("success");
+							setUploadedUrl(presignedUrl.split("?")[0]);
+							resolve(filename);
+						} else {
+							setStatus("error");
+							setError(`Upload failed with status ${xhr.status}`);
+							reject(/* @__PURE__ */ new Error(`Upload failed with status ${xhr.status}`));
+						}
+					};
+					xhr.onerror = () => {
+						setStatus("error");
+						setError("Network error during upload");
+						reject(/* @__PURE__ */ new Error("Network error during upload"));
+					};
+					xhr.send(file);
+				});
+			} catch (err) {
+				setStatus("error");
+				setError(err?.message || "Unknown error");
+				return Promise.reject(err);
+			}
+		}, [serverUrl]),
+		progress,
+		status,
+		error,
+		uploadedUrl,
+		reset: (0, react.useCallback)(() => {
+			setProgress(0);
+			setStatus("idle");
+			setError(null);
+			setUploadedUrl(null);
+		}, [])
+	};
+}
+//#endregion
+exports.useS3Upload = useS3Upload;
+
+//# sourceMappingURL=useS3Upload.js.map

package/dist/src/modules/file/hooks/useS3Upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useS3Upload.js","names":[],"sources":["../../../../../src/modules/file/hooks/useS3Upload.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\r\n\r\nexport type S3UploadStatus = \"idle\" | \"uploading\" | \"success\" | \"error\";\r\n\r\nasync function getPresignedUrl(\r\n  filename: string,\r\n  filetype: string,\r\n  serverUrl = \"\"\r\n): Promise<string> {\r\n  const res = await fetch(`${serverUrl}/upload/s3-presigned-url`, {\r\n    method: \"POST\",\r\n    headers: { \"Content-Type\": \"application/json\" },\r\n    body: JSON.stringify({ filename, filetype }),\r\n  });\r\n  if (!res.ok) throw new Error(\"Failed to get presigned URL\");\r\n  const data = (await res.json()) as { url: string };\r\n  return data.url;\r\n}\r\n\r\nexport function useS3Upload(serverUrl = \"\") {\r\n  const [progress, setProgress] = useState<number>(0);\r\n  const [status, setStatus] = useState<S3UploadStatus>(\"idle\");\r\n  const [error, setError] = useState<string | null>(null);\r\n  const [uploadedUrl, setUploadedUrl] = useState<string | null>(null);\r\n\r\n  const upload = useCallback(async (file: File | Blob, prefix?: string) => {\r\n    setProgress(0);\r\n    setStatus(\"uploading\");\r\n    setError(null);\r\n    setUploadedUrl(null);\r\n    try {\r\n      const originalFilename = file instanceof File ? file.name : `upload-${Date.now()}`;\r\n      const extension = originalFilename.split(\".\").pop() || \"\";\r\n      const uuid = crypto.randomUUID();\r\n      const filename = prefix\r\n        ? `${prefix}/${uuid}.${extension}`\r\n        : `${uuid}.${extension}`;\r\n      const filetype = file instanceof File ? file.type : \"application/octet-stream\";\r\n      const presignedUrl = await getPresignedUrl(filename, filetype, serverUrl);\r\n\r\n      return await new Promise<string>((resolve, reject) => {\r\n        const xhr = new XMLHttpRequest();\r\n        xhr.open(\"PUT\", presignedUrl);\r\n        xhr.setRequestHeader(\"Content-Type\", filetype);\r\n\r\n        xhr.upload.onprogress = (event) => {\r\n          if (event.lengthComputable) {\r\n            setProgress(Math.round((event.loaded * 100) / event.total));\r\n          }\r\n        };\r\n\r\n        xhr.onload = () => {\r\n          if (xhr.status >= 200 && xhr.status < 300) {\r\n            setProgress(100);\r\n            setStatus(\"success\");\r\n            // Remove query params to get the public URL\r\n            setUploadedUrl(presignedUrl.split(\"?\")[0]);\r\n            resolve(filename);\r\n          } else {\r\n            setStatus(\"error\");\r\n            setError(`Upload failed with status ${xhr.status}`);\r\n            reject(new Error(`Upload failed with status ${xhr.status}`));\r\n          }\r\n        };\r\n\r\n        xhr.onerror = () => {\r\n          setStatus(\"error\");\r\n          setError(\"Network error during upload\");\r\n          reject(new Error(\"Network error during upload\"));\r\n        };\r\n\r\n        xhr.send(file);\r\n      });\r\n    } catch (err: any) {\r\n      setStatus(\"error\");\r\n      setError(err?.message || \"Unknown error\");\r\n      return Promise.reject(err);\r\n    }\r\n  }, [serverUrl]);\r\n\r\n  const reset = useCallback(() => {\r\n    setProgress(0);\r\n    setStatus(\"idle\");\r\n    setError(null);\r\n    setUploadedUrl(null);\r\n  }, []);\r\n\r\n  return { upload, progress, status, error, uploadedUrl, reset };\r\n}\r\n"],"mappings":";;;AAIA,eAAe,gBACb,UACA,UACA,YAAY,IACK;CACjB,MAAM,MAAM,MAAM,MAAM,GAAG,UAAU,2BAA2B;EAC9D,QAAQ;EACR,SAAS,EAAE,gBAAgB,oBAAoB;EAC/C,MAAM,KAAK,UAAU;GAAE;GAAU;GAAU,CAAC;EAC7C,CAAC;AACF,KAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,8BAA8B;AAE3D,SADc,MAAM,IAAI,MAAM,EAClB;;AAGd,SAAgB,YAAY,YAAY,IAAI;CAC1C,MAAM,CAAC,UAAU,gBAAA,GAAA,MAAA,UAAgC,EAAE;CACnD,MAAM,CAAC,QAAQ,cAAA,GAAA,MAAA,UAAsC,OAAO;CAC5D,MAAM,CAAC,OAAO,aAAA,GAAA,MAAA,UAAoC,KAAK;CACvD,MAAM,CAAC,aAAa,mBAAA,GAAA,MAAA,UAA0C,KAAK;AAgEnE,QAAO;EAAE,SAAA,GAAA,MAAA,aA9DkB,OAAO,MAAmB,WAAoB;AACvE,eAAY,EAAE;AACd,aAAU,YAAY;AACtB,YAAS,KAAK;AACd,kBAAe,KAAK;AACpB,OAAI;IAEF,MAAM,aADmB,gBAAgB,OAAO,KAAK,OAAO,UAAU,KAAK,KAAK,IAC7C,MAAM,IAAI,CAAC,KAAK,IAAI;IACvD,MAAM,OAAO,OAAO,YAAY;IAChC,MAAM,WAAW,SACb,GAAG,OAAO,GAAG,KAAK,GAAG,cACrB,GAAG,KAAK,GAAG;IACf,MAAM,WAAW,gBAAgB,OAAO,KAAK,OAAO;IACpD,MAAM,eAAe,MAAM,gBAAgB,UAAU,UAAU,UAAU;AAEzE,WAAO,MAAM,IAAI,SAAiB,SAAS,WAAW;KACpD,MAAM,MAAM,IAAI,gBAAgB;AAChC,SAAI,KAAK,OAAO,aAAa;AAC7B,SAAI,iBAAiB,gBAAgB,SAAS;AAE9C,SAAI,OAAO,cAAc,UAAU;AACjC,UAAI,MAAM,iBACR,aAAY,KAAK,MAAO,MAAM,SAAS,MAAO,MAAM,MAAM,CAAC;;AAI/D,SAAI,eAAe;AACjB,UAAI,IAAI,UAAU,OAAO,IAAI,SAAS,KAAK;AACzC,mBAAY,IAAI;AAChB,iBAAU,UAAU;AAEpB,sBAAe,aAAa,MAAM,IAAI,CAAC,GAAG;AAC1C,eAAQ,SAAS;aACZ;AACL,iBAAU,QAAQ;AAClB,gBAAS,6BAA6B,IAAI,SAAS;AACnD,8BAAO,IAAI,MAAM,6BAA6B,IAAI,SAAS,CAAC;;;AAIhE,SAAI,gBAAgB;AAClB,gBAAU,QAAQ;AAClB,eAAS,8BAA8B;AACvC,6BAAO,IAAI,MAAM,8BAA8B,CAAC;;AAGlD,SAAI,KAAK,KAAK;MACd;YACK,KAAU;AACjB,cAAU,QAAQ;AAClB,aAAS,KAAK,WAAW,gBAAgB;AACzC,WAAO,QAAQ,OAAO,IAAI;;KAE3B,CAAC,UAAU,CAAC;EASE;EAAU;EAAQ;EAAO;EAAa,QAAA,GAAA,MAAA,mBAPvB;AAC9B,eAAY,EAAE;AACd,aAAU,OAAO;AACjB,YAAS,KAAK;AACd,kBAAe,KAAK;KACnB,EAAE,CAAC;EAEwD"}

package/dist/src/modules/file/hooks/useUpload.d.ts

@@ -0,0 +1,33 @@
+//#region src/modules/file/hooks/useUpload.d.ts
+type UploadStatus = "pending" | "uploading" | "completed" | "error";
+interface UploadFileTask {
+  id: string;
+  file: File;
+  progress: number;
+  status: UploadStatus;
+  errorMessage?: string;
+  bytesUploaded: number;
+  totalBytes: number;
+}
+declare function useFileUpload(): {
+  upload: <T>(type: string, file: File) => Promise<T>;
+  reset: () => void;
+  id?: string | undefined;
+  file?: File | undefined;
+  progress?: number | undefined;
+  status?: UploadStatus | undefined;
+  errorMessage?: string;
+  bytesUploaded?: number | undefined;
+  totalBytes?: number | undefined;
+};
+declare function useMultipartUpload(): {
+  uploadQueue: UploadFileTask[];
+  overallProgress: number;
+  uploadFiles: (type: string, files: File[]) => Promise<void>;
+  reset: () => void;
+  getTotalBytes: () => number;
+  getTotalBytesUploaded: () => number;
+};
+//#endregion
+export { UploadFileTask, UploadStatus, useFileUpload, useMultipartUpload };
+//# sourceMappingURL=useUpload.d.ts.map

package/dist/src/modules/file/hooks/useUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpload.d.ts","names":[],"sources":["../../../../../src/modules/file/hooks/useUpload.ts"],"mappings":";KAEY,YAAA;AAAA,UAEK,cAAA;EACf,EAAA;EACA,IAAA,EAAM,IAAA;EACN,QAAA;EACA,MAAA,EAAQ,YAAA;EACR,YAAA;EACA,aAAA;EACA,UAAA;AAAA;AAAA,iBAoEc,aAAA,CAAA;cAGqB,IAAA,UAAc,IAAA,EAAQ,IAAA,KAAO,OAAA,CAAQ,CAAA;;;;;;;;;;iBAiD1D,kBAAA,CAAA;;;8BA6DO,KAAA,EAAS,IAAA,OAAM,OAAA"}

package/dist/src/modules/file/hooks/useUpload.js

@@ -0,0 +1,160 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+//#region src/modules/file/hooks/useUpload.ts
+const createUploadPromise = (type, file, callbacks) => {
+	return new Promise((resolve, reject) => {
+		const xhr = new XMLHttpRequest();
+		xhr.upload.onprogress = (event) => {
+			if (event.lengthComputable) {
+				const progress = Math.round(event.loaded * 100 / event.total);
+				callbacks.onProgress(progress, event.loaded);
+			}
+		};
+		xhr.onload = () => {
+			if (xhr.status === 200) {
+				callbacks.onComplete();
+				if (xhr.getResponseHeader("Content-Type")?.includes("application/json")) resolve(JSON.parse(xhr.response));
+				else resolve(xhr.response);
+			} else {
+				const errorMessage = `Upload failed with status ${xhr.status}`;
+				callbacks.onError(errorMessage);
+				reject(new Error(errorMessage));
+			}
+		};
+		xhr.onerror = () => {
+			const errorMessage = "Network error during upload";
+			callbacks.onError(errorMessage);
+			reject(new Error(errorMessage));
+		};
+		xhr.open("POST", `${{}.env.VITE_SERVER_URL}/upload/file/${type}`);
+		const formData = new FormData();
+		formData.append("file", file);
+		xhr.send(formData);
+	});
+};
+const createUploadTask = (file) => ({
+	id: typeof crypto !== "undefined" && crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36).substr(2, 9),
+	file,
+	progress: 0,
+	status: "pending",
+	bytesUploaded: 0,
+	totalBytes: file.size
+});
+function useFileUpload() {
+	const [uploadTask, setUploadTask] = (0, react.useState)(null);
+	const upload = (0, react.useCallback)(async (type, file) => {
+		setUploadTask(createUploadTask(file));
+		return createUploadPromise(type, file, {
+			onProgress: (progress, bytesUploaded) => {
+				setUploadTask((prev) => prev ? {
+					...prev,
+					progress,
+					bytesUploaded,
+					status: "uploading"
+				} : null);
+			},
+			onComplete: () => {
+				setUploadTask((prev) => prev ? {
+					...prev,
+					status: "completed",
+					progress: 100
+				} : null);
+			},
+			onError: (errorMessage) => {
+				setUploadTask((prev) => prev ? {
+					...prev,
+					status: "error",
+					errorMessage,
+					progress: 0
+				} : null);
+			}
+		});
+	}, []);
+	const reset = (0, react.useCallback)(() => {
+		setUploadTask(null);
+	}, []);
+	return {
+		...uploadTask,
+		upload,
+		reset
+	};
+}
+function useMultipartUpload() {
+	const [uploadQueue, setUploadQueue] = (0, react.useState)([]);
+	const [overallProgress, setOverallProgress] = (0, react.useState)(0);
+	const updateTask = (0, react.useCallback)((id, changes) => {
+		setUploadQueue((prev) => prev.map((task) => task.id === id ? {
+			...task,
+			...changes
+		} : task));
+	}, []);
+	const updateOverallProgress = (0, react.useCallback)((queue) => {
+		if (queue.length === 0) {
+			setOverallProgress(100);
+			return;
+		}
+		const totalBytes = queue.reduce((sum, task) => sum + task.file.size, 0);
+		const uploadedBytes = queue.reduce((sum, task) => {
+			if (task.status === "completed") return sum + task.file.size;
+			if (task.status === "uploading") return sum + task.progress / 100 * task.file.size;
+			return sum;
+		}, 0);
+		setOverallProgress(Math.floor(uploadedBytes / totalBytes * 100));
+	}, []);
+	const uploadSingleFile = (0, react.useCallback)(async (type, task) => {
+		return createUploadPromise(type, task.file, {
+			onProgress: (progress, bytesUploaded) => {
+				updateTask(task.id, {
+					progress,
+					bytesUploaded,
+					status: "uploading"
+				});
+				setUploadQueue((currentQueue) => {
+					const updatedQueue = currentQueue.map((q) => q.id === task.id ? {
+						...q,
+						progress,
+						bytesUploaded
+					} : q);
+					updateOverallProgress(updatedQueue);
+					return updatedQueue;
+				});
+			},
+			onComplete: () => {
+				updateTask(task.id, {
+					status: "completed",
+					progress: 100
+				});
+			},
+			onError: (errorMessage) => {
+				updateTask(task.id, {
+					status: "error",
+					errorMessage,
+					progress: 0
+				});
+			}
+		});
+	}, [updateTask, updateOverallProgress]);
+	return {
+		uploadQueue,
+		overallProgress,
+		uploadFiles: (0, react.useCallback)(async (type, files) => {
+			const initialQueue = files.map(createUploadTask);
+			setUploadQueue(initialQueue);
+			updateOverallProgress(initialQueue);
+			for (const task of initialQueue) try {
+				await uploadSingleFile(type, task);
+			} catch (_error) {}
+		}, [uploadSingleFile, updateOverallProgress]),
+		reset: (0, react.useCallback)(() => {
+			setUploadQueue([]);
+			setOverallProgress(0);
+		}, []),
+		getTotalBytes: () => uploadQueue.reduce((sum, task) => sum + task.totalBytes, 0),
+		getTotalBytesUploaded: () => uploadQueue.reduce((sum, task) => sum + task.bytesUploaded, 0)
+	};
+}
+//#endregion
+exports.useFileUpload = useFileUpload;
+exports.useMultipartUpload = useMultipartUpload;
+
+//# sourceMappingURL=useUpload.js.map

package/dist/src/modules/file/hooks/useUpload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpload.js","names":[],"sources":["../../../../../src/modules/file/hooks/useUpload.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\r\n\r\nexport type UploadStatus = \"pending\" | \"uploading\" | \"completed\" | \"error\";\r\n\r\nexport interface UploadFileTask {\r\n  id: string;\r\n  file: File;\r\n  progress: number;\r\n  status: UploadStatus;\r\n  errorMessage?: string;\r\n  bytesUploaded: number;\r\n  totalBytes: number;\r\n}\r\n\r\ninterface UploadCallbacks {\r\n  onProgress: (progress: number, bytesUploaded: number) => void;\r\n  onComplete: () => void;\r\n  onError: (error: string) => void;\r\n}\r\n\r\n// Shared utility function to create upload promise\r\nconst createUploadPromise = <T>(\r\n  type: string,\r\n  file: File,\r\n  callbacks: UploadCallbacks\r\n): Promise<T> => {\r\n  return new Promise((resolve, reject) => {\r\n    const xhr = new XMLHttpRequest();\r\n\r\n    xhr.upload.onprogress = (event: ProgressEvent<EventTarget>) => {\r\n      if (event.lengthComputable) {\r\n        const progress = Math.round((event.loaded * 100) / event.total);\r\n        callbacks.onProgress(progress, event.loaded);\r\n      }\r\n    };\r\n\r\n    xhr.onload = () => {\r\n      if (xhr.status === 200) {\r\n        callbacks.onComplete();\r\n        // if response has json header, parse it\r\n        if (xhr.getResponseHeader(\"Content-Type\")?.includes(\"application/json\")) {\r\n          resolve(JSON.parse(xhr.response) as T);\r\n        } else {\r\n          resolve(xhr.response as T);\r\n        }\r\n      } else {\r\n        const errorMessage = `Upload failed with status ${xhr.status}`;\r\n        callbacks.onError(errorMessage);\r\n        reject(new Error(errorMessage));\r\n      }\r\n    };\r\n\r\n    xhr.onerror = () => {\r\n      const errorMessage = \"Network error during upload\";\r\n      callbacks.onError(errorMessage);\r\n      reject(new Error(errorMessage));\r\n    };\r\n\r\n    xhr.open(\"POST\", `${import.meta.env.VITE_SERVER_URL}/upload/file/${type}`);\r\n    const formData = new FormData();\r\n    formData.append(\"file\", file);\r\n    xhr.send(formData);\r\n  });\r\n};\r\n\r\n// Shared utility to create a task\r\nconst createUploadTask = (file: File): UploadFileTask => ({\r\n  id:\r\n    typeof crypto !== \"undefined\" && crypto.randomUUID\r\n      ? crypto.randomUUID()\r\n      : Math.random().toString(36).substr(2, 9),\r\n  file,\r\n  progress: 0,\r\n  status: \"pending\",\r\n  bytesUploaded: 0,\r\n  totalBytes: file.size,\r\n});\r\n\r\n// Hook for single file upload\r\nexport function useFileUpload() {\r\n  const [uploadTask, setUploadTask] = useState<UploadFileTask | null>(null);\r\n\r\n  const upload = useCallback(async <T>(type: string, file: File): Promise<T> => {\r\n    const task = createUploadTask(file);\r\n    setUploadTask(task);\r\n\r\n    const callbacks: UploadCallbacks = {\r\n      onProgress: (progress, bytesUploaded) => {\r\n        setUploadTask((prev) =>\r\n          prev\r\n            ? {\r\n                ...prev,\r\n                progress,\r\n                bytesUploaded,\r\n                status: \"uploading\",\r\n              }\r\n            : null\r\n        );\r\n      },\r\n      onComplete: () => {\r\n        setUploadTask((prev) => (prev ? { ...prev, status: \"completed\", progress: 100 } : null));\r\n      },\r\n      onError: (errorMessage) => {\r\n        setUploadTask((prev) =>\r\n          prev\r\n            ? {\r\n                ...prev,\r\n                status: \"error\",\r\n                errorMessage,\r\n                progress: 0,\r\n              }\r\n            : null\r\n        );\r\n      },\r\n    };\r\n\r\n    return createUploadPromise<T>(type, file, callbacks);\r\n  }, []);\r\n\r\n  const reset = useCallback(() => {\r\n    setUploadTask(null);\r\n  }, []);\r\n\r\n  return {\r\n    ...uploadTask,\r\n    upload,\r\n    reset,\r\n  };\r\n}\r\n\r\n// Hook for multiple file uploads\r\nexport function useMultipartUpload() {\r\n  const [uploadQueue, setUploadQueue] = useState<UploadFileTask[]>([]);\r\n  const [overallProgress, setOverallProgress] = useState<number>(0);\r\n\r\n  const updateTask = useCallback((id: string, changes: Partial<UploadFileTask>) => {\r\n    setUploadQueue((prev) => prev.map((task) => (task.id === id ? { ...task, ...changes } : task)));\r\n  }, []);\r\n\r\n  const updateOverallProgress = useCallback((queue: UploadFileTask[]) => {\r\n    if (queue.length === 0) {\r\n      setOverallProgress(100);\r\n      return;\r\n    }\r\n    const totalBytes = queue.reduce((sum, task) => sum + task.file.size, 0);\r\n    const uploadedBytes = queue.reduce((sum, task) => {\r\n      if (task.status === \"completed\") {\r\n        return sum + task.file.size;\r\n      }\r\n      if (task.status === \"uploading\") {\r\n        return sum + (task.progress / 100) * task.file.size;\r\n      }\r\n      return sum;\r\n    }, 0);\r\n    setOverallProgress(Math.floor((uploadedBytes / totalBytes) * 100));\r\n  }, []);\r\n\r\n  const uploadSingleFile = useCallback(\r\n    async <T>(type: string, task: UploadFileTask): Promise<T> => {\r\n      const callbacks: UploadCallbacks = {\r\n        onProgress: (progress, bytesUploaded) => {\r\n          updateTask(task.id, {\r\n            progress,\r\n            bytesUploaded,\r\n            status: \"uploading\",\r\n          });\r\n          setUploadQueue((currentQueue) => {\r\n            const updatedQueue = currentQueue.map((q) =>\r\n              q.id === task.id ? { ...q, progress, bytesUploaded } : q\r\n            );\r\n            updateOverallProgress(updatedQueue);\r\n            return updatedQueue;\r\n          });\r\n        },\r\n        onComplete: () => {\r\n          updateTask(task.id, { status: \"completed\", progress: 100 });\r\n        },\r\n        onError: (errorMessage) => {\r\n          updateTask(task.id, {\r\n            status: \"error\",\r\n            errorMessage,\r\n            progress: 0,\r\n          });\r\n        },\r\n      };\r\n\r\n      return createUploadPromise<T>(type, task.file, callbacks);\r\n    },\r\n    [updateTask, updateOverallProgress]\r\n  );\r\n\r\n  const uploadFiles = useCallback(\r\n    async (type: string, files: File[]) => {\r\n      const initialQueue = files.map(createUploadTask);\r\n      setUploadQueue(initialQueue);\r\n      updateOverallProgress(initialQueue);\r\n\r\n      for (const task of initialQueue) {\r\n        try {\r\n          await uploadSingleFile(type, task);\r\n        } catch (_error) {}\r\n      }\r\n    },\r\n    [uploadSingleFile, updateOverallProgress]\r\n  );\r\n\r\n  const reset = useCallback(() => {\r\n    setUploadQueue([]);\r\n    setOverallProgress(0);\r\n  }, []);\r\n\r\n  return {\r\n    uploadQueue,\r\n    overallProgress,\r\n    uploadFiles,\r\n    reset,\r\n    getTotalBytes: () => uploadQueue.reduce((sum, task) => sum + task.totalBytes, 0),\r\n    getTotalBytesUploaded: () => uploadQueue.reduce((sum, task) => sum + task.bytesUploaded, 0),\r\n  };\r\n}\r\n"],"mappings":"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"}

package/dist/src/modules/table/hooks/useDateRangeFilter.d.ts

@@ -0,0 +1,34 @@
+import { NuqsQueryParams } from "./useNuqsQueryParams.js";
+import { UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
+
+//#region src/modules/table/hooks/useDateRangeFilter.d.ts
+interface DateRangeFilterReturn<TData> {
+  params: NuqsQueryParams;
+  query: UseQueryResult<TData>;
+}
+/**
+ * Flexible query options type that accepts both standard TanStack Query options
+ * and tRPC's queryOptions function return type.
+ * Uses permissive generics to handle type differences between TanStack Query and tRPC.
+ */
+type QueryOptionsLike<TData> = UseQueryOptions<TData, any, TData, any>;
+/**
+ * Function type that accepts both standard query options functions and tRPC's queryOptions.
+ * tRPC's queryOptions accepts (input, opts?) while standard functions may only accept (input).
+ */
+type GetQueryOptionsFn<TInput, TData> = (input: TInput, ...args: any[]) => QueryOptionsLike<TData>;
+interface DateRangeFilterOptions<TInput, TData> {
+  getQueryOptions: GetQueryOptionsFn<TInput, TData>;
+  queryParams?: TInput;
+}
+/**
+ * Hook for charts with URL-synced query parameters and data fetching
+ * Similar to useNuqsTable but without rowSelection (not needed for charts)
+ */
+declare const useDateRangeFilter: <TInput, TData>({
+  getQueryOptions,
+  queryParams
+}: DateRangeFilterOptions<TInput, TData>) => DateRangeFilterReturn<TData>;
+//#endregion
+export { DateRangeFilterOptions, DateRangeFilterReturn, useDateRangeFilter };
+//# sourceMappingURL=useDateRangeFilter.d.ts.map

package/dist/src/modules/table/hooks/useDateRangeFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDateRangeFilter.d.ts","names":[],"sources":["../../../../../src/modules/table/hooks/useDateRangeFilter.ts"],"mappings":";;;;UAIiB,qBAAA;EACf,MAAA,EAAQ,eAAA;EACR,KAAA,EAAO,cAAA,CAAe,KAAA;AAAA;;;;;;KASnB,gBAAA,UAA0B,eAAA,CAAgB,KAAA,OAAY,KAAA;;;;;KAOtD,iBAAA,mBAAoC,KAAA,EAAO,MAAA,KAAW,IAAA,YAAgB,gBAAA,CAAiB,KAAA;AAAA,UAE3E,sBAAA;EACf,eAAA,EAAiB,iBAAA,CAAkB,MAAA,EAAQ,KAAA;EAC3C,WAAA,GAAc,MAAA;AAAA;;;;;cAOH,kBAAA;EAAqC,eAAA;EAAA;AAAA,GAG/C,sBAAA,CAAuB,MAAA,EAAQ,KAAA,MAAS,qBAAA,CAAsB,KAAA"}

package/dist/src/modules/table/hooks/useDateRangeFilter.js

@@ -0,0 +1,30 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_src_modules_table_hooks_useNuqsQueryParams = require("./useNuqsQueryParams.js");
+const require_src_modules_table_hooks_useQueryWithParams = require("./useQueryWithParams.js");
+//#region src/modules/table/hooks/useDateRangeFilter.ts
+/**
+* Hook for charts with URL-synced query parameters and data fetching
+* Similar to useNuqsTable but without rowSelection (not needed for charts)
+*/
+const useDateRangeFilter = ({ getQueryOptions, queryParams = {} }) => {
+	const nuqs = require_src_modules_table_hooks_useNuqsQueryParams.useNuqsQueryParams();
+	return {
+		params: nuqs,
+		query: require_src_modules_table_hooks_useQueryWithParams.useQueryWithParams({
+			getQueryOptions,
+			queryParams,
+			queryState: {
+				filters: nuqs.filters,
+				q: nuqs.q,
+				sort: nuqs.sort,
+				order: nuqs.order,
+				page: nuqs.page,
+				limit: nuqs.limit
+			}
+		})
+	};
+};
+//#endregion
+exports.useDateRangeFilter = useDateRangeFilter;
+
+//# sourceMappingURL=useDateRangeFilter.js.map

package/dist/src/modules/table/hooks/useDateRangeFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDateRangeFilter.js","names":["useNuqsQueryParams","useQueryWithParams"],"sources":["../../../../../src/modules/table/hooks/useDateRangeFilter.ts"],"sourcesContent":["import type { UseQueryOptions, UseQueryResult } from \"@tanstack/react-query\";\r\nimport { type NuqsQueryParams, useNuqsQueryParams } from \"./useNuqsQueryParams\";\r\nimport { useQueryWithParams } from \"./useQueryWithParams\";\r\n\r\nexport interface DateRangeFilterReturn<TData> {\r\n  params: NuqsQueryParams;\r\n  query: UseQueryResult<TData>;\r\n}\r\n\r\n/**\r\n * Flexible query options type that accepts both standard TanStack Query options\r\n * and tRPC's queryOptions function return type.\r\n * Uses permissive generics to handle type differences between TanStack Query and tRPC.\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype QueryOptionsLike<TData> = UseQueryOptions<TData, any, TData, any>;\r\n\r\n/**\r\n * Function type that accepts both standard query options functions and tRPC's queryOptions.\r\n * tRPC's queryOptions accepts (input, opts?) while standard functions may only accept (input).\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype GetQueryOptionsFn<TInput, TData> = (input: TInput, ...args: any[]) => QueryOptionsLike<TData>;\r\n\r\nexport interface DateRangeFilterOptions<TInput, TData> {\r\n  getQueryOptions: GetQueryOptionsFn<TInput, TData>;\r\n  queryParams?: TInput;\r\n}\r\n\r\n/**\r\n * Hook for charts with URL-synced query parameters and data fetching\r\n * Similar to useNuqsTable but without rowSelection (not needed for charts)\r\n */\r\nexport const useDateRangeFilter = <TInput, TData>({\r\n  getQueryOptions,\r\n  queryParams = {} as TInput,\r\n}: DateRangeFilterOptions<TInput, TData>): DateRangeFilterReturn<TData> => {\r\n  const nuqs = useNuqsQueryParams();\r\n\r\n  const queryResult = useQueryWithParams({\r\n    getQueryOptions,\r\n    queryParams,\r\n    queryState: {\r\n      filters: nuqs.filters,\r\n      q: nuqs.q,\r\n      sort: nuqs.sort,\r\n      order: nuqs.order,\r\n      page: nuqs.page,\r\n      limit: nuqs.limit,\r\n    },\r\n  });\r\n\r\n  return {\r\n    params: nuqs,\r\n    query: queryResult,\r\n  };\r\n};\r\n"],"mappings":";;;;;;;;AAiCA,MAAa,sBAAqC,EAChD,iBACA,cAAc,EAAE,OACyD;CACzE,MAAM,OAAOA,mDAAAA,oBAAoB;AAejC,QAAO;EACL,QAAQ;EACR,OAfkBC,mDAAAA,mBAAmB;GACrC;GACA;GACA,YAAY;IACV,SAAS,KAAK;IACd,GAAG,KAAK;IACR,MAAM,KAAK;IACX,OAAO,KAAK;IACZ,MAAM,KAAK;IACX,OAAO,KAAK;IACb;GACF,CAAC;EAKD"}

package/dist/src/modules/table/hooks/useDateRangeFilter.mjs

@@ -6,22 +6,21 @@ import { useQueryWithParams } from "./useQueryWithParams.mjs";
 * Similar to useNuqsTable but without rowSelection (not needed for charts)
 */
 const useDateRangeFilter = ({ getQueryOptions, queryParams = {} }) => {
-	const { filters, setFilters, granularity, setGranularity } = useNuqsQueryParams();
-	const queryResult = useQueryWithParams({
-		getQueryOptions,
-		queryParams,
-		queryState: { filters }
-	});
+	const nuqs = useNuqsQueryParams();
 	return {
-		params: {
-			filters,
-			setFilters,
-			granularity,
-			setGranularity,
-			grouping: [],
-			setGrouping: () => {}
-		},
-		query: queryResult
+		params: nuqs,
+		query: useQueryWithParams({
+			getQueryOptions,
+			queryParams,
+			queryState: {
+				filters: nuqs.filters,
+				q: nuqs.q,
+				sort: nuqs.sort,
+				order: nuqs.order,
+				page: nuqs.page,
+				limit: nuqs.limit
+			}
+		})
 	};
 };
 //#endregion

package/dist/src/modules/table/hooks/useDateRangeFilter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useDateRangeFilter.mjs","names":[],"sources":["../../../../../src/modules/table/hooks/useDateRangeFilter.ts"],"sourcesContent":["import type { UseQueryOptions, UseQueryResult } from \"@tanstack/react-query\";\r\nimport { type NuqsQueryParams, useNuqsQueryParams } from \"./useNuqsQueryParams\";\r\nimport { useQueryWithParams } from \"./useQueryWithParams\";\r\n\r\nexport interface DateRangeFilterReturn<TData> {\r\n  params: NuqsQueryParams;\r\n  query: UseQueryResult<TData>;\r\n}\r\n\r\n/**\r\n * Flexible query options type that accepts both standard TanStack Query options\r\n * and tRPC's queryOptions function return type.\r\n * Uses permissive generics to handle type differences between TanStack Query and tRPC.\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype QueryOptionsLike<TData> = UseQueryOptions<TData, any, TData, any>;\r\n\r\n/**\r\n * Function type that accepts both standard query options functions and tRPC's queryOptions.\r\n * tRPC's queryOptions accepts (input, opts?) while standard functions may only accept (input).\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype GetQueryOptionsFn<TInput, TData> = (input: TInput, ...args: any[]) => QueryOptionsLike<TData>;\r\n\r\nexport interface DateRangeFilterOptions<TInput, TData> {\r\n  getQueryOptions: GetQueryOptionsFn<TInput, TData>;\r\n  queryParams?: TInput;\r\n}\r\n\r\n/**\r\n * Hook for charts with URL-synced query parameters and data fetching\r\n * Similar to useNuqsTable but without rowSelection (not needed for charts)\r\n */\r\nexport const useDateRangeFilter = <TInput, TData>({\r\n  getQueryOptions,\r\n  queryParams = {} as TInput,\r\n}: DateRangeFilterOptions<TInput, TData>): DateRangeFilterReturn<TData> => {\r\n  // Get only filters from URL query state\r\n  const { filters, setFilters, granularity, setGranularity } = useNuqsQueryParams();\r\n\r\n  // Get query result\r\n  const queryResult = useQueryWithParams({\r\n    getQueryOptions,\r\n    queryParams,\r\n    queryState: { filters },\r\n  });\r\n\r\n  return {\r\n    params: {\r\n      filters,\r\n      setFilters,\r\n      granularity,\r\n      setGranularity,\r\n      // TODO: Review - just fixing ts errors for now\r\n      grouping: [],\r\n      setGrouping: () => {},\r\n    },\r\n    query: queryResult,\r\n  };\r\n};\r\n"],"mappings":";;;;;;;AAiCA,MAAa,sBAAqC,EAChD,iBACA,cAAc,EAAE,OACyD;CAEzE,MAAM,EAAE,SAAS,YAAY,aAAa,mBAAmB,oBAAoB;CAGjF,MAAM,cAAc,mBAAmB;EACrC;EACA;EACA,YAAY,EAAE,SAAS;EACxB,CAAC;AAEF,QAAO;EACL,QAAQ;GACN;GACA;GACA;GACA;GAEA,UAAU,EAAE;GACZ,mBAAmB;GACpB;EACD,OAAO;EACR"}
+{"version":3,"file":"useDateRangeFilter.mjs","names":[],"sources":["../../../../../src/modules/table/hooks/useDateRangeFilter.ts"],"sourcesContent":["import type { UseQueryOptions, UseQueryResult } from \"@tanstack/react-query\";\r\nimport { type NuqsQueryParams, useNuqsQueryParams } from \"./useNuqsQueryParams\";\r\nimport { useQueryWithParams } from \"./useQueryWithParams\";\r\n\r\nexport interface DateRangeFilterReturn<TData> {\r\n  params: NuqsQueryParams;\r\n  query: UseQueryResult<TData>;\r\n}\r\n\r\n/**\r\n * Flexible query options type that accepts both standard TanStack Query options\r\n * and tRPC's queryOptions function return type.\r\n * Uses permissive generics to handle type differences between TanStack Query and tRPC.\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype QueryOptionsLike<TData> = UseQueryOptions<TData, any, TData, any>;\r\n\r\n/**\r\n * Function type that accepts both standard query options functions and tRPC's queryOptions.\r\n * tRPC's queryOptions accepts (input, opts?) while standard functions may only accept (input).\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype GetQueryOptionsFn<TInput, TData> = (input: TInput, ...args: any[]) => QueryOptionsLike<TData>;\r\n\r\nexport interface DateRangeFilterOptions<TInput, TData> {\r\n  getQueryOptions: GetQueryOptionsFn<TInput, TData>;\r\n  queryParams?: TInput;\r\n}\r\n\r\n/**\r\n * Hook for charts with URL-synced query parameters and data fetching\r\n * Similar to useNuqsTable but without rowSelection (not needed for charts)\r\n */\r\nexport const useDateRangeFilter = <TInput, TData>({\r\n  getQueryOptions,\r\n  queryParams = {} as TInput,\r\n}: DateRangeFilterOptions<TInput, TData>): DateRangeFilterReturn<TData> => {\r\n  const nuqs = useNuqsQueryParams();\r\n\r\n  const queryResult = useQueryWithParams({\r\n    getQueryOptions,\r\n    queryParams,\r\n    queryState: {\r\n      filters: nuqs.filters,\r\n      q: nuqs.q,\r\n      sort: nuqs.sort,\r\n      order: nuqs.order,\r\n      page: nuqs.page,\r\n      limit: nuqs.limit,\r\n    },\r\n  });\r\n\r\n  return {\r\n    params: nuqs,\r\n    query: queryResult,\r\n  };\r\n};\r\n"],"mappings":";;;;;;;AAiCA,MAAa,sBAAqC,EAChD,iBACA,cAAc,EAAE,OACyD;CACzE,MAAM,OAAO,oBAAoB;AAejC,QAAO;EACL,QAAQ;EACR,OAfkB,mBAAmB;GACrC;GACA;GACA,YAAY;IACV,SAAS,KAAK;IACd,GAAG,KAAK;IACR,MAAM,KAAK;IACX,OAAO,KAAK;IACZ,MAAM,KAAK;IACX,OAAO,KAAK;IACb;GACF,CAAC;EAKD"}

package/dist/src/modules/table/hooks/useNuqsQueryParams.d.mts

@@ -8,6 +8,9 @@ import { QueryFilters } from "@m5kdev/commons/modules/schemas/query.schema";
 type Order = "asc" | "desc";
 type Granularity = "daily" | "weekly" | "monthly" | "yearly";
 interface NuqsQueryParams {
+  /** Global search string from URL (`q`); absent when not in URL. */
+  q: string | null;
+  setQ: (value: string | null) => void;
   filters?: QueryFilters;
   setFilters?: (filters: QueryFilters) => void;
   granularity?: Granularity;
@@ -25,7 +28,7 @@ interface NuqsQueryParams {
 }
 /**
  * Hook to manage all query parameters via nuqs (URL query parameters)
- * Manages: filters, sort, order, page, limit, groupBy, granularity
+ * Manages: filters, q, sort, order, page, limit, groupBy, granularity
  * Accepts an optional prefix to namespace params when multiple tables share a view.
  */
 declare const useNuqsQueryParams: (prefix?: string) => NuqsQueryParams;

package/dist/src/modules/table/hooks/useNuqsQueryParams.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"useNuqsQueryParams.d.mts","names":[],"sources":["../../../../../src/modules/table/hooks/useNuqsQueryParams.ts"],"mappings":";;;;;;;KAmBY,KAAA;AAAA,KAEA,WAAA;AAAA,UAEK,eAAA;EACf,OAAA,GAAU,YAAA;EACV,UAAA,IAAc,OAAA,EAAS,YAAA;EACvB,WAAA,GAAc,WAAA;EACd,cAAA,IAAkB,KAAA,EAAO,WAAA;EACzB,IAAA;EACA,KAAA,GAAQ,KAAA;EACR,UAAA,IAAc,OAAA,EAAS,OAAA,CAAQ,YAAA;EAC/B,OAAA,GAAU,YAAA;EACV,IAAA;EACA,KAAA;EACA,aAAA,IAAiB,OAAA,EAAS,OAAA,CAAQ,eAAA;EAClC,UAAA,GAAa,eAAA;EACb,QAAA,EAAU,aAAA;EACV,WAAA,GAAc,OAAA,EAAS,OAAA,CAAQ,aAAA;AAAA;;;;;;cAQpB,kBAAA,GAAsB,MAAA,cAAkB,eAAA"}
+{"version":3,"file":"useNuqsQueryParams.d.mts","names":[],"sources":["../../../../../src/modules/table/hooks/useNuqsQueryParams.ts"],"mappings":";;;;;;;KAmBY,KAAA;AAAA,KAEA,WAAA;AAAA,UAEK,eAAA;;EAEf,CAAA;EACA,IAAA,GAAO,KAAA;EACP,OAAA,GAAU,YAAA;EACV,UAAA,IAAc,OAAA,EAAS,YAAA;EACvB,WAAA,GAAc,WAAA;EACd,cAAA,IAAkB,KAAA,EAAO,WAAA;EACzB,IAAA;EACA,KAAA,GAAQ,KAAA;EACR,UAAA,IAAc,OAAA,EAAS,OAAA,CAAQ,YAAA;EAC/B,OAAA,GAAU,YAAA;EACV,IAAA;EACA,KAAA;EACA,aAAA,IAAiB,OAAA,EAAS,OAAA,CAAQ,eAAA;EAClC,UAAA,GAAa,eAAA;EACb,QAAA,EAAU,aAAA;EACV,WAAA,GAAc,OAAA,EAAS,OAAA,CAAQ,aAAA;AAAA;;;;;;cAQpB,kBAAA,GAAsB,MAAA,cAAkB,eAAA"}

package/dist/src/modules/table/hooks/useNuqsQueryParams.d.ts

@@ -0,0 +1,37 @@
+import { SortingState } from "../../../../node_modules/.pnpm/@tanstack_table-core@8.21.2/node_modules/@tanstack/table-core/build/lib/features/RowSorting.js";
+import { GroupingState } from "../../../../node_modules/.pnpm/@tanstack_table-core@8.21.2/node_modules/@tanstack/table-core/build/lib/features/ColumnGrouping.js";
+import { PaginationState } from "../../../../node_modules/.pnpm/@tanstack_table-core@8.21.2/node_modules/@tanstack/table-core/build/lib/features/RowPagination.js";
+import { Updater } from "../../../../node_modules/.pnpm/@tanstack_table-core@8.21.2/node_modules/@tanstack/table-core/build/lib/types.js";
+import { QueryFilters } from "@m5kdev/commons/modules/schemas/query.schema";
+
+//#region src/modules/table/hooks/useNuqsQueryParams.d.ts
+type Order = "asc" | "desc";
+type Granularity = "daily" | "weekly" | "monthly" | "yearly";
+interface NuqsQueryParams {
+  /** Global search string from URL (`q`); absent when not in URL. */
+  q: string | null;
+  setQ: (value: string | null) => void;
+  filters?: QueryFilters;
+  setFilters?: (filters: QueryFilters) => void;
+  granularity?: Granularity;
+  setGranularity?: (value: Granularity) => void;
+  sort?: string;
+  order?: Order | null;
+  setSorting?: (updater: Updater<SortingState>) => void;
+  sorting?: SortingState;
+  page?: number;
+  limit?: number;
+  setPagination?: (updater: Updater<PaginationState>) => void;
+  pagination?: PaginationState;
+  grouping: GroupingState;
+  setGrouping: (updater: Updater<GroupingState>) => void;
+}
+/**
+ * Hook to manage all query parameters via nuqs (URL query parameters)
+ * Manages: filters, q, sort, order, page, limit, groupBy, granularity
+ * Accepts an optional prefix to namespace params when multiple tables share a view.
+ */
+declare const useNuqsQueryParams: (prefix?: string) => NuqsQueryParams;
+//#endregion
+export { Granularity, NuqsQueryParams, Order, useNuqsQueryParams };
+//# sourceMappingURL=useNuqsQueryParams.d.ts.map

package/dist/src/modules/table/hooks/useNuqsQueryParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNuqsQueryParams.d.ts","names":[],"sources":["../../../../../src/modules/table/hooks/useNuqsQueryParams.ts"],"mappings":";;;;;;;KAmBY,KAAA;AAAA,KAEA,WAAA;AAAA,UAEK,eAAA;;EAEf,CAAA;EACA,IAAA,GAAO,KAAA;EACP,OAAA,GAAU,YAAA;EACV,UAAA,IAAc,OAAA,EAAS,YAAA;EACvB,WAAA,GAAc,WAAA;EACd,cAAA,IAAkB,KAAA,EAAO,WAAA;EACzB,IAAA;EACA,KAAA,GAAQ,KAAA;EACR,UAAA,IAAc,OAAA,EAAS,OAAA,CAAQ,YAAA;EAC/B,OAAA,GAAU,YAAA;EACV,IAAA;EACA,KAAA;EACA,aAAA,IAAiB,OAAA,EAAS,OAAA,CAAQ,eAAA;EAClC,UAAA,GAAa,eAAA;EACb,QAAA,EAAU,aAAA;EACV,WAAA,GAAc,OAAA,EAAS,OAAA,CAAQ,aAAA;AAAA;;;;;;cAQpB,kBAAA,GAAsB,MAAA,cAAkB,eAAA"}

package/dist/src/modules/table/hooks/useNuqsQueryParams.js

@@ -0,0 +1,120 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+let _m5kdev_commons_modules_schemas_query_schema = require("@m5kdev/commons/modules/schemas/query.schema");
+let nuqs = require("nuqs");
+//#region src/modules/table/hooks/useNuqsQueryParams.ts
+const parseAsFilters = (0, nuqs.parseAsJson)((value) => _m5kdev_commons_modules_schemas_query_schema.filtersSchema.parse(value)).withDefault([]);
+const parseAsGrouping = (0, nuqs.parseAsArrayOf)(nuqs.parseAsString).withDefault([]);
+/**
+* Hook to manage all query parameters via nuqs (URL query parameters)
+* Manages: filters, q, sort, order, page, limit, groupBy, granularity
+* Accepts an optional prefix to namespace params when multiple tables share a view.
+*/
+const useNuqsQueryParams = (prefix) => {
+	const k = (name) => prefix ? `${prefix}_${name}` : name;
+	const [sort, setSort] = (0, nuqs.useQueryState)(k("sort"), nuqs.parseAsString.withDefault(""));
+	const [order, setOrder] = (0, nuqs.useQueryState)(k("order"), (0, nuqs.parseAsStringLiteral)(["asc", "desc"]));
+	const [page, setPage] = (0, nuqs.useQueryState)(k("page"), nuqs.parseAsInteger.withDefault(1));
+	const [limit, setLimit] = (0, nuqs.useQueryState)(k("limit"), nuqs.parseAsInteger.withDefault(10));
+	const [qRaw, setQRaw] = (0, nuqs.useQueryState)(k("q"), nuqs.parseAsString);
+	const [filters, setFilters] = (0, nuqs.useQueryState)(k("filters"), parseAsFilters);
+	const setQ = (0, react.useCallback)((value) => {
+		setQRaw(value === "" || value == null ? null : value);
+	}, [setQRaw]);
+	const [granularity, setGranularity] = (0, nuqs.useQueryState)(k("granularity"), (0, nuqs.parseAsStringLiteral)([
+		"daily",
+		"weekly",
+		"monthly",
+		"yearly"
+	]).withDefault("daily"));
+	const [groupingRaw, setGroupingRaw] = (0, nuqs.useQueryState)(k("groupBy"), parseAsGrouping);
+	const grouping = groupingRaw;
+	const setGrouping = (0, react.useCallback)((updater) => {
+		const next = typeof updater === "function" ? updater(groupingRaw) : updater;
+		setGroupingRaw(next.length > 0 ? next : null);
+	}, [groupingRaw, setGroupingRaw]);
+	const sorting = (0, react.useMemo)(() => {
+		if (!sort) return [];
+		return [{
+			id: sort,
+			desc: (order ?? "asc") === "desc"
+		}];
+	}, [sort, order]);
+	const pagination = (0, react.useMemo)(() => ({
+		pageIndex: page - 1,
+		pageSize: limit
+	}), [page, limit]);
+	const setSorting = (0, react.useCallback)((updater) => {
+		const first = (typeof updater === "function" ? updater(sort ? [{
+			id: sort,
+			desc: (order ?? "asc") === "desc"
+		}] : []) : updater)[0];
+		if (!first || !first.id) {
+			setSort("");
+			setOrder(null);
+			return;
+		}
+		setSort(first.id);
+		setOrder(first.desc ? "desc" : "asc");
+	}, [
+		sort,
+		order,
+		setSort,
+		setOrder
+	]);
+	(0, react.useEffect)(() => {
+		if (sort && !order) setOrder("asc");
+	}, [
+		sort,
+		order,
+		setOrder
+	]);
+	const setPagination = (0, react.useCallback)((updater) => {
+		const currentState = {
+			pageIndex: page - 1,
+			pageSize: limit
+		};
+		const next = typeof updater === "function" ? updater(currentState) : updater;
+		setPage((next.pageIndex ?? 0) + 1);
+		setLimit(next.pageSize ?? 10);
+	}, [page, limit]);
+	return (0, react.useMemo)(() => ({
+		q: qRaw,
+		setQ,
+		filters,
+		setFilters,
+		granularity,
+		setGranularity,
+		sort,
+		order,
+		setSorting,
+		sorting,
+		page,
+		limit,
+		setPagination,
+		pagination,
+		grouping,
+		setGrouping
+	}), [
+		qRaw,
+		setQ,
+		filters,
+		setFilters,
+		granularity,
+		setGranularity,
+		sort,
+		order,
+		setSorting,
+		sorting,
+		page,
+		limit,
+		setPagination,
+		pagination,
+		grouping,
+		setGrouping
+	]);
+};
+//#endregion
+exports.useNuqsQueryParams = useNuqsQueryParams;
+
+//# sourceMappingURL=useNuqsQueryParams.js.map