@m5kdev/frontend 0.1.0

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

@@ -0,0 +1,167 @@
+import { useCallback, useState } from "react";
+// Shared utility function to create upload promise
+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 response has json header, parse it
+                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", `${import.meta.env.VITE_SERVER_URL}/upload/file/${type}`);
+        const formData = new FormData();
+        formData.append("file", file);
+        xhr.send(formData);
+    });
+};
+// Shared utility to create a task
+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,
+});
+// Hook for single file upload
+export function useFileUpload() {
+    const [uploadTask, setUploadTask] = useState(null);
+    const upload = useCallback(async (type, file) => {
+        const task = createUploadTask(file);
+        setUploadTask(task);
+        const callbacks = {
+            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);
+            },
+        };
+        return createUploadPromise(type, file, callbacks);
+    }, []);
+    const reset = useCallback(() => {
+        setUploadTask(null);
+    }, []);
+    return {
+        ...uploadTask,
+        upload,
+        reset,
+    };
+}
+// Hook for multiple file uploads
+export function useMultipartUpload() {
+    const [uploadQueue, setUploadQueue] = useState([]);
+    const [overallProgress, setOverallProgress] = useState(0);
+    const updateTask = useCallback((id, changes) => {
+        setUploadQueue((prev) => prev.map((task) => (task.id === id ? { ...task, ...changes } : task)));
+    }, []);
+    const updateOverallProgress = 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 = useCallback(async (type, task) => {
+        const callbacks = {
+            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,
+                });
+            },
+        };
+        return createUploadPromise(type, task.file, callbacks);
+    }, [updateTask, updateOverallProgress]);
+    const uploadFiles = 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]);
+    const reset = useCallback(() => {
+        setUploadQueue([]);
+        setOverallProgress(0);
+    }, []);
+    return {
+        uploadQueue,
+        overallProgress,
+        uploadFiles,
+        reset,
+        getTotalBytes: () => uploadQueue.reduce((sum, task) => sum + task.totalBytes, 0),
+        getTotalBytesUploaded: () => uploadQueue.reduce((sum, task) => sum + task.bytesUploaded, 0),
+    };
+}

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

@@ -0,0 +1,28 @@
+import type { UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
+import { type NuqsQueryParams } from "./useNuqsQueryParams";
+export 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>;
+export 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)
+ */
+export declare const useDateRangeFilter: <TInput, TData>({ getQueryOptions, queryParams, }: DateRangeFilterOptions<TInput, TData>) => DateRangeFilterReturn<TData>;
+export {};
+//# sourceMappingURL=useDateRangeFilter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDateRangeFilter.d.ts","sourceRoot":"","sources":["../../../../../src/modules/table/hooks/useDateRangeFilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGhF,MAAM,WAAW,qBAAqB,CAAC,KAAK;IAC1C,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AAEH,KAAK,gBAAgB,CAAC,KAAK,IAAI,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AAEvE;;;GAGG;AAEH,KAAK,iBAAiB,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAEnG,MAAM,WAAW,sBAAsB,CAAC,MAAM,EAAE,KAAK;IACnD,eAAe,EAAE,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,EAAE,KAAK,EAAE,mCAG/C,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,KAAG,qBAAqB,CAAC,KAAK,CAgBrE,CAAC"}

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

@@ -0,0 +1,20 @@
+import { useNuqsQueryParams } from "./useNuqsQueryParams";
+import { useQueryWithParams } from "./useQueryWithParams";
+/**
+ * Hook for charts with URL-synced query parameters and data fetching
+ * Similar to useNuqsTable but without rowSelection (not needed for charts)
+ */
+export const useDateRangeFilter = ({ getQueryOptions, queryParams = {}, }) => {
+    // Get only filters from URL query state
+    const { filters, setFilters, granularity, setGranularity } = useNuqsQueryParams();
+    // Get query result
+    const queryResult = useQueryWithParams({
+        getQueryOptions,
+        queryParams,
+        queryState: { filters },
+    });
+    return {
+        params: { filters, setFilters, granularity, setGranularity },
+        query: queryResult,
+    };
+};

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

@@ -0,0 +1,25 @@
+import type { QueryFilters } from "@m5kdev/commons/modules/schemas/query.schema";
+import type { PaginationState, SortingState, Updater } from "@tanstack/react-table";
+export type Order = "asc" | "desc";
+export type Granularity = "daily" | "weekly" | "monthly" | "yearly";
+export interface NuqsQueryParams {
+    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;
+}
+/**
+ * Hook to manage all query parameters via nuqs (URL query parameters)
+ * Manages: filters, sort, order, page, limit
+ * Reusable for any paginated/sorted/filtered lists
+ */
+export declare const useNuqsQueryParams: () => NuqsQueryParams;
+//# sourceMappingURL=useNuqsQueryParams.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useNuqsQueryParams.d.ts","sourceRoot":"","sources":["../../../../../src/modules/table/hooks/useNuqsQueryParams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAEjF,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAcpF,MAAM,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAEnC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACtD,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;IAC5D,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAO,eA6FrC,CAAC"}

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

@@ -0,0 +1,82 @@
+import { filtersSchema } from "@m5kdev/commons/modules/schemas/query.schema";
+import { parseAsInteger, parseAsJson, parseAsString, parseAsStringLiteral, useQueryState, } from "nuqs";
+import { useCallback, useEffect, useMemo } from "react";
+const parseAsFilters = parseAsJson((value) => filtersSchema.parse(value)).withDefault([]);
+/**
+ * Hook to manage all query parameters via nuqs (URL query parameters)
+ * Manages: filters, sort, order, page, limit
+ * Reusable for any paginated/sorted/filtered lists
+ */
+export const useNuqsQueryParams = () => {
+    const [sort, setSort] = useQueryState("sort", parseAsString.withDefault(""));
+    const [order, setOrder] = useQueryState("order", parseAsStringLiteral(["asc", "desc"]));
+    const [page, setPage] = useQueryState("page", parseAsInteger.withDefault(1));
+    const [limit, setLimit] = useQueryState("limit", parseAsInteger.withDefault(10));
+    const [filters, setFilters] = useQueryState("filters", parseAsFilters);
+    const [granularity, setGranularity] = useQueryState("granularity", parseAsStringLiteral(["daily", "weekly", "monthly", "yearly"]).withDefault("daily"));
+    const sorting = useMemo(() => {
+        if (!sort) {
+            return [];
+        }
+        const effectiveOrder = order ?? "asc";
+        return [{ id: sort, desc: effectiveOrder === "desc" }];
+    }, [sort, order]);
+    const pagination = useMemo(() => ({ pageIndex: page - 1, pageSize: limit }), [page, limit]);
+    const setSorting = useCallback((updater) => {
+        // Build current sorting state from current values
+        const currentSorting = sort
+            ? [{ id: sort, desc: (order ?? "asc") === "desc" }]
+            : [];
+        const next = typeof updater === "function" ? updater(currentSorting) : updater;
+        const first = next[0];
+        if (!first || !first.id) {
+            setSort("");
+            setOrder(null);
+            return;
+        }
+        setSort(first.id);
+        setOrder(first.desc ? "desc" : "asc");
+    }, [sort, order, setSort, setOrder]);
+    // Sync order to "asc" if sort is set but order is null (handles URL state inconsistencies)
+    useEffect(() => {
+        if (sort && !order) {
+            setOrder("asc");
+        }
+    }, [sort, order, setOrder]);
+    // biome-ignore lint/correctness/useExhaustiveDependencies: dependent on page and limit only
+    const setPagination = useCallback((updater) => {
+        // TanStack Table uses 0-based indexing, but URL uses 1-based
+        const currentState = { pageIndex: page - 1, pageSize: limit };
+        const next = typeof updater === "function" ? updater(currentState) : updater;
+        // Convert back to 1-based for URL
+        setPage((next.pageIndex ?? 0) + 1);
+        setLimit(next.pageSize ?? 10);
+    }, [page, limit]);
+    return useMemo(() => ({
+        filters,
+        setFilters,
+        granularity,
+        setGranularity,
+        sort,
+        order,
+        setSorting,
+        sorting,
+        page,
+        limit,
+        setPagination,
+        pagination,
+    }), [
+        filters,
+        setFilters,
+        granularity,
+        setGranularity,
+        sort,
+        order,
+        setSorting,
+        sorting,
+        page,
+        limit,
+        setPagination,
+        pagination,
+    ]);
+};

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

@@ -0,0 +1,33 @@
+import type { UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
+import type { RowSelectionState, Updater } from "@tanstack/react-table";
+import { type NuqsQueryParams } from "./useNuqsQueryParams";
+export interface TableParams extends NuqsQueryParams {
+    rowSelection: RowSelectionState;
+    setRowSelection: (updater: Updater<RowSelectionState>) => void;
+}
+/**
+ * Alias for TableParams - used by TablePagination and other table components
+ */
+export type TableProps = TableParams;
+export interface NuqsTableReturn<TData> {
+    params: TableParams;
+    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>;
+export interface NuqsTableOptions<TInput, TData> {
+    getQueryOptions: GetQueryOptionsFn<TInput, TData>;
+    queryParams?: TInput;
+}
+declare const useNuqsTable: <TInput, TData>({ getQueryOptions, queryParams, }: NuqsTableOptions<TInput, TData>) => NuqsTableReturn<TData>;
+export default useNuqsTable;
+//# sourceMappingURL=useNuqsTable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useNuqsTable.d.ts","sourceRoot":"","sources":["../../../../../src/modules/table/hooks/useNuqsTable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,sBAAsB,CAAC;AAGhF,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,YAAY,EAAE,iBAAiB,CAAC;IAChC,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC;AAErC,MAAM,WAAW,eAAe,CAAC,KAAK;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AAEH,KAAK,gBAAgB,CAAC,KAAK,IAAI,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AAEvE;;;GAGG;AAEH,KAAK,iBAAiB,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAEnG,MAAM,WAAW,gBAAgB,CAAC,MAAM,EAAE,KAAK;IAC7C,eAAe,EAAE,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,QAAA,MAAM,YAAY,GAAI,MAAM,EAAE,KAAK,EAAE,mCAGlC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,KAAG,eAAe,CAAC,KAAK,CAoCzD,CAAC;AAEF,eAAe,YAAY,CAAC"}

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

@@ -0,0 +1,32 @@
+import { useCallback, useMemo, useState } from "react";
+import { useNuqsQueryParams } from "./useNuqsQueryParams";
+import { useQueryWithParams } from "./useQueryWithParams";
+const useNuqsTable = ({ getQueryOptions, queryParams = {}, }) => {
+    // Get all URL query state
+    const queryState = useNuqsQueryParams();
+    // Get query result
+    const queryResult = useQueryWithParams({
+        getQueryOptions,
+        queryParams,
+        queryState,
+    });
+    // Table-specific row selection state
+    const [rowSelection, setRowSelectionRaw] = useState({});
+    console.log("rowSelection", rowSelection);
+    const setRowSelection = useCallback((updater) => {
+        setRowSelectionRaw((prev) => {
+            const next = typeof updater === "function" ? updater(prev) : updater;
+            return next;
+        });
+    }, []);
+    const params = useMemo(() => ({
+        ...queryState,
+        rowSelection,
+        setRowSelection,
+    }), [queryState, rowSelection, setRowSelection]);
+    return {
+        params,
+        query: queryResult,
+    };
+};
+export default useNuqsTable;

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

@@ -0,0 +1,26 @@
+import { type UseQueryOptions, type UseQueryResult } from "@tanstack/react-query";
+import type { NuqsQueryParams } from "./useNuqsQueryParams";
+/**
+ * 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>;
+export interface QueryWithParamsOptions<TInput, TData> {
+    getQueryOptions: GetQueryOptionsFn<TInput, TData>;
+    queryParams?: TInput;
+    queryState: Pick<NuqsQueryParams, "filters" | "sort" | "order" | "page" | "limit">;
+    enabled?: boolean;
+}
+/**
+ * Hook to integrate query state with React Query
+ * Combines queryParams with queryState and manages data fetching
+ */
+export declare const useQueryWithParams: <TInput, TData>({ getQueryOptions, queryParams, queryState, enabled, }: QueryWithParamsOptions<TInput, TData>) => UseQueryResult<TData>;
+export {};
+//# sourceMappingURL=useQueryWithParams.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useQueryWithParams.d.ts","sourceRoot":"","sources":["../../../../../src/modules/table/hooks/useQueryWithParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAY,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;GAIG;AAEH,KAAK,gBAAgB,CAAC,KAAK,IAAI,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AAEvE;;;GAGG;AAEH,KAAK,iBAAiB,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAEnG,MAAM,WAAW,sBAAsB,CAAC,MAAM,EAAE,KAAK;IACnD,eAAe,EAAE,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACnF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,EAAE,KAAK,EAAE,wDAK/C,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,KAAG,cAAc,CAAC,KAAK,CA0B9D,CAAC"}

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

@@ -0,0 +1,24 @@
+import { useQuery } from "@tanstack/react-query";
+import { useMemo } from "react";
+/**
+ * Hook to integrate query state with React Query
+ * Combines queryParams with queryState and manages data fetching
+ */
+export const useQueryWithParams = ({ getQueryOptions, queryParams = {}, queryState, enabled = true, }) => {
+    const { filters, sort, order, page, limit } = queryState;
+    const input = useMemo(() => ({
+        ...queryParams,
+        page,
+        limit,
+        sort,
+        order: order ?? undefined,
+        filters,
+    }), [queryParams, page, limit, sort, order, filters]);
+    const queryOptions = useMemo(() => ({
+        ...getQueryOptions(input),
+        placeholderData: (previousData) => previousData,
+        enabled,
+    }), [getQueryOptions, input, enabled]);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return useQuery(queryOptions);
+};

package/dist/src/types.d.ts

@@ -0,0 +1,4 @@
+import type { BackendTRPCRouter } from "@m5kdev/backend/types";
+import type { createTRPCContext } from "@trpc/tanstack-react-query";
+export type UseBackendTRPC = ReturnType<typeof createTRPCContext<BackendTRPCRouter>>["useTRPC"];
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC"}

package/dist/src/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/date.d.ts

@@ -0,0 +1,24 @@
+import type { DateValue, RangeValue } from "@heroui/react";
+import { CalendarDate } from "@internationalized/date";
+import type { QueryFilter } from "@m5kdev/commons/modules/schemas/query.schema";
+/**
+ * Convert CalendarDate to UTC ISO string at midnight UTC
+ */
+export declare const calendarDateToUTC: (date: CalendarDate) => string;
+/**
+ * Convert CalendarDate to UTC ISO string at end of day UTC
+ */
+export declare const calendarDateToUTCEndOfDay: (date: CalendarDate) => string;
+/**
+ * Convert RangeValue<DateValue> to URL string format "startISO,endISO"
+ */
+export declare const rangeToUrlString: (range: RangeValue<DateValue> | null) => string | null;
+/**
+ * Convert URL string "startISO,endISO" to RangeValue<DateValue>
+ */
+export declare const urlStringToRange: (value: string | null) => RangeValue<DateValue> | null;
+/**
+ * Convert date range to QueryFilter format
+ */
+export declare const dateRangeToFilter: (dateRange: RangeValue<DateValue> | null, columnId?: string) => QueryFilter | null;
+//# sourceMappingURL=date.d.ts.map

package/dist/src/utils/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../src/utils/date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAmC,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAGhF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,YAAY,KAAG,MAEtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,MAAM,YAAY,KAAG,MAE9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,UAAU,CAAC,SAAS,CAAC,GAAG,IAAI,KAAG,MAAM,GAAG,IAa/E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,GAAG,IAAI,KAAG,UAAU,CAAC,SAAS,CAAC,GAAG,IAqB/E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,UAAU,CAAC,SAAS,CAAC,GAAG,IAAI,EACvC,iBAAsB,KACrB,WAAW,GAAG,IAkBhB,CAAC"}

package/dist/src/utils/date.js

@@ -0,0 +1,71 @@
+import { CalendarDate, getLocalTimeZone, parseAbsolute } from "@internationalized/date";
+import { DateTime } from "luxon";
+/**
+ * Convert CalendarDate to UTC ISO string at midnight UTC
+ */
+export const calendarDateToUTC = (date) => {
+    return DateTime.utc(date.year, date.month, date.day).toISO() ?? "";
+};
+/**
+ * Convert CalendarDate to UTC ISO string at end of day UTC
+ */
+export const calendarDateToUTCEndOfDay = (date) => {
+    return DateTime.utc(date.year, date.month, date.day).endOf("day").toISO() ?? "";
+};
+/**
+ * Convert RangeValue<DateValue> to URL string format "startISO,endISO"
+ */
+export const rangeToUrlString = (range) => {
+    if (!range || !range.start || !range.end)
+        return null;
+    const start = range.start;
+    const end = range.end;
+    if (!start?.year || !end?.year)
+        return null;
+    // Format as ISO date strings (YYYY-MM-DD)
+    const startISO = `${start.year}-${String(start.month).padStart(2, "0")}-${String(start.day).padStart(2, "0")}`;
+    const endISO = `${end.year}-${String(end.month).padStart(2, "0")}-${String(end.day).padStart(2, "0")}`;
+    return `${startISO},${endISO}`;
+};
+/**
+ * Convert URL string "startISO,endISO" to RangeValue<DateValue>
+ */
+export const urlStringToRange = (value) => {
+    if (!value)
+        return null;
+    const [startISO, endISO] = value.split(",");
+    if (!startISO || !endISO)
+        return null;
+    const tz = getLocalTimeZone();
+    // Parse ISO date strings using parseAbsolute for proper timezone handling
+    const startZoned = parseAbsolute(`${startISO}T00:00:00Z`, tz);
+    const endZoned = parseAbsolute(`${endISO}T00:00:00Z`, tz);
+    if (!startZoned || !endZoned)
+        return null;
+    const startDate = new CalendarDate(startZoned.year, startZoned.month, startZoned.day);
+    const endDate = new CalendarDate(endZoned.year, endZoned.month, endZoned.day);
+    return {
+        start: startDate,
+        end: endDate,
+    };
+};
+/**
+ * Convert date range to QueryFilter format
+ */
+export const dateRangeToFilter = (dateRange, columnId = "startedAt") => {
+    if (!dateRange || !dateRange.start || !dateRange.end)
+        return null;
+    const start = dateRange.start;
+    const end = dateRange.end;
+    if (!start?.year || !end?.year)
+        return null;
+    const startISO = calendarDateToUTC(start);
+    const endISO = calendarDateToUTCEndOfDay(end);
+    return {
+        columnId,
+        type: "date",
+        method: "between",
+        value: startISO,
+        valueTo: endISO,
+    };
+};

package/dist/src/utils/query.d.ts

@@ -0,0 +1,8 @@
+declare class QueryCache {
+    update: <T extends Record<K, any>, A extends string | null = null, K extends string = "id">(element: T | T[], accessor?: A, key?: K) => <D>(data: D) => D;
+    delete: <T extends Record<K, any>, D extends (A extends string ? { [key in A]: T[]; } : T[]) | undefined, A extends string | null = null, K extends string = "id">(element: T | T[], accessor?: A, key?: K) => <OriginalD extends D>(data: OriginalD) => OriginalD;
+    create: <T extends Record<string, any>, D extends (A extends string ? { [key in A]: T[]; } : T[]) | undefined, A extends string | null = null>(element: T | T[], accessor?: A) => <OriginalD extends D>(data: OriginalD) => OriginalD;
+}
+export declare const queryCache: QueryCache;
+export {};
+//# sourceMappingURL=query.d.ts.map

package/dist/src/utils/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/utils/query.ts"],"names":[],"mappings":"AAAA,cAAM,UAAU;IACd,MAAM,GACH,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,SAAS,MAAM,GAAG,IAAI,EAChF,SAAS,CAAC,GAAG,CAAC,EAAE,EAChB,WAAU,CAAa,EACvB,MAAK,CAAa,MAEnB,CAAC,EAAE,MAAM,CAAC,KAAG,CAAC,CAiBb;IAEJ,MAAM,GAEF,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,EACxB,CAAC,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAE,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EACpE,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,IAAI,EAC9B,CAAC,SAAS,MAAM,GAAG,IAAI,EAEvB,SAAS,CAAC,GAAG,CAAC,EAAE,EAChB,WAAU,CAAa,EACvB,MAAK,CAAa,MAEnB,SAAS,SAAS,CAAC,EAAE,MAAM,SAAS,KAAG,SAAS,CAY/C;IAEJ,MAAM,GAEF,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAE,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EACpE,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,IAAI,EAE9B,SAAS,CAAC,GAAG,CAAC,EAAE,EAChB,WAAU,CAAa,MAExB,SAAS,SAAS,CAAC,EAAE,MAAM,SAAS,KAAG,SAAS,CAQ/C;CACL;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/src/utils/query.js

@@ -0,0 +1,46 @@
+class QueryCache {
+    update = (element, accessor = null, key = "id") => (data) => {
+        if (!data)
+            return data;
+        const target = accessor ? data[accessor] : data;
+        if (!Array.isArray(target))
+            return data;
+        const modified = target.map((item) => {
+            const isMatch = Array.isArray(element)
+                ? element.findIndex((el) => el[key] === item[key]) > -1
+                : element[key] === item[key];
+            return isMatch
+                ? {
+                    ...item,
+                    ...(Array.isArray(element) ? element.find((el) => el[key] === item[key]) : element),
+                }
+                : item;
+        });
+        return accessor ? { ...data, [accessor]: modified } : modified;
+    };
+    delete = (element, accessor = null, key = "id") => (data) => {
+        if (!data)
+            return data;
+        const target = (accessor ? data[accessor] : data);
+        if (!Array.isArray(target))
+            return data;
+        const modified = target.filter((item) => Array.isArray(element)
+            ? element.findIndex((el) => el[key] === item[key]) === -1
+            : item[key] !== element[key]);
+        return accessor
+            ? { ...data, [accessor]: modified }
+            : modified;
+    };
+    create = (element, accessor = null) => (data) => {
+        if (!data)
+            return data;
+        const target = (accessor ? data[accessor] : data);
+        if (!target)
+            return data;
+        const modified = [...target, ...(Array.isArray(element) ? element : [element])];
+        return accessor
+            ? { ...data, [accessor]: modified }
+            : modified;
+    };
+}
+export const queryCache = new QueryCache();