@void-snippets/react 0.2.1 → 0.3.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { ResourceAdapters, TQueryParams, TPagination, ResourceListResult } from '@void-snippets/core';
+import { VSAdapters, VSQueryParams, VSPagination, VSListResult } from '@void-snippets/core';
+import { ReactNode } from 'react';
 
-type CapitalizeStr<S extends string> = S extends `${infer F}${infer Rest}` ? `${Uppercase<F>}${Rest}` : S;
 interface WithResourceTypes {
     readonly __types: {
         id: unknown;
@@ -20,21 +20,23 @@ type Create<S extends WithResourceTypes> = S["__types"]["create"];
 type Update<S extends WithResourceTypes> = S["__types"]["update"];
 type ListRaw<S extends WithResourceTypes> = S["__types"]["listRaw"];
 type SingleRaw<S extends WithResourceTypes> = S["__types"]["singleRaw"];
-type UseListReturn<K extends string, TBase> = {
-    [P in K]: TBase[];
-} & {
-    pagination: TPagination;
-} & {
-    [P in `is${CapitalizeStr<K>}Loading`]: boolean;
-} & {
-    [P in `${K}Error`]: Error | null;
-} & {
-    [P in `invalidate${CapitalizeStr<K>}`]: () => void;
-};
-interface CreateResourceHooksOptions<TListRaw, TBase, TSingleRaw, TDetail> {
+interface VSUseListReturn<TBase> {
+    list: TBase[];
+    pagination: VSPagination;
+    isLoading: boolean;
+    error: Error | null;
+    invalidate: () => void;
+}
+interface VSUseGetReturn<TDetail> {
+    item: TDetail | undefined;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+interface VSResourceHooksOptions<TListRaw, TBase, TSingleRaw, TDetail> {
     /**
-     * Adapters map your API's raw response shapes to the library's internal
-     * format. Omit this entirely if your API matches the default shape:
+     * Adapters map your API's raw response to the library's internal format.
+     * Omit if your API matches the default shape:
      * List:   { data: { items, page, limit, totalPages, totalDocuments } }
      * Single: { data: <item> }
      *
@@ -54,54 +56,186 @@ interface CreateResourceHooksOptions<TListRaw, TBase, TSingleRaw, TDetail> {
      *   },
      * })
      */
-    adapters?: ResourceAdapters<TListRaw, TBase, TSingleRaw, TDetail>;
+    adapters?: VSAdapters<TListRaw, TBase, TSingleRaw, TDetail>;
     /**
      * Default params passed to useList and useInfinite when none are provided.
      * @default { page: 1, limit: 10 }
      */
-    defaultParams?: TQueryParams;
+    defaultParams?: VSQueryParams;
 }
 /**
  * Creates a set of TanStack Query hooks for a resource.
- * All types are fully inferred from the `apiService` instance — no generics
- * need to be passed manually.
+ * All types are fully inferred from the `apiService` instance — no generics needed.
  *
- * @param queryKeyPrefix  - TanStack Query cache key prefix and the base name
- *                          for the returned hook properties.
- *                          e.g. "contacts" → { contacts, isContactsLoading, ... }
+ * @param queryKeyPrefix  - TanStack Query cache key. Used to scope the cache
+ *                          and for auto-invalidation. e.g. "contacts"
  * @param apiService      - An instance of ResourceService (or a subclass).
  * @param options         - Optional adapters and default params.
  *
  * @example
- * // contacts.hooks.ts
- * import { createResourceHooks } from '@void-snippets/react';
- * import { ContactsApis } from './contacts.api';
- *
- * // No generics needed — all types are inferred from ContactsApis
  * export const contactHooks = createResourceHooks('contacts', ContactsApis);
  *
- * // In a component:
- * const { contacts, isContactsLoading } = contactHooks.useList();
- * const { data } = contactHooks.useGet(id);  // data: Contact.WithCreatedBy
- * const { create, update, delete: remove } = contactHooks.useMutations();
+ * // useList — generic fixed shape
+ * const { list, isLoading, pagination, error, invalidate } = contactHooks.useList();
+ * // list is typed as Contact.Base[] ✅
+ *
+ * // useGet
+ * const { item, isLoading, error, refetch } = contactHooks.useGet(id);
+ * // item is typed as Contact.WithCreatedBy ✅
+ *
+ * // useMutations
+ * const { create, update, remove } = contactHooks.useMutations();
  */
-declare function createResourceHooks<K extends string, S extends WithResourceTypes>(queryKeyPrefix: K, apiService: S, options?: CreateResourceHooksOptions<ListRaw<S>, Base<S>, SingleRaw<S>, Detail<S>>): {
-    useList: (params?: TQueryParams) => UseListReturn<K, Base<S>>;
-    useGet: (id: Id<S>, staleTime?: number) => {
-        data: _tanstack_react_query.NoInfer<Detail<S>> | undefined;
-        isLoading: boolean;
-        error: Error | null;
-        refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.NoInfer<Detail<S>>, Error>>;
-    };
+declare function createResourceHooks<K extends string, S extends WithResourceTypes>(queryKeyPrefix: K, apiService: S, options?: VSResourceHooksOptions<ListRaw<S>, Base<S>, SingleRaw<S>, Detail<S>>): {
+    useList: (params?: VSQueryParams) => VSUseListReturn<Base<S>>;
+    useGet: (id: Id<S>, staleTime?: number) => VSUseGetReturn<Detail<S>>;
     useMutations: () => {
         create: _tanstack_react_query.UseMutationResult<Detail<S>, Error, Create<S>, unknown>;
         update: _tanstack_react_query.UseMutationResult<Detail<S>, Error, {
             _id: Id<S>;
             payload: Update<S>;
         }, unknown>;
-        delete: _tanstack_react_query.UseMutationResult<Detail<S>, Error, Id<S>, unknown>;
+        remove: _tanstack_react_query.UseMutationResult<Detail<S>, Error, Id<S>, unknown>;
     };
-    useInfinite: (params?: TQueryParams) => _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<ResourceListResult<Base<S>>, unknown>, Error>;
+    useInfinite: (params?: VSQueryParams) => _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<VSListResult<Base<S>>, unknown>, Error>;
 };
 
-export { type CreateResourceHooksOptions, type UseListReturn, createResourceHooks };
+type VSAlertVariant = "success" | "info" | "error";
+interface VSAlertState {
+    message: ReactNode | string;
+    type: VSAlertVariant;
+    isVisible: boolean;
+}
+/**
+ * Manages alert/toast message state with optional auto-hide.
+ *
+ * @param autoHideDuration - ms before alert hides automatically. Pass 0 to disable. Default: 3000
+ *
+ * @example
+ * const { alert, showAlert, hideAlert } = useAlertMessage();
+ * showAlert('Saved successfully!', 'success');
+ * showAlert(<b>Something went wrong</b>, 'error');
+ */
+declare function useAlertMessage(autoHideDuration?: number): {
+    alert: VSAlertState;
+    showAlert: (message: ReactNode | string, type?: VSAlertVariant) => void;
+    hideAlert: () => void;
+};
+
+type VSAsyncStatus = "idle" | "pending" | "success" | "error";
+interface VSAsyncState<T> {
+    data: T | null;
+    status: VSAsyncStatus;
+    error: Error | null;
+}
+interface VSUseAsyncStateReturn<T> extends VSAsyncState<T> {
+    isLoading: boolean;
+    isSuccess: boolean;
+    isError: boolean;
+    setData: (data: T | null) => void;
+    setError: (error: Error | null) => void;
+    reset: () => void;
+    /**
+     * Executes an async function, updates state, and returns a [err, data] tuple.
+     * Allows immediate result handling without try/catch.
+     *
+     * @example
+     * const [err, data] = await execute(() => ContactsApis.create(payload));
+     * if (err) return showAlert(err.message, 'error');
+     * showAlert('Created!', 'success');
+     */
+    execute: (asyncFn: () => Promise<T>, options?: {
+        onSuccess?: (data: T) => void;
+        onError?: (error: Error) => void;
+    }) => Promise<[Error, null] | [null, T]>;
+}
+/**
+ * Generic async state machine — tracks data, status, and error for any async operation.
+ * Pair with any async function: API calls, file reads, timers, etc.
+ *
+ * @param initialData - Optional initial data value. Default: null
+ *
+ * @example
+ * const { data, isLoading, isError, execute } = useAsyncState<User>();
+ *
+ * const handleSubmit = async () => {
+ *   const [err, user] = await execute(() => fetchUser(id));
+ *   if (err) return;
+ *   console.log(user.name);
+ * };
+ */
+declare function useAsyncState<T>(initialData?: T | null): VSUseAsyncStateReturn<T>;
+
+/**
+ * Tracks elapsed time from a given start timestamp — useful for call durations,
+ * countdowns, or any elapsed-time display.
+ *
+ * @param startedAt - Unix timestamp in ms (e.g. Date.now()). Pass null/undefined to reset.
+ * @returns Formatted duration string "MM:SS"
+ *
+ * @example
+ * const duration = useCallTimer(call.startedAt);
+ * // duration → "02:45"
+ *
+ * // Reset when no active call
+ * const duration = useCallTimer(activeCall ? activeCall.startedAt : null);
+ */
+declare function useCallTimer(startedAt?: number | null): string;
+
+interface VSModalReturn<T> {
+    isOpen: boolean;
+    data: T | null;
+    isLoading: boolean;
+    openCreateModal: () => void;
+    openEditModal: (editData: T) => void;
+    setLoading: (loading: boolean) => void;
+    closeModal: () => void;
+    setModal: (open: boolean, editData?: T | null) => void;
+}
+/**
+ * Manages modal open/close state with optional data payload and loading state.
+ * Works for both create and edit modals — pass data to distinguish the mode.
+ *
+ * @typeParam T - The type of data the modal operates on (e.g. a Contact, User, etc.)
+ *
+ * @example
+ * const modal = useModal<Contact.Base>();
+ *
+ * modal.openCreateModal();      // data → null (create mode)
+ * modal.openEditModal(contact); // data → contact (edit mode)
+ *
+ * if (modal.data) {
+ *   // Edit mode — modal.data is Contact.Base
+ * } else {
+ *   // Create mode
+ * }
+ */
+declare function useModal<T = unknown>(): VSModalReturn<T>;
+
+interface VSPaginationReturn {
+    page: number;
+    limit: number;
+    onPaginationChange: (newPage: number, newLimit: number) => void;
+    resetPagination: () => void;
+    setPage: (page: number) => void;
+    setLimit: (limit: number) => void;
+    /** Ready-to-use query params object — pass directly to useList() */
+    queryParams: VSQueryParams;
+}
+/**
+ * Manages pagination state and produces a ready-to-use queryParams object
+ * compatible with createResourceHooks' useList() and useInfinite().
+ *
+ * @param initialPage  - Starting page. Default: 1
+ * @param initialLimit - Items per page. Default: 10
+ *
+ * @example
+ * const { queryParams, onPaginationChange } = usePagination(1, 20);
+ *
+ * const { list, isLoading } = contactHooks.useList(queryParams);
+ *
+ * <Pagination onChange={onPaginationChange} total={pagination.totalDocuments} />
+ */
+declare function usePagination(initialPage?: number, initialLimit?: number): VSPaginationReturn;
+
+export { type VSAlertState, type VSAlertVariant, type VSAsyncStatus, type VSModalReturn, type VSPaginationReturn, type VSResourceHooksOptions, type VSUseAsyncStateReturn, type VSUseGetReturn, type VSUseListReturn, createResourceHooks, useAlertMessage, useAsyncState, useCallTimer, useModal, usePagination };

package/dist/index.js

@@ -20,7 +20,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  createResourceHooks: () => createResourceHooks
+  createResourceHooks: () => createResourceHooks,
+  useAlertMessage: () => useAlertMessage,
+  useAsyncState: () => useAsyncState,
+  useCallTimer: () => useCallTimer,
+  useModal: () => useModal,
+  usePagination: () => usePagination
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -37,40 +42,35 @@ function createResourceHooks(queryKeyPrefix, apiService, options = {}) {
     adapters = (0, import_core.createDefaultAdapters)(),
     defaultParams = DEFAULT_PAGINATION
   } = options;
-  const capitalize = (str) => str.charAt(0).toUpperCase() + str.slice(1);
-  const capPrefix = capitalize(queryKeyPrefix);
   return {
     // -------------------------------------------------------------------------
-    // useList — paginated list with invalidation helper
+    // useList — fixed generic shape: { list, isLoading, pagination, error, invalidate }
     // -------------------------------------------------------------------------
     useList: (params = defaultParams) => {
       var _a, _b, _c, _d, _e;
       const queryClient = (0, import_react_query.useQueryClient)();
-      const queryKey = [queryKeyPrefix, params];
       const query = (0, import_react_query.useQuery)({
-        queryKey,
+        queryKey: [queryKeyPrefix, params],
         queryFn: async () => {
           const raw = await service.list(params);
           return adapters.fromList(raw);
         }
       });
-      const items = (_b = (_a = query.data) == null ? void 0 : _a.items) != null ? _b : [];
-      const pagination = (_e = (_c = query.data) == null ? void 0 : _c.pagination) != null ? _e : {
-        page: 1,
-        limit: (_d = defaultParams.limit) != null ? _d : 10,
-        totalPages: 0,
-        totalDocuments: 0
-      };
       return {
-        [queryKeyPrefix]: items,
-        pagination,
-        [`is${capPrefix}Loading`]: query.isLoading || query.isFetching,
-        [`${queryKeyPrefix}Error`]: query.error,
-        [`invalidate${capPrefix}`]: () => queryClient.invalidateQueries({ queryKey: [queryKeyPrefix] })
+        list: (_b = (_a = query.data) == null ? void 0 : _a.items) != null ? _b : [],
+        pagination: (_e = (_c = query.data) == null ? void 0 : _c.pagination) != null ? _e : {
+          page: 1,
+          limit: (_d = defaultParams.limit) != null ? _d : 10,
+          totalPages: 0,
+          totalDocuments: 0
+        },
+        isLoading: query.isLoading || query.isFetching,
+        error: query.error,
+        invalidate: () => queryClient.invalidateQueries({ queryKey: [queryKeyPrefix] })
       };
     },
     // -------------------------------------------------------------------------
-    // useGet — single item by id
+    // useGet — { item, isLoading, error, refetch }
     // -------------------------------------------------------------------------
     useGet: (id, staleTime = 3e4) => {
       const query = (0, import_react_query.useQuery)({
@@ -83,14 +83,14 @@ function createResourceHooks(queryKeyPrefix, apiService, options = {}) {
         staleTime
       });
       return {
-        data: query.data,
+        item: query.data,
         isLoading: query.isLoading || query.isFetching,
         error: query.error,
         refetch: query.refetch
       };
     },
     // -------------------------------------------------------------------------
-    // useMutations — create / update / delete with auto-invalidation
+    // useMutations — create / update / remove (not delete — reserved keyword)
     // -------------------------------------------------------------------------
     useMutations: () => {
       const queryClient = (0, import_react_query.useQueryClient)();
@@ -109,7 +109,7 @@ function createResourceHooks(queryKeyPrefix, apiService, options = {}) {
         },
         onSuccess: invalidate
       });
-      const deleteMutation = (0, import_react_query.useMutation)({
+      const removeMutation = (0, import_react_query.useMutation)({
         mutationFn: async (_id) => {
           const raw = await service.delete(_id);
           return adapters.fromSingle(raw);
@@ -119,7 +119,7 @@ function createResourceHooks(queryKeyPrefix, apiService, options = {}) {
       return {
         create: createMutation,
         update: updateMutation,
-        delete: deleteMutation
+        remove: removeMutation
       };
     },
     // -------------------------------------------------------------------------
@@ -146,8 +146,166 @@ function createResourceHooks(queryKeyPrefix, apiService, options = {}) {
     }
   };
 }
+
+// src/hooks/useAlertMessage.ts
+var import_react = require("react");
+function useAlertMessage(autoHideDuration = 3e3) {
+  const [alert, setAlert] = (0, import_react.useState)({
+    message: null,
+    type: "info",
+    isVisible: false
+  });
+  const showAlert = (0, import_react.useCallback)(
+    (message, type = "info") => {
+      setAlert({ message, type, isVisible: true });
+      if (autoHideDuration) {
+        setTimeout(() => {
+          setAlert((prev) => ({ ...prev, isVisible: false }));
+        }, autoHideDuration);
+      }
+    },
+    [autoHideDuration]
+  );
+  const hideAlert = (0, import_react.useCallback)(() => {
+    setAlert((prev) => ({ ...prev, isVisible: false }));
+  }, []);
+  return { alert, showAlert, hideAlert };
+}
+
+// src/hooks/useAsyncState.ts
+var import_react2 = require("react");
+var import_core2 = require("@void-snippets/core");
+function useAsyncState(initialData = null) {
+  const [state, setState] = (0, import_react2.useState)({
+    data: initialData,
+    status: "idle",
+    error: null
+  });
+  const setData = (0, import_react2.useCallback)((data) => {
+    setState({ data, status: "success", error: null });
+  }, []);
+  const setError = (0, import_react2.useCallback)((error) => {
+    setState((prev) => ({ ...prev, error, status: "error" }));
+  }, []);
+  const reset = (0, import_react2.useCallback)(() => {
+    setState({ data: initialData, status: "idle", error: null });
+  }, [initialData]);
+  const execute = (0, import_react2.useCallback)(
+    async (asyncFn, options) => {
+      var _a, _b;
+      setState((prev) => ({ ...prev, status: "pending", error: null }));
+      const [err, res] = await (0, import_core2.catchError)(asyncFn());
+      if (err) {
+        setState((prev) => ({ ...prev, status: "error", error: err }));
+        (_a = options == null ? void 0 : options.onError) == null ? void 0 : _a.call(options, err);
+        return [err, null];
+      }
+      setState({ data: res, status: "success", error: null });
+      (_b = options == null ? void 0 : options.onSuccess) == null ? void 0 : _b.call(options, res);
+      return [null, res];
+    },
+    []
+  );
+  const flags = (0, import_react2.useMemo)(
+    () => ({
+      isLoading: state.status === "pending",
+      isSuccess: state.status === "success",
+      isError: state.status === "error"
+    }),
+    [state.status]
+  );
+  return { ...state, ...flags, setData, setError, reset, execute };
+}
+
+// src/hooks/useCallTimer.ts
+var import_react3 = require("react");
+function useCallTimer(startedAt) {
+  const [duration, setDuration] = (0, import_react3.useState)("00:00");
+  (0, import_react3.useEffect)(() => {
+    if (!startedAt) {
+      setDuration("00:00");
+      return;
+    }
+    const interval = setInterval(() => {
+      const diffInSeconds = Math.floor((Date.now() - startedAt) / 1e3);
+      const minutes = Math.floor(diffInSeconds / 60).toString().padStart(2, "0");
+      const seconds = (diffInSeconds % 60).toString().padStart(2, "0");
+      setDuration(`${minutes}:${seconds}`);
+    }, 1e3);
+    return () => clearInterval(interval);
+  }, [startedAt]);
+  return duration;
+}
+
+// src/hooks/useModal.ts
+var import_react4 = require("react");
+function useModal() {
+  const [isOpen, setIsOpen] = (0, import_react4.useState)(false);
+  const [data, setData] = (0, import_react4.useState)(null);
+  const [isLoading, setIsLoading] = (0, import_react4.useState)(false);
+  const openCreateModal = (0, import_react4.useCallback)(() => {
+    setIsOpen(true);
+    setData(null);
+  }, []);
+  const openEditModal = (0, import_react4.useCallback)((editData) => {
+    setIsOpen(true);
+    setData(editData);
+  }, []);
+  const setLoading = (0, import_react4.useCallback)((loading) => {
+    setIsLoading(loading);
+  }, []);
+  const closeModal = (0, import_react4.useCallback)(() => {
+    setIsOpen(false);
+    setData(null);
+  }, []);
+  const setModal = (0, import_react4.useCallback)((open, editData) => {
+    setIsOpen(open);
+    setData(editData != null ? editData : null);
+  }, []);
+  return {
+    isOpen,
+    data,
+    isLoading,
+    openCreateModal,
+    openEditModal,
+    setLoading,
+    closeModal,
+    setModal
+  };
+}
+
+// src/hooks/usePagination.ts
+var import_react5 = require("react");
+function usePagination(initialPage = 1, initialLimit = 10) {
+  const [page, setPage] = (0, import_react5.useState)(initialPage);
+  const [limit, setLimit] = (0, import_react5.useState)(initialLimit);
+  const onPaginationChange = (0, import_react5.useCallback)(
+    (newPage, newLimit) => {
+      setPage(newPage);
+      setLimit(newLimit);
+    },
+    []
+  );
+  const resetPagination = (0, import_react5.useCallback)(() => {
+    setPage(1);
+  }, []);
+  return {
+    page,
+    limit,
+    onPaginationChange,
+    resetPagination,
+    setPage,
+    setLimit,
+    queryParams: { page, limit }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  createResourceHooks
+  createResourceHooks,
+  useAlertMessage,
+  useAsyncState,
+  useCallTimer,
+  useModal,
+  usePagination
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/hooks/createResourceHooks.ts"],"sourcesContent":["export { createResourceHooks } from \"./hooks/createResourceHooks\";\nexport type {\n  UseListReturn,\n  CreateResourceHooksOptions,\n} from \"./hooks/createResourceHooks\";\n","import {\n  useInfiniteQuery,\n  useMutation,\n  useQuery,\n  useQueryClient,\n} from \"@tanstack/react-query\";\nimport type { ResourceService } from \"@void-snippets/client\";\nimport type {\n  ResourceAdapters,\n  ResourceListResult,\n  TPagination,\n  TQueryParams,\n  TDefaultPaginatedResponse,\n  TDefaultSingleResponse,\n} from \"@void-snippets/core\";\nimport { createDefaultAdapters } from \"@void-snippets/core\";\n\n// ============================================================================\n// TYPE HELPERS\n// ============================================================================\n\ntype CapitalizeStr<S extends string> = S extends `${infer F}${infer Rest}`\n  ? `${Uppercase<F>}${Rest}`\n  : S;\n\nconst DEFAULT_PAGINATION: TQueryParams = {\n  page: 1,\n  limit: 10,\n};\n\n// ============================================================================\n// PHANTOM TYPE CONSTRAINT\n//\n// We constrain S only on the __types phantom property (which is readonly,\n// i.e. covariant) so that ResourceService<string, ...> is assignable to\n// WithResourceTypes. This avoids the variance issue that arises when\n// constraining against method parameter types (contravariant positions).\n//\n// Inside the function we cast apiService once to a fully-typed ResourceService\n// using the phantom generics — this is safe because S IS a ResourceService.\n// ============================================================================\n\ninterface WithResourceTypes {\n  readonly __types: {\n    id: unknown;\n    base: unknown;\n    detail: unknown;\n    create: unknown;\n    update: unknown;\n    listRaw: unknown;\n    singleRaw: unknown;\n  };\n}\n\n// Aliases for reading phantom types from S — keeps the function body readable\ntype Id<S extends WithResourceTypes>        = S[\"__types\"][\"id\"];\ntype Base<S extends WithResourceTypes>      = S[\"__types\"][\"base\"];\ntype Detail<S extends WithResourceTypes>    = S[\"__types\"][\"detail\"];\ntype Create<S extends WithResourceTypes>    = S[\"__types\"][\"create\"];\ntype Update<S extends WithResourceTypes>    = S[\"__types\"][\"update\"];\ntype ListRaw<S extends WithResourceTypes>   = S[\"__types\"][\"listRaw\"];\ntype SingleRaw<S extends WithResourceTypes> = S[\"__types\"][\"singleRaw\"];\n\n// ============================================================================\n// RETURN TYPE — useList\n// Dynamically named keys based on the queryKeyPrefix (e.g. \"contacts\"):\n//   { contacts: TBase[], isContactsLoading: boolean, contactsError: Error | null, invalidateContacts: () => void }\n// ============================================================================\n\nexport type UseListReturn<K extends string, TBase> = {\n  [P in K]: TBase[];\n} & {\n  pagination: TPagination;\n} & {\n  [P in `is${CapitalizeStr<K>}Loading`]: boolean;\n} & {\n  [P in `${K}Error`]: Error | null;\n} & {\n  [P in `invalidate${CapitalizeStr<K>}`]: () => void;\n};\n\n// ============================================================================\n// OPTIONS\n// ============================================================================\n\nexport interface CreateResourceHooksOptions<\n  TListRaw,\n  TBase,\n  TSingleRaw,\n  TDetail,\n> {\n  /**\n   * Adapters map your API's raw response shapes to the library's internal\n   * format. Omit this entirely if your API matches the default shape:\n   * List:   { data: { items, page, limit, totalPages, totalDocuments } }\n   * Single: { data: <item> }\n   *\n   * @example\n   * createResourceHooks(\"contacts\", ContactsApis, {\n   *   adapters: {\n   *     fromList: (raw) => ({\n   *       items: raw.results,\n   *       pagination: {\n   *         page: raw.meta.page,\n   *         limit: raw.meta.perPage,\n   *         totalPages: raw.meta.lastPage,\n   *         totalDocuments: raw.meta.total,\n   *       },\n   *     }),\n   *     fromSingle: (raw) => raw.payload,\n   *   },\n   * })\n   */\n  adapters?: ResourceAdapters<TListRaw, TBase, TSingleRaw, TDetail>;\n\n  /**\n   * Default params passed to useList and useInfinite when none are provided.\n   * @default { page: 1, limit: 10 }\n   */\n  defaultParams?: TQueryParams;\n}\n\n// ============================================================================\n// FACTORY\n// ============================================================================\n\n/**\n * Creates a set of TanStack Query hooks for a resource.\n * All types are fully inferred from the `apiService` instance — no generics\n * need to be passed manually.\n *\n * @param queryKeyPrefix  - TanStack Query cache key prefix and the base name\n *                          for the returned hook properties.\n *                          e.g. \"contacts\" → { contacts, isContactsLoading, ... }\n * @param apiService      - An instance of ResourceService (or a subclass).\n * @param options         - Optional adapters and default params.\n *\n * @example\n * // contacts.hooks.ts\n * import { createResourceHooks } from '@void-snippets/react';\n * import { ContactsApis } from './contacts.api';\n *\n * // No generics needed — all types are inferred from ContactsApis\n * export const contactHooks = createResourceHooks('contacts', ContactsApis);\n *\n * // In a component:\n * const { contacts, isContactsLoading } = contactHooks.useList();\n * const { data } = contactHooks.useGet(id);  // data: Contact.WithCreatedBy\n * const { create, update, delete: remove } = contactHooks.useMutations();\n */\nexport function createResourceHooks<\n  K extends string,\n  S extends WithResourceTypes,\n>(\n  queryKeyPrefix: K,\n  apiService: S,\n  options: CreateResourceHooksOptions<\n    ListRaw<S>,\n    Base<S>,\n    SingleRaw<S>,\n    Detail<S>\n  > = {},\n) {\n  // One safe cast: S is guaranteed to be a ResourceService subclass because\n  // __types is only present on ResourceService. Casting here lets us call\n  // the service methods with the correct types extracted from the phantom.\n  const service = apiService as unknown as ResourceService<\n    Id<S>,\n    Base<S>,\n    Detail<S>,\n    Create<S>,\n    Update<S>,\n    ListRaw<S>,\n    SingleRaw<S>\n  >;\n\n  const {\n    adapters = createDefaultAdapters<Base<S>, Detail<S>>() as ResourceAdapters<\n      TDefaultPaginatedResponse<Base<S>>,\n      Base<S>,\n      TDefaultSingleResponse<Detail<S>>,\n      Detail<S>\n    > as ResourceAdapters<ListRaw<S>, Base<S>, SingleRaw<S>, Detail<S>>,\n    defaultParams = DEFAULT_PAGINATION,\n  } = options;\n\n  const capitalize = (str: string) =>\n    str.charAt(0).toUpperCase() + str.slice(1);\n  const capPrefix = capitalize(queryKeyPrefix);\n\n  return {\n    // -------------------------------------------------------------------------\n    // useList — paginated list with invalidation helper\n    // -------------------------------------------------------------------------\n    useList: (\n      params: TQueryParams = defaultParams,\n    ): UseListReturn<K, Base<S>> => {\n      const queryClient = useQueryClient();\n      const queryKey = [queryKeyPrefix, params];\n\n      const query = useQuery<ResourceListResult<Base<S>>, Error>({\n        queryKey,\n        queryFn: async () => {\n          const raw = await service.list(params);\n          return adapters.fromList(raw as ListRaw<S>);\n        },\n      });\n\n      const items = query.data?.items ?? [];\n      const pagination: TPagination = query.data?.pagination ?? {\n        page: 1,\n        limit: defaultParams.limit ?? 10,\n        totalPages: 0,\n        totalDocuments: 0,\n      };\n\n      return {\n        [queryKeyPrefix]: items,\n        pagination,\n        [`is${capPrefix}Loading`]: query.isLoading || query.isFetching,\n        [`${queryKeyPrefix}Error`]: query.error,\n        [`invalidate${capPrefix}`]: () =>\n          queryClient.invalidateQueries({ queryKey: [queryKeyPrefix] }),\n      } as UseListReturn<K, Base<S>>;\n    },\n\n    // -------------------------------------------------------------------------\n    // useGet — single item by id\n    // -------------------------------------------------------------------------\n    useGet: (id: Id<S>, staleTime = 30_000) => {\n      const query = useQuery<Detail<S>, Error>({\n        queryKey: [queryKeyPrefix, id],\n        queryFn: async () => {\n          const raw = await service.get(id);\n          return adapters.fromSingle(raw as SingleRaw<S>);\n        },\n        enabled: id !== undefined && id !== null && id !== \"\",\n        staleTime,\n      });\n\n      return {\n        data: query.data,\n        isLoading: query.isLoading || query.isFetching,\n        error: query.error,\n        refetch: query.refetch,\n      };\n    },\n\n    // -------------------------------------------------------------------------\n    // useMutations — create / update / delete with auto-invalidation\n    // -------------------------------------------------------------------------\n    useMutations: () => {\n      const queryClient = useQueryClient();\n      const invalidate = () =>\n        queryClient.invalidateQueries({ queryKey: [queryKeyPrefix] });\n\n      const createMutation = useMutation<Detail<S>, Error, Create<S>>({\n        mutationFn: async (payload) => {\n          const raw = await service.create(payload);\n          return adapters.fromSingle(raw as SingleRaw<S>);\n        },\n        onSuccess: invalidate,\n      });\n\n      const updateMutation = useMutation<\n        Detail<S>,\n        Error,\n        { _id: Id<S>; payload: Update<S> }\n      >({\n        mutationFn: async ({ _id, payload }) => {\n          const raw = await service.update(_id, payload);\n          return adapters.fromSingle(raw as SingleRaw<S>);\n        },\n        onSuccess: invalidate,\n      });\n\n      const deleteMutation = useMutation<Detail<S>, Error, Id<S>>({\n        mutationFn: async (_id) => {\n          const raw = await service.delete(_id);\n          return adapters.fromSingle(raw as SingleRaw<S>);\n        },\n        onSuccess: invalidate,\n      });\n\n      return {\n        create: createMutation,\n        update: updateMutation,\n        delete: deleteMutation,\n      };\n    },\n\n    // -------------------------------------------------------------------------\n    // useInfinite — infinite scroll / load more\n    // -------------------------------------------------------------------------\n    useInfinite: (params: TQueryParams = defaultParams) => {\n      return useInfiniteQuery<ResourceListResult<Base<S>>, Error>({\n        queryKey: [queryKeyPrefix, \"INFINITE\", params],\n        queryFn: async ({ pageParam }) => {\n          const raw = await service.list({\n            ...params,\n            page: pageParam as number,\n            limit: params.limit ?? 20,\n          });\n          return adapters.fromList(raw as ListRaw<S>);\n        },\n        getNextPageParam: (lastPage) => {\n          const { page, totalPages } = lastPage.pagination;\n          return page < totalPages ? page + 1 : undefined;\n        },\n        initialPageParam: 1,\n      });\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/hooks/createResourceHooks.ts","../src/hooks/useAlertMessage.ts","../src/hooks/useAsyncState.ts","../src/hooks/useCallTimer.ts","../src/hooks/useModal.ts","../src/hooks/usePagination.ts"],"sourcesContent":["// Resource hooks factory\nexport { createResourceHooks } from \"./hooks/createResourceHooks\";\nexport type {\n  VSUseListReturn,\n  VSUseGetReturn,\n  VSResourceHooksOptions,\n} from \"./hooks/createResourceHooks\";\n\n// General-purpose React hooks\nexport { useAlertMessage } from \"./hooks/useAlertMessage\";\nexport type { VSAlertVariant, VSAlertState } from \"./hooks/useAlertMessage\";\n\nexport { useAsyncState } from \"./hooks/useAsyncState\";\nexport type {\n  VSAsyncStatus,\n  VSUseAsyncStateReturn,\n} from \"./hooks/useAsyncState\";\n\nexport { useCallTimer } from \"./hooks/useCallTimer\";\n\nexport { useModal } from \"./hooks/useModal\";\nexport type { VSModalReturn } from \"./hooks/useModal\";\n\nexport { usePagination } from \"./hooks/usePagination\";\nexport type { VSPaginationReturn } from \"./hooks/usePagination\";\n","import {\n  useInfiniteQuery,\n  useMutation,\n  useQuery,\n  useQueryClient,\n} from \"@tanstack/react-query\";\nimport type { ResourceService } from \"@void-snippets/client\";\nimport type {\n  VSAdapters,\n  VSListResult,\n  VSPagination,\n  VSQueryParams,\n  VSDefaultPaginatedResponse,\n  VSDefaultSingleResponse,\n} from \"@void-snippets/core\";\nimport { createDefaultAdapters } from \"@void-snippets/core\";\n\n// ============================================================================\n// TYPE HELPERS\n// ============================================================================\n\nconst DEFAULT_PAGINATION: VSQueryParams = {\n  page: 1,\n  limit: 10,\n};\n\n// ============================================================================\n// PHANTOM TYPE CONSTRAINT\n//\n// We constrain S only on the __types phantom property (readonly = covariant)\n// so ResourceService<string, ...> is always assignable to WithResourceTypes.\n// This avoids the variance issue from constraining method parameter types.\n// ============================================================================\n\ninterface WithResourceTypes {\n  readonly __types: {\n    id: unknown;\n    base: unknown;\n    detail: unknown;\n    create: unknown;\n    update: unknown;\n    listRaw: unknown;\n    singleRaw: unknown;\n  };\n}\n\ntype Id<S extends WithResourceTypes>        = S[\"__types\"][\"id\"];\ntype Base<S extends WithResourceTypes>      = S[\"__types\"][\"base\"];\ntype Detail<S extends WithResourceTypes>    = S[\"__types\"][\"detail\"];\ntype Create<S extends WithResourceTypes>    = S[\"__types\"][\"create\"];\ntype Update<S extends WithResourceTypes>    = S[\"__types\"][\"update\"];\ntype ListRaw<S extends WithResourceTypes>   = S[\"__types\"][\"listRaw\"];\ntype SingleRaw<S extends WithResourceTypes> = S[\"__types\"][\"singleRaw\"];\n\n// ============================================================================\n// RETURN TYPES\n// ============================================================================\n\nexport interface VSUseListReturn<TBase> {\n  list: TBase[];\n  pagination: VSPagination;\n  isLoading: boolean;\n  error: Error | null;\n  invalidate: () => void;\n}\n\nexport interface VSUseGetReturn<TDetail> {\n  item: TDetail | undefined;\n  isLoading: boolean;\n  error: Error | null;\n  refetch: () => void;\n}\n\n// ============================================================================\n// OPTIONS\n// ============================================================================\n\nexport interface VSResourceHooksOptions<TListRaw, TBase, TSingleRaw, TDetail> {\n  /**\n   * Adapters map your API's raw response to the library's internal format.\n   * Omit if your API matches the default shape:\n   * List:   { data: { items, page, limit, totalPages, totalDocuments } }\n   * Single: { data: <item> }\n   *\n   * @example\n   * createResourceHooks(\"contacts\", ContactsApis, {\n   *   adapters: {\n   *     fromList: (raw) => ({\n   *       items: raw.results,\n   *       pagination: {\n   *         page: raw.meta.page,\n   *         limit: raw.meta.perPage,\n   *         totalPages: raw.meta.lastPage,\n   *         totalDocuments: raw.meta.total,\n   *       },\n   *     }),\n   *     fromSingle: (raw) => raw.payload,\n   *   },\n   * })\n   */\n  adapters?: VSAdapters<TListRaw, TBase, TSingleRaw, TDetail>;\n\n  /**\n   * Default params passed to useList and useInfinite when none are provided.\n   * @default { page: 1, limit: 10 }\n   */\n  defaultParams?: VSQueryParams;\n}\n\n// ============================================================================\n// FACTORY\n// ============================================================================\n\n/**\n * Creates a set of TanStack Query hooks for a resource.\n * All types are fully inferred from the `apiService` instance — no generics needed.\n *\n * @param queryKeyPrefix  - TanStack Query cache key. Used to scope the cache\n *                          and for auto-invalidation. e.g. \"contacts\"\n * @param apiService      - An instance of ResourceService (or a subclass).\n * @param options         - Optional adapters and default params.\n *\n * @example\n * export const contactHooks = createResourceHooks('contacts', ContactsApis);\n *\n * // useList — generic fixed shape\n * const { list, isLoading, pagination, error, invalidate } = contactHooks.useList();\n * // list is typed as Contact.Base[] ✅\n *\n * // useGet\n * const { item, isLoading, error, refetch } = contactHooks.useGet(id);\n * // item is typed as Contact.WithCreatedBy ✅\n *\n * // useMutations\n * const { create, update, remove } = contactHooks.useMutations();\n */\nexport function createResourceHooks<\n  K extends string,\n  S extends WithResourceTypes,\n>(\n  queryKeyPrefix: K,\n  apiService: S,\n  options: VSResourceHooksOptions<\n    ListRaw<S>,\n    Base<S>,\n    SingleRaw<S>,\n    Detail<S>\n  > = {},\n) {\n  const service = apiService as unknown as ResourceService<\n    Id<S>, Base<S>, Detail<S>, Create<S>, Update<S>, ListRaw<S>, SingleRaw<S>\n  >;\n\n  const {\n    adapters = createDefaultAdapters<Base<S>, Detail<S>>() as VSAdapters<\n      VSDefaultPaginatedResponse<Base<S>>,\n      Base<S>,\n      VSDefaultSingleResponse<Detail<S>>,\n      Detail<S>\n    > as VSAdapters<ListRaw<S>, Base<S>, SingleRaw<S>, Detail<S>>,\n    defaultParams = DEFAULT_PAGINATION,\n  } = options;\n\n  return {\n    // -------------------------------------------------------------------------\n    // useList — fixed generic shape: { list, isLoading, pagination, error, invalidate }\n    // -------------------------------------------------------------------------\n    useList: (\n      params: VSQueryParams = defaultParams,\n    ): VSUseListReturn<Base<S>> => {\n      const queryClient = useQueryClient();\n\n      const query = useQuery<VSListResult<Base<S>>, Error>({\n        queryKey: [queryKeyPrefix, params],\n        queryFn: async () => {\n          const raw = await service.list(params);\n          return adapters.fromList(raw as ListRaw<S>);\n        },\n      });\n\n      return {\n        list: query.data?.items ?? [],\n        pagination: query.data?.pagination ?? {\n          page: 1,\n          limit: defaultParams.limit ?? 10,\n          totalPages: 0,\n          totalDocuments: 0,\n        },\n        isLoading: query.isLoading || query.isFetching,\n        error: query.error,\n        invalidate: () =>\n          queryClient.invalidateQueries({ queryKey: [queryKeyPrefix] }),\n      };\n    },\n\n    // -------------------------------------------------------------------------\n    // useGet — { item, isLoading, error, refetch }\n    // -------------------------------------------------------------------------\n    useGet: (id: Id<S>, staleTime = 30_000): VSUseGetReturn<Detail<S>> => {\n      const query = useQuery<Detail<S>, Error>({\n        queryKey: [queryKeyPrefix, id],\n        queryFn: async () => {\n          const raw = await service.get(id);\n          return adapters.fromSingle(raw as SingleRaw<S>);\n        },\n        enabled: id !== undefined && id !== null && id !== \"\",\n        staleTime,\n      });\n\n      return {\n        item: query.data,\n        isLoading: query.isLoading || query.isFetching,\n        error: query.error,\n        refetch: query.refetch,\n      };\n    },\n\n    // -------------------------------------------------------------------------\n    // useMutations — create / update / remove (not delete — reserved keyword)\n    // -------------------------------------------------------------------------\n    useMutations: () => {\n      const queryClient = useQueryClient();\n      const invalidate = () =>\n        queryClient.invalidateQueries({ queryKey: [queryKeyPrefix] });\n\n      const createMutation = useMutation<Detail<S>, Error, Create<S>>({\n        mutationFn: async (payload) => {\n          const raw = await service.create(payload);\n          return adapters.fromSingle(raw as SingleRaw<S>);\n        },\n        onSuccess: invalidate,\n      });\n\n      const updateMutation = useMutation<\n        Detail<S>,\n        Error,\n        { _id: Id<S>; payload: Update<S> }\n      >({\n        mutationFn: async ({ _id, payload }) => {\n          const raw = await service.update(_id, payload);\n          return adapters.fromSingle(raw as SingleRaw<S>);\n        },\n        onSuccess: invalidate,\n      });\n\n      const removeMutation = useMutation<Detail<S>, Error, Id<S>>({\n        mutationFn: async (_id) => {\n          const raw = await service.delete(_id);\n          return adapters.fromSingle(raw as SingleRaw<S>);\n        },\n        onSuccess: invalidate,\n      });\n\n      return {\n        create: createMutation,\n        update: updateMutation,\n        remove: removeMutation,\n      };\n    },\n\n    // -------------------------------------------------------------------------\n    // useInfinite — infinite scroll / load more\n    // -------------------------------------------------------------------------\n    useInfinite: (params: VSQueryParams = defaultParams) => {\n      return useInfiniteQuery<VSListResult<Base<S>>, Error>({\n        queryKey: [queryKeyPrefix, \"INFINITE\", params],\n        queryFn: async ({ pageParam }) => {\n          const raw = await service.list({\n            ...params,\n            page: pageParam as number,\n            limit: params.limit ?? 20,\n          });\n          return adapters.fromList(raw as ListRaw<S>);\n        },\n        getNextPageParam: (lastPage) => {\n          const { page, totalPages } = lastPage.pagination;\n          return page < totalPages ? page + 1 : undefined;\n        },\n        initialPageParam: 1,\n      });\n    },\n  };\n}\n","import { type ReactNode, useCallback, useState } from \"react\";\n\nexport type VSAlertVariant = \"success\" | \"info\" | \"error\";\n\nexport interface VSAlertState {\n  message: ReactNode | string;\n  type: VSAlertVariant;\n  isVisible: boolean;\n}\n\n/**\n * Manages alert/toast message state with optional auto-hide.\n *\n * @param autoHideDuration - ms before alert hides automatically. Pass 0 to disable. Default: 3000\n *\n * @example\n * const { alert, showAlert, hideAlert } = useAlertMessage();\n * showAlert('Saved successfully!', 'success');\n * showAlert(<b>Something went wrong</b>, 'error');\n */\nexport function useAlertMessage(autoHideDuration = 3000) {\n  const [alert, setAlert] = useState<VSAlertState>({\n    message: null,\n    type: \"info\",\n    isVisible: false,\n  });\n\n  const showAlert = useCallback(\n    (message: ReactNode | string, type: VSAlertVariant = \"info\") => {\n      setAlert({ message, type, isVisible: true });\n      if (autoHideDuration) {\n        setTimeout(() => {\n          setAlert((prev) => ({ ...prev, isVisible: false }));\n        }, autoHideDuration);\n      }\n    },\n    [autoHideDuration]\n  );\n\n  const hideAlert = useCallback(() => {\n    setAlert((prev) => ({ ...prev, isVisible: false }));\n  }, []);\n\n  return { alert, showAlert, hideAlert };\n}\n","import { useCallback, useMemo, useState } from \"react\";\nimport { catchError } from \"@void-snippets/core\";\n\nexport type VSAsyncStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\ninterface VSAsyncState<T> {\n  data: T | null;\n  status: VSAsyncStatus;\n  error: Error | null;\n}\n\nexport interface VSUseAsyncStateReturn<T> extends VSAsyncState<T> {\n  isLoading: boolean;\n  isSuccess: boolean;\n  isError: boolean;\n\n  setData: (data: T | null) => void;\n  setError: (error: Error | null) => void;\n  reset: () => void;\n\n  /**\n   * Executes an async function, updates state, and returns a [err, data] tuple.\n   * Allows immediate result handling without try/catch.\n   *\n   * @example\n   * const [err, data] = await execute(() => ContactsApis.create(payload));\n   * if (err) return showAlert(err.message, 'error');\n   * showAlert('Created!', 'success');\n   */\n  execute: (\n    asyncFn: () => Promise<T>,\n    options?: {\n      onSuccess?: (data: T) => void;\n      onError?: (error: Error) => void;\n    }\n  ) => Promise<[Error, null] | [null, T]>;\n}\n\n/**\n * Generic async state machine — tracks data, status, and error for any async operation.\n * Pair with any async function: API calls, file reads, timers, etc.\n *\n * @param initialData - Optional initial data value. Default: null\n *\n * @example\n * const { data, isLoading, isError, execute } = useAsyncState<User>();\n *\n * const handleSubmit = async () => {\n *   const [err, user] = await execute(() => fetchUser(id));\n *   if (err) return;\n *   console.log(user.name);\n * };\n */\nexport function useAsyncState<T>(\n  initialData: T | null = null\n): VSUseAsyncStateReturn<T> {\n  const [state, setState] = useState<VSAsyncState<T>>({\n    data: initialData,\n    status: \"idle\",\n    error: null,\n  });\n\n  const setData = useCallback((data: T | null) => {\n    setState({ data, status: \"success\", error: null });\n  }, []);\n\n  const setError = useCallback((error: Error | null) => {\n    setState((prev) => ({ ...prev, error, status: \"error\" }));\n  }, []);\n\n  const reset = useCallback(() => {\n    setState({ data: initialData, status: \"idle\", error: null });\n  }, [initialData]);\n\n  const execute = useCallback(\n    async (\n      asyncFn: () => Promise<T>,\n      options?: {\n        onSuccess?: (data: T) => void;\n        onError?: (error: Error) => void;\n      }\n    ): Promise<[Error, null] | [null, T]> => {\n      setState((prev) => ({ ...prev, status: \"pending\", error: null }));\n\n      const [err, res] = await catchError(asyncFn());\n\n      if (err) {\n        setState((prev) => ({ ...prev, status: \"error\", error: err }));\n        options?.onError?.(err);\n        return [err, null];\n      }\n\n      setState({ data: res as T, status: \"success\", error: null });\n      options?.onSuccess?.(res as T);\n      return [null, res as T];\n    },\n    []\n  );\n\n  const flags = useMemo(\n    () => ({\n      isLoading: state.status === \"pending\",\n      isSuccess: state.status === \"success\",\n      isError: state.status === \"error\",\n    }),\n    [state.status]\n  );\n\n  return { ...state, ...flags, setData, setError, reset, execute };\n}\n","import { useEffect, useState } from \"react\";\n\n/**\n * Tracks elapsed time from a given start timestamp — useful for call durations,\n * countdowns, or any elapsed-time display.\n *\n * @param startedAt - Unix timestamp in ms (e.g. Date.now()). Pass null/undefined to reset.\n * @returns Formatted duration string \"MM:SS\"\n *\n * @example\n * const duration = useCallTimer(call.startedAt);\n * // duration → \"02:45\"\n *\n * // Reset when no active call\n * const duration = useCallTimer(activeCall ? activeCall.startedAt : null);\n */\nexport function useCallTimer(startedAt?: number | null): string {\n  const [duration, setDuration] = useState(\"00:00\");\n\n  useEffect(() => {\n    if (!startedAt) {\n      setDuration(\"00:00\");\n      return;\n    }\n\n    const interval = setInterval(() => {\n      const diffInSeconds = Math.floor((Date.now() - startedAt) / 1000);\n      const minutes = Math.floor(diffInSeconds / 60).toString().padStart(2, \"0\");\n      const seconds = (diffInSeconds % 60).toString().padStart(2, \"0\");\n      setDuration(`${minutes}:${seconds}`);\n    }, 1000);\n\n    return () => clearInterval(interval);\n  }, [startedAt]);\n\n  return duration;\n}\n","import { useCallback, useState } from \"react\";\n\nexport interface VSModalReturn<T> {\n  isOpen: boolean;\n  data: T | null;\n  isLoading: boolean;\n  openCreateModal: () => void;\n  openEditModal: (editData: T) => void;\n  setLoading: (loading: boolean) => void;\n  closeModal: () => void;\n  setModal: (open: boolean, editData?: T | null) => void;\n}\n\n/**\n * Manages modal open/close state with optional data payload and loading state.\n * Works for both create and edit modals — pass data to distinguish the mode.\n *\n * @typeParam T - The type of data the modal operates on (e.g. a Contact, User, etc.)\n *\n * @example\n * const modal = useModal<Contact.Base>();\n *\n * modal.openCreateModal();      // data → null (create mode)\n * modal.openEditModal(contact); // data → contact (edit mode)\n *\n * if (modal.data) {\n *   // Edit mode — modal.data is Contact.Base\n * } else {\n *   // Create mode\n * }\n */\nexport function useModal<T = unknown>(): VSModalReturn<T> {\n  const [isOpen, setIsOpen] = useState(false);\n  const [data, setData] = useState<T | null>(null);\n  const [isLoading, setIsLoading] = useState(false);\n\n  const openCreateModal = useCallback(() => {\n    setIsOpen(true);\n    setData(null);\n  }, []);\n\n  const openEditModal = useCallback((editData: T) => {\n    setIsOpen(true);\n    setData(editData);\n  }, []);\n\n  const setLoading = useCallback((loading: boolean) => {\n    setIsLoading(loading);\n  }, []);\n\n  const closeModal = useCallback(() => {\n    setIsOpen(false);\n    setData(null);\n  }, []);\n\n  const setModal = useCallback((open: boolean, editData?: T | null) => {\n    setIsOpen(open);\n    setData(editData ?? null);\n  }, []);\n\n  return {\n    isOpen,\n    data,\n    isLoading,\n    openCreateModal,\n    openEditModal,\n    setLoading,\n    closeModal,\n    setModal,\n  };\n}\n","import { useCallback, useState } from \"react\";\nimport type { VSQueryParams } from \"@void-snippets/core\";\n\nexport interface VSPaginationReturn {\n  page: number;\n  limit: number;\n  onPaginationChange: (newPage: number, newLimit: number) => void;\n  resetPagination: () => void;\n  setPage: (page: number) => void;\n  setLimit: (limit: number) => void;\n  /** Ready-to-use query params object — pass directly to useList() */\n  queryParams: VSQueryParams;\n}\n\n/**\n * Manages pagination state and produces a ready-to-use queryParams object\n * compatible with createResourceHooks' useList() and useInfinite().\n *\n * @param initialPage  - Starting page. Default: 1\n * @param initialLimit - Items per page. Default: 10\n *\n * @example\n * const { queryParams, onPaginationChange } = usePagination(1, 20);\n *\n * const { list, isLoading } = contactHooks.useList(queryParams);\n *\n * <Pagination onChange={onPaginationChange} total={pagination.totalDocuments} />\n */\nexport function usePagination(\n  initialPage = 1,\n  initialLimit = 10\n): VSPaginationReturn {\n  const [page, setPage] = useState(initialPage);\n  const [limit, setLimit] = useState(initialLimit);\n\n  const onPaginationChange = useCallback(\n    (newPage: number, newLimit: number) => {\n      setPage(newPage);\n      setLimit(newLimit);\n    },\n    []\n  );\n\n  const resetPagination = useCallback(() => {\n    setPage(1);\n  }, []);\n\n  return {\n    page,\n    limit,\n    onPaginationChange,\n    resetPagination,\n    setPage,\n    setLimit,\n    queryParams: { page, limit },\n  };\n}\n"],"mappings":"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","names":["import_react","import_core","import_react","import_react","import_react"]}