@startsimpli/hooks 0.1.1

package/dist/index.mjs

@@ -0,0 +1,384 @@
+import { useState, useCallback, useEffect } from 'react';
+import { useQueryClient, useMutation } from '@tanstack/react-query';
+
+// src/useTableFilters.ts
+function useTableFilters(initial) {
+  const defaultFilters = {
+    page: 1,
+    pageSize: 20,
+    ...initial
+  };
+  const [filters, setFilters] = useState(defaultFilters);
+  const setFilter = useCallback((key, value) => {
+    setFilters((prev) => ({ ...prev, [key]: value, page: 1 }));
+  }, []);
+  const setPage = useCallback((page) => {
+    setFilters((prev) => ({ ...prev, page }));
+  }, []);
+  const setPageSize = useCallback((pageSize) => {
+    setFilters((prev) => ({ ...prev, pageSize, page: 1 }));
+  }, []);
+  const setSearch = useCallback((search) => {
+    setFilters((prev) => ({ ...prev, search, page: 1 }));
+  }, []);
+  const setSort = useCallback((field, direction) => {
+    setFilters((prev) => ({ ...prev, sortField: field, sortDirection: direction }));
+  }, []);
+  const resetFilters = useCallback(() => {
+    setFilters(defaultFilters);
+  }, []);
+  return {
+    filters,
+    setFilter,
+    setPage,
+    setPageSize,
+    setSearch,
+    setSort,
+    resetFilters
+  };
+}
+
+// src/filter-encoding.ts
+function encodeFilterConfig(config) {
+  const json = JSON.stringify(config);
+  return btoa(json).replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
+}
+function decodeFilterConfig(encoded) {
+  try {
+    const standardBase64 = encoded.replace(/-/g, "+").replace(/_/g, "/");
+    const padded = standardBase64 + "===".slice(0, (4 - standardBase64.length % 4) % 4);
+    const decoded = atob(padded);
+    return JSON.parse(decoded);
+  } catch {
+    return null;
+  }
+}
+function parseUrlFilters(params) {
+  const result = {};
+  if (params.has("f")) result.f = params.get("f");
+  if (params.has("s")) result.s = params.get("s");
+  if (params.has("d")) result.d = params.get("d");
+  if (params.has("p")) {
+    const page = parseInt(params.get("p"), 10);
+    if (!isNaN(page) && page > 0) result.p = page;
+  }
+  if (params.has("l")) {
+    const limit = parseInt(params.get("l"), 10);
+    if (!isNaN(limit) && limit > 0 && limit <= 1e3) result.l = limit;
+  }
+  return result;
+}
+function createSimpleFilter(field, operator, value) {
+  return {
+    groups: [{ logic: "AND", conditions: [{ field, operator, value }] }],
+    globalLogic: "AND"
+  };
+}
+function mergeFilters(...configs) {
+  if (configs.length === 0) return { groups: [] };
+  if (configs.length === 1) return configs[0];
+  return {
+    groups: configs.map((config) => ({
+      logic: "AND",
+      conditions: [],
+      groups: config.groups
+    })),
+    globalLogic: "AND"
+  };
+}
+function getFilterDescription(config) {
+  if (config.groups.length === 0) return "No filters applied";
+  function describeGroup(group) {
+    const conditionDescs = group.conditions.map(
+      (c) => `${c.field} ${c.operator} ${c.value}`
+    );
+    const groupDescs2 = group.groups?.map((g) => `(${describeGroup(g)})`) ?? [];
+    return [...conditionDescs, ...groupDescs2].join(` ${group.logic} `);
+  }
+  const groupDescs = config.groups.map(describeGroup);
+  return groupDescs.join(` ${config.globalLogic ?? "AND"} `);
+}
+function useCRUDMutation(mutationFn, opts) {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn,
+    onSuccess: (data, variables) => {
+      for (const key of opts.invalidateKeys) {
+        queryClient.invalidateQueries({ queryKey: key });
+      }
+      opts.onSuccess?.(data, variables);
+    },
+    onError: opts.onError
+  });
+}
+function useSavedViews({
+  resource,
+  loadFn,
+  saveFn,
+  updateFn,
+  deleteFn
+}) {
+  const [state, setState] = useState({
+    views: [],
+    currentViewId: null,
+    loading: true,
+    error: null
+  });
+  const fetchViews = useCallback(async () => {
+    setState((prev) => ({ ...prev, loading: true, error: null }));
+    try {
+      const views = await loadFn(resource);
+      const defaultView = views.find((v) => v.isDefault);
+      setState((prev) => ({
+        ...prev,
+        views,
+        currentViewId: defaultView?.id || null,
+        loading: false
+      }));
+    } catch (error) {
+      setState((prev) => ({
+        ...prev,
+        loading: false,
+        error: error instanceof Error ? error.message : "Failed to load views"
+      }));
+    }
+  }, [resource, loadFn]);
+  useEffect(() => {
+    fetchViews();
+  }, [fetchViews]);
+  const saveView = useCallback(
+    async (viewData) => {
+      const newView = await saveFn(resource, viewData);
+      setState((prev) => ({
+        ...prev,
+        views: [...prev.views, newView],
+        currentViewId: newView.id
+      }));
+      return newView;
+    },
+    [resource, saveFn]
+  );
+  const updateView = useCallback(
+    async (viewId, updates) => {
+      await updateFn(resource, viewId, updates);
+      await fetchViews();
+    },
+    [resource, updateFn, fetchViews]
+  );
+  const deleteView = useCallback(
+    async (viewId) => {
+      await deleteFn(resource, viewId);
+      setState((prev) => ({
+        ...prev,
+        views: prev.views.filter((v) => v.id !== viewId),
+        currentViewId: prev.currentViewId === viewId ? null : prev.currentViewId
+      }));
+    },
+    [resource, deleteFn]
+  );
+  const loadView = useCallback((viewId) => {
+    setState((prev) => ({ ...prev, currentViewId: viewId }));
+  }, []);
+  const getCurrentView = useCallback(() => {
+    return state.views.find((v) => v.id === state.currentViewId) || null;
+  }, [state.views, state.currentViewId]);
+  return {
+    views: state.views,
+    currentViewId: state.currentViewId,
+    loading: state.loading,
+    error: state.error,
+    saveView,
+    updateView,
+    deleteView,
+    loadView,
+    getCurrentView,
+    refreshViews: fetchViews
+  };
+}
+function useRecentlyViewed(storageKey, maxItems = 5) {
+  const [items, setItems] = useState([]);
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    try {
+      const raw = localStorage.getItem(storageKey);
+      if (raw) {
+        setItems(JSON.parse(raw));
+      }
+    } catch {
+    }
+  }, [storageKey]);
+  const persist = useCallback(
+    (updated) => {
+      if (typeof window === "undefined") return;
+      try {
+        localStorage.setItem(storageKey, JSON.stringify(updated));
+      } catch {
+      }
+    },
+    [storageKey]
+  );
+  const trackView = useCallback(
+    (item) => {
+      setItems((prev) => {
+        const deduped = prev.filter((entry) => entry.item.id !== item.id);
+        const updated = [{ item, viewedAt: Date.now() }, ...deduped].slice(0, maxItems);
+        persist(updated);
+        return updated;
+      });
+    },
+    [maxItems, persist]
+  );
+  const clear = useCallback(() => {
+    setItems([]);
+    if (typeof window === "undefined") return;
+    try {
+      localStorage.removeItem(storageKey);
+    } catch {
+    }
+  }, [storageKey]);
+  return {
+    items: items.map((entry) => entry.item),
+    timestamps: items.map((entry) => ({ id: entry.item.id, viewedAt: entry.viewedAt })),
+    trackView,
+    clear
+  };
+}
+function useWizard(steps, initialStep) {
+  const [currentStep, setCurrentStep] = useState(initialStep ?? steps[0]);
+  const stepIndex = steps.indexOf(currentStep);
+  const totalSteps = steps.length;
+  const isFirstStep = stepIndex === 0;
+  const isLastStep = stepIndex === totalSteps - 1;
+  const goTo = useCallback(
+    (step) => {
+      if (steps.includes(step)) setCurrentStep(step);
+    },
+    [steps]
+  );
+  const next = useCallback(() => {
+    if (!isLastStep) setCurrentStep(steps[stepIndex + 1]);
+  }, [isLastStep, stepIndex, steps]);
+  const prev = useCallback(() => {
+    if (!isFirstStep) setCurrentStep(steps[stepIndex - 1]);
+  }, [isFirstStep, stepIndex, steps]);
+  const reset = useCallback(() => {
+    setCurrentStep(initialStep ?? steps[0]);
+  }, [initialStep, steps]);
+  return {
+    currentStep,
+    stepIndex,
+    totalSteps,
+    isFirstStep,
+    isLastStep,
+    canGoBack: !isFirstStep,
+    canGoNext: !isLastStep,
+    goTo,
+    next,
+    prev,
+    reset
+  };
+}
+function useCSVImport({
+  previewFn,
+  importFn,
+  onSuccess
+}) {
+  const [step, setStep] = useState("upload");
+  const [file, setFile] = useState(null);
+  const [preview, setPreview] = useState(null);
+  const [mappings, setMappings] = useState([]);
+  const [result, setResult] = useState(null);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const handleFileSelect = useCallback(
+    async (selectedFile) => {
+      setFile(selectedFile);
+      setError(null);
+      setIsLoading(true);
+      try {
+        const previewData = await previewFn(selectedFile);
+        setPreview(previewData);
+        setMappings(previewData.suggested_mappings ?? []);
+        setStep("mapping");
+      } catch {
+        setError("Failed to preview CSV file");
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [previewFn]
+  );
+  const updateMapping = useCallback((csvColumn, targetField) => {
+    setMappings((prev) => {
+      const existing = prev.find((m) => m.csv_column === csvColumn);
+      if (existing) {
+        return prev.map(
+          (m) => m.csv_column === csvColumn ? { ...m, target_field: targetField } : m
+        );
+      }
+      return [...prev, { csv_column: csvColumn, target_field: targetField }];
+    });
+  }, []);
+  const startImport = useCallback(async () => {
+    if (!file) return;
+    setStep("importing");
+    setError(null);
+    try {
+      const importResult = await importFn(file, mappings);
+      setResult(importResult);
+      setStep("complete");
+      onSuccess?.(importResult);
+    } catch {
+      setError("Failed to import CSV");
+      setStep("mapping");
+    }
+  }, [file, mappings, importFn, onSuccess]);
+  const reset = useCallback(() => {
+    setStep("upload");
+    setFile(null);
+    setPreview(null);
+    setMappings([]);
+    setResult(null);
+    setError(null);
+  }, []);
+  const goBack = useCallback(() => {
+    if (step === "mapping") setStep("upload");
+  }, [step]);
+  return {
+    step,
+    file,
+    preview,
+    mappings,
+    result,
+    isLoading,
+    error,
+    handleFileSelect,
+    updateMapping,
+    startImport,
+    reset,
+    goBack
+  };
+}
+function useCSVExport({ exportFn, filename = "export.csv" }) {
+  const [isExporting, setIsExporting] = useState(false);
+  const exportCSV = useCallback(async () => {
+    setIsExporting(true);
+    try {
+      const data = await exportFn();
+      const blob = typeof data === "string" ? new Blob([data], { type: "text/csv" }) : data;
+      const url = URL.createObjectURL(blob);
+      const a = document.createElement("a");
+      a.href = url;
+      a.download = filename;
+      a.click();
+      URL.revokeObjectURL(url);
+    } finally {
+      setIsExporting(false);
+    }
+  }, [exportFn, filename]);
+  return { exportCSV, isExporting };
+}
+
+export { createSimpleFilter, decodeFilterConfig, encodeFilterConfig, getFilterDescription, mergeFilters, parseUrlFilters, useCRUDMutation, useCSVExport, useCSVImport, useRecentlyViewed, useSavedViews, useTableFilters, useWizard };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useTableFilters.ts","../src/filter-encoding.ts","../src/useCRUDMutation.ts","../src/useSavedViews.ts","../src/useRecentlyViewed.ts","../src/useWizard.ts","../src/useCSV.ts"],"names":["groupDescs","useState","useCallback","useEffect"],"mappings":"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","file":"index.mjs","sourcesContent":["import { useState, useCallback } from 'react'\n\ninterface TableFilterBase {\n  page: number\n  pageSize: number\n  search?: string\n  sortField?: string\n  sortDirection?: 'asc' | 'desc'\n}\n\ntype TableFilters<TFilters extends Record<string, unknown>> = TFilters & TableFilterBase\n\ninterface UseTableFiltersReturn<TFilters extends Record<string, unknown>> {\n  filters: TableFilters<TFilters>\n  setFilter: <K extends keyof TFilters>(key: K, value: TFilters[K]) => void\n  setPage: (page: number) => void\n  setPageSize: (pageSize: number) => void\n  setSearch: (search: string) => void\n  setSort: (field: string, direction: 'asc' | 'desc') => void\n  resetFilters: () => void\n}\n\nexport function useTableFilters<TFilters extends Record<string, unknown>>(\n  initial: TFilters & { page?: number; pageSize?: number; sortField?: string; sortDirection?: 'asc' | 'desc' }\n): UseTableFiltersReturn<TFilters> {\n  const defaultFilters: TableFilters<TFilters> = {\n    page: 1,\n    pageSize: 20,\n    ...initial,\n  } as TableFilters<TFilters>\n\n  const [filters, setFilters] = useState<TableFilters<TFilters>>(defaultFilters)\n\n  const setFilter = useCallback(<K extends keyof TFilters>(key: K, value: TFilters[K]) => {\n    setFilters(prev => ({ ...prev, [key]: value, page: 1 }))\n  }, [])\n\n  const setPage = useCallback((page: number) => {\n    setFilters(prev => ({ ...prev, page }))\n  }, [])\n\n  const setPageSize = useCallback((pageSize: number) => {\n    setFilters(prev => ({ ...prev, pageSize, page: 1 }))\n  }, [])\n\n  const setSearch = useCallback((search: string) => {\n    setFilters(prev => ({ ...prev, search, page: 1 }))\n  }, [])\n\n  const setSort = useCallback((field: string, direction: 'asc' | 'desc') => {\n    setFilters(prev => ({ ...prev, sortField: field, sortDirection: direction }))\n  }, [])\n\n  const resetFilters = useCallback(() => {\n    setFilters(defaultFilters)\n  }, []) // eslint-disable-line react-hooks/exhaustive-deps\n\n  return {\n    filters,\n    setFilter,\n    setPage,\n    setPageSize,\n    setSearch,\n    setSort,\n    resetFilters,\n  }\n}\n","/**\n * URL filter encoding utilities.\n *\n * Provides base64 encode/decode for FilterConfig (so filter state can be\n * stored in URL query params as compact strings) plus helpers for common\n * filter operations.\n *\n * These are pure functions with no React or Next.js dependencies.\n */\n\nimport type {\n  FilterConfig,\n  FilterCondition,\n  FilterGroup,\n  FilterOperator,\n  FilterValue,\n  EncodedFilterState,\n} from './filter-types'\n\n/**\n * Encode a FilterConfig to a URL-safe base64 string.\n */\nexport function encodeFilterConfig(config: FilterConfig): string {\n  const json = JSON.stringify(config)\n  return btoa(json).replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=/g, '')\n}\n\n/**\n * Decode a URL-safe base64 string back to a FilterConfig.\n * Returns null if the string is invalid or cannot be parsed.\n */\nexport function decodeFilterConfig(encoded: string): FilterConfig | null {\n  try {\n    // Convert URL-safe base64 back to standard base64\n    const standardBase64 = encoded.replace(/-/g, '+').replace(/_/g, '/')\n    // Add padding if needed\n    const padded = standardBase64 + '==='.slice(0, (4 - standardBase64.length % 4) % 4)\n    const decoded = atob(padded)\n    return JSON.parse(decoded) as FilterConfig\n  } catch {\n    return null\n  }\n}\n\n/**\n * Parse URLSearchParams into an EncodedFilterState.\n */\nexport function parseUrlFilters(params: URLSearchParams): EncodedFilterState {\n  const result: EncodedFilterState = {}\n\n  if (params.has('f')) result.f = params.get('f')!\n  if (params.has('s')) result.s = params.get('s')!\n  if (params.has('d')) result.d = params.get('d')!\n\n  if (params.has('p')) {\n    const page = parseInt(params.get('p')!, 10)\n    if (!isNaN(page) && page > 0) result.p = page\n  }\n\n  if (params.has('l')) {\n    const limit = parseInt(params.get('l')!, 10)\n    if (!isNaN(limit) && limit > 0 && limit <= 1000) result.l = limit\n  }\n\n  return result\n}\n\n/**\n * Build a single-condition FilterConfig.\n */\nexport function createSimpleFilter(\n  field: string,\n  operator: FilterOperator,\n  value: FilterValue\n): FilterConfig {\n  return {\n    groups: [{ logic: 'AND', conditions: [{ field, operator, value }] }],\n    globalLogic: 'AND',\n  }\n}\n\n/**\n * Merge multiple FilterConfigs with AND logic.\n */\nexport function mergeFilters(...configs: FilterConfig[]): FilterConfig {\n  if (configs.length === 0) return { groups: [] }\n  if (configs.length === 1) return configs[0]\n\n  return {\n    groups: configs.map(config => ({\n      logic: 'AND' as const,\n      conditions: [] as FilterCondition[],\n      groups: config.groups,\n    })),\n    globalLogic: 'AND',\n  }\n}\n\n/**\n * Get a human-readable description of a FilterConfig.\n */\nexport function getFilterDescription(config: FilterConfig): string {\n  if (config.groups.length === 0) return 'No filters applied'\n\n  function describeGroup(group: FilterGroup): string {\n    const conditionDescs = group.conditions.map(\n      c => `${c.field} ${c.operator} ${c.value}`\n    )\n    const groupDescs = group.groups?.map(g => `(${describeGroup(g)})`) ?? []\n    return [...conditionDescs, ...groupDescs].join(` ${group.logic} `)\n  }\n\n  const groupDescs = config.groups.map(describeGroup)\n  return groupDescs.join(` ${config.globalLogic ?? 'AND'} `)\n}\n","import { useMutation, useQueryClient } from '@tanstack/react-query'\nimport type { QueryKey, UseMutationOptions, UseMutationResult } from '@tanstack/react-query'\n\ninterface UseCRUDMutationOptions<TInput, TOutput> {\n  invalidateKeys: QueryKey[]\n  onSuccess?: (data: TOutput, variables: TInput) => void\n  onError?: (error: Error, variables: TInput) => void\n}\n\nexport function useCRUDMutation<TInput, TOutput>(\n  mutationFn: (input: TInput) => Promise<TOutput>,\n  opts: UseCRUDMutationOptions<TInput, TOutput>\n): UseMutationResult<TOutput, Error, TInput> {\n  const queryClient = useQueryClient()\n\n  return useMutation({\n    mutationFn,\n    onSuccess: (data, variables) => {\n      for (const key of opts.invalidateKeys) {\n        queryClient.invalidateQueries({ queryKey: key })\n      }\n      opts.onSuccess?.(data, variables)\n    },\n    onError: opts.onError,\n  })\n}\n","import { useState, useEffect, useCallback } from 'react'\n\nexport interface SavedView {\n  id: string\n  name: string\n  isDefault?: boolean\n  createdAt?: string\n  [key: string]: unknown\n}\n\ninterface SavedViewsState<T extends SavedView> {\n  views: T[]\n  currentViewId: string | null\n  loading: boolean\n  error: string | null\n}\n\ninterface UseSavedViewsOptions<T extends SavedView> {\n  resource: string\n  loadFn: (resource: string) => Promise<T[]>\n  saveFn: (resource: string, view: Omit<T, 'id' | 'createdAt'>) => Promise<T>\n  updateFn: (resource: string, viewId: string, updates: Partial<T>) => Promise<T>\n  deleteFn: (resource: string, viewId: string) => Promise<void>\n}\n\nexport function useSavedViews<T extends SavedView>({\n  resource,\n  loadFn,\n  saveFn,\n  updateFn,\n  deleteFn,\n}: UseSavedViewsOptions<T>) {\n  const [state, setState] = useState<SavedViewsState<T>>({\n    views: [],\n    currentViewId: null,\n    loading: true,\n    error: null,\n  })\n\n  const fetchViews = useCallback(async () => {\n    setState(prev => ({ ...prev, loading: true, error: null }))\n    try {\n      const views = await loadFn(resource)\n      const defaultView = views.find(v => v.isDefault)\n      setState(prev => ({\n        ...prev,\n        views,\n        currentViewId: defaultView?.id || null,\n        loading: false,\n      }))\n    } catch (error) {\n      setState(prev => ({\n        ...prev,\n        loading: false,\n        error: error instanceof Error ? error.message : 'Failed to load views',\n      }))\n    }\n  }, [resource, loadFn])\n\n  useEffect(() => {\n    fetchViews()\n  }, [fetchViews])\n\n  const saveView = useCallback(\n    async (viewData: Omit<T, 'id' | 'createdAt'>): Promise<T> => {\n      const newView = await saveFn(resource, viewData)\n      setState(prev => ({\n        ...prev,\n        views: [...prev.views, newView],\n        currentViewId: newView.id,\n      }))\n      return newView\n    },\n    [resource, saveFn]\n  )\n\n  const updateView = useCallback(\n    async (viewId: string, updates: Partial<T>): Promise<void> => {\n      await updateFn(resource, viewId, updates)\n      await fetchViews()\n    },\n    [resource, updateFn, fetchViews]\n  )\n\n  const deleteView = useCallback(\n    async (viewId: string): Promise<void> => {\n      await deleteFn(resource, viewId)\n      setState(prev => ({\n        ...prev,\n        views: prev.views.filter(v => v.id !== viewId),\n        currentViewId: prev.currentViewId === viewId ? null : prev.currentViewId,\n      }))\n    },\n    [resource, deleteFn]\n  )\n\n  const loadView = useCallback((viewId: string) => {\n    setState(prev => ({ ...prev, currentViewId: viewId }))\n  }, [])\n\n  const getCurrentView = useCallback((): T | null => {\n    return state.views.find(v => v.id === state.currentViewId) || null\n  }, [state.views, state.currentViewId])\n\n  return {\n    views: state.views,\n    currentViewId: state.currentViewId,\n    loading: state.loading,\n    error: state.error,\n    saveView,\n    updateView,\n    deleteView,\n    loadView,\n    getCurrentView,\n    refreshViews: fetchViews,\n  }\n}\n","import { useState, useCallback, useEffect } from 'react'\n\ninterface StoredItem<T> {\n  item: T\n  viewedAt: number\n}\n\nexport function useRecentlyViewed<T extends { id: string }>(\n  storageKey: string,\n  maxItems: number = 5\n) {\n  const [items, setItems] = useState<StoredItem<T>[]>([])\n\n  // Load from localStorage on mount\n  useEffect(() => {\n    if (typeof window === 'undefined') return\n    try {\n      const raw = localStorage.getItem(storageKey)\n      if (raw) {\n        setItems(JSON.parse(raw) as StoredItem<T>[])\n      }\n    } catch {\n      // Corrupted storage, start fresh\n    }\n  }, [storageKey])\n\n  const persist = useCallback(\n    (updated: StoredItem<T>[]) => {\n      if (typeof window === 'undefined') return\n      try {\n        localStorage.setItem(storageKey, JSON.stringify(updated))\n      } catch {\n        // Storage quota exceeded\n      }\n    },\n    [storageKey]\n  )\n\n  const trackView = useCallback(\n    (item: T) => {\n      setItems(prev => {\n        const deduped = prev.filter(entry => entry.item.id !== item.id)\n        const updated = [{ item, viewedAt: Date.now() }, ...deduped].slice(0, maxItems)\n        persist(updated)\n        return updated\n      })\n    },\n    [maxItems, persist]\n  )\n\n  const clear = useCallback(() => {\n    setItems([])\n    if (typeof window === 'undefined') return\n    try {\n      localStorage.removeItem(storageKey)\n    } catch {\n      // ignore\n    }\n  }, [storageKey])\n\n  return {\n    items: items.map(entry => entry.item),\n    timestamps: items.map(entry => ({ id: entry.item.id, viewedAt: entry.viewedAt })),\n    trackView,\n    clear,\n  }\n}\n","import { useState, useCallback } from 'react'\n\nexport interface WizardState<TStep extends string> {\n  currentStep: TStep\n  stepIndex: number\n  totalSteps: number\n  isFirstStep: boolean\n  isLastStep: boolean\n  canGoBack: boolean\n  canGoNext: boolean\n  goTo: (step: TStep) => void\n  next: () => void\n  prev: () => void\n  reset: () => void\n}\n\nexport function useWizard<TStep extends string>(\n  steps: readonly TStep[],\n  initialStep?: TStep\n): WizardState<TStep> {\n  const [currentStep, setCurrentStep] = useState<TStep>(initialStep ?? steps[0])\n\n  const stepIndex = steps.indexOf(currentStep)\n  const totalSteps = steps.length\n  const isFirstStep = stepIndex === 0\n  const isLastStep = stepIndex === totalSteps - 1\n\n  const goTo = useCallback(\n    (step: TStep) => {\n      if (steps.includes(step)) setCurrentStep(step)\n    },\n    [steps]\n  )\n\n  const next = useCallback(() => {\n    if (!isLastStep) setCurrentStep(steps[stepIndex + 1])\n  }, [isLastStep, stepIndex, steps])\n\n  const prev = useCallback(() => {\n    if (!isFirstStep) setCurrentStep(steps[stepIndex - 1])\n  }, [isFirstStep, stepIndex, steps])\n\n  const reset = useCallback(() => {\n    setCurrentStep(initialStep ?? steps[0])\n  }, [initialStep, steps])\n\n  return {\n    currentStep,\n    stepIndex,\n    totalSteps,\n    isFirstStep,\n    isLastStep,\n    canGoBack: !isFirstStep,\n    canGoNext: !isLastStep,\n    goTo,\n    next,\n    prev,\n    reset,\n  }\n}\n","import { useState, useCallback } from 'react'\n\nexport interface CSVColumnMapping {\n  csv_column: string\n  target_field: string\n}\n\nexport interface CSVPreviewResult<TField extends string = string> {\n  columns: string[]\n  sample_rows: Record<string, string>[]\n  suggested_mappings?: CSVColumnMapping[]\n  total_rows?: number\n}\n\nexport interface CSVImportResult {\n  total_rows: number\n  successful: number\n  failed: number\n  errors: Array<{ row: number; message: string }>\n}\n\nexport type CSVImportStep = 'upload' | 'mapping' | 'importing' | 'complete'\n\nexport interface UseCSVImportOptions<TField extends string = string> {\n  previewFn: (file: File) => Promise<CSVPreviewResult<TField>>\n  importFn: (file: File, mappings: CSVColumnMapping[]) => Promise<CSVImportResult>\n  onSuccess?: (result: CSVImportResult) => void\n}\n\nexport interface UseCSVImportState {\n  step: CSVImportStep\n  file: File | null\n  preview: CSVPreviewResult | null\n  mappings: CSVColumnMapping[]\n  result: CSVImportResult | null\n  isLoading: boolean\n  error: string | null\n  handleFileSelect: (file: File) => Promise<void>\n  updateMapping: (csvColumn: string, targetField: string) => void\n  startImport: () => Promise<void>\n  reset: () => void\n  goBack: () => void\n}\n\nexport function useCSVImport<TField extends string = string>({\n  previewFn,\n  importFn,\n  onSuccess,\n}: UseCSVImportOptions<TField>): UseCSVImportState {\n  const [step, setStep] = useState<CSVImportStep>('upload')\n  const [file, setFile] = useState<File | null>(null)\n  const [preview, setPreview] = useState<CSVPreviewResult | null>(null)\n  const [mappings, setMappings] = useState<CSVColumnMapping[]>([])\n  const [result, setResult] = useState<CSVImportResult | null>(null)\n  const [isLoading, setIsLoading] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n\n  const handleFileSelect = useCallback(\n    async (selectedFile: File) => {\n      setFile(selectedFile)\n      setError(null)\n      setIsLoading(true)\n      try {\n        const previewData = await previewFn(selectedFile)\n        setPreview(previewData)\n        setMappings(previewData.suggested_mappings ?? [])\n        setStep('mapping')\n      } catch {\n        setError('Failed to preview CSV file')\n      } finally {\n        setIsLoading(false)\n      }\n    },\n    [previewFn]\n  )\n\n  const updateMapping = useCallback((csvColumn: string, targetField: string) => {\n    setMappings((prev) => {\n      const existing = prev.find((m) => m.csv_column === csvColumn)\n      if (existing) {\n        return prev.map((m) =>\n          m.csv_column === csvColumn ? { ...m, target_field: targetField } : m\n        )\n      }\n      return [...prev, { csv_column: csvColumn, target_field: targetField }]\n    })\n  }, [])\n\n  const startImport = useCallback(async () => {\n    if (!file) return\n    setStep('importing')\n    setError(null)\n    try {\n      const importResult = await importFn(file, mappings)\n      setResult(importResult)\n      setStep('complete')\n      onSuccess?.(importResult)\n    } catch {\n      setError('Failed to import CSV')\n      setStep('mapping')\n    }\n  }, [file, mappings, importFn, onSuccess])\n\n  const reset = useCallback(() => {\n    setStep('upload')\n    setFile(null)\n    setPreview(null)\n    setMappings([])\n    setResult(null)\n    setError(null)\n  }, [])\n\n  const goBack = useCallback(() => {\n    if (step === 'mapping') setStep('upload')\n  }, [step])\n\n  return {\n    step,\n    file,\n    preview,\n    mappings,\n    result,\n    isLoading,\n    error,\n    handleFileSelect,\n    updateMapping,\n    startImport,\n    reset,\n    goBack,\n  }\n}\n\nexport interface UseCSVExportOptions {\n  exportFn: () => Promise<Blob | string>\n  filename?: string\n}\n\nexport function useCSVExport({ exportFn, filename = 'export.csv' }: UseCSVExportOptions) {\n  const [isExporting, setIsExporting] = useState(false)\n\n  const exportCSV = useCallback(async () => {\n    setIsExporting(true)\n    try {\n      const data = await exportFn()\n      const blob = typeof data === 'string' ? new Blob([data], { type: 'text/csv' }) : data\n      const url = URL.createObjectURL(blob)\n      const a = document.createElement('a')\n      a.href = url\n      a.download = filename\n      a.click()\n      URL.revokeObjectURL(url)\n    } finally {\n      setIsExporting(false)\n    }\n  }, [exportFn, filename])\n\n  return { exportCSV, isExporting }\n}\n"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@startsimpli/hooks",
+  "version": "0.1.1",
+  "description": "Shared React hooks for StartSimpli apps",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "src",
+    "README.md",
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "@tanstack/react-query": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/react-query": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "@testing-library/react": "^14.0.0",
+    "@types/node": "^20.11.0",
+    "@types/react": "^18.2.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "module": "./dist/index.mjs"
+}

package/src/__tests__/useCRUDMutation.test.ts

@@ -0,0 +1,116 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { renderHook, act, waitFor } from '@testing-library/react'
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
+import React from 'react'
+import { useCRUDMutation } from '../useCRUDMutation'
+
+function createWrapper() {
+  const queryClient = new QueryClient({
+    defaultOptions: { mutations: { retry: false }, queries: { retry: false } },
+  })
+  return function Wrapper({ children }: { children: React.ReactNode }) {
+    return React.createElement(QueryClientProvider, { client: queryClient }, children)
+  }
+}
+
+describe('useCRUDMutation', () => {
+  beforeEach(() => {
+    vi.clearAllMocks()
+  })
+
+  it('calls mutationFn on mutate', async () => {
+    const mutationFn = vi.fn().mockResolvedValue({ id: '1', name: 'Created' })
+    const wrapper = createWrapper()
+
+    const { result } = renderHook(
+      () => useCRUDMutation(mutationFn, { invalidateKeys: [] }),
+      { wrapper }
+    )
+
+    await act(async () => {
+      result.current.mutate({ name: 'New Item' })
+    })
+
+    await waitFor(() => expect(result.current.isSuccess).toBe(true))
+
+    // react-query v5 passes a context object as the second arg to mutationFn
+    expect(mutationFn).toHaveBeenCalledWith({ name: 'New Item' }, expect.any(Object))
+  })
+
+  it('calls onSuccess callback after successful mutation', async () => {
+    const onSuccess = vi.fn()
+    const mutationFn = vi.fn().mockResolvedValue({ id: '1' })
+    const wrapper = createWrapper()
+
+    const { result } = renderHook(
+      () => useCRUDMutation(mutationFn, { invalidateKeys: [], onSuccess }),
+      { wrapper }
+    )
+
+    await act(async () => {
+      result.current.mutate({ name: 'Test' })
+    })
+
+    await waitFor(() => expect(result.current.isSuccess).toBe(true))
+
+    expect(onSuccess).toHaveBeenCalledWith({ id: '1' }, { name: 'Test' })
+  })
+
+  it('calls onError callback when mutation fails', async () => {
+    const onError = vi.fn()
+    const mutationFn = vi.fn().mockRejectedValue(new Error('Server error'))
+    const wrapper = createWrapper()
+
+    const { result } = renderHook(
+      () => useCRUDMutation(mutationFn, { invalidateKeys: [], onError }),
+      { wrapper }
+    )
+
+    await act(async () => {
+      result.current.mutate({})
+    })
+
+    await waitFor(() => expect(result.current.isError).toBe(true))
+
+    // opts.onError is passed directly to useMutation, react-query v5 calls it with (error, variables, context, mutation)
+    expect(onError).toHaveBeenCalled()
+    const [firstArg] = onError.mock.calls[0]
+    expect(firstArg).toBeInstanceOf(Error)
+    expect(firstArg.message).toBe('Server error')
+  })
+
+  it('sets isError to true when mutation fails', async () => {
+    const mutationFn = vi.fn().mockRejectedValue(new Error('Failure'))
+    const wrapper = createWrapper()
+
+    const { result } = renderHook(
+      () => useCRUDMutation(mutationFn, { invalidateKeys: [] }),
+      { wrapper }
+    )
+
+    await act(async () => {
+      result.current.mutate({})
+    })
+
+    await waitFor(() => expect(result.current.isError).toBe(true))
+  })
+
+  it('exposes data from a successful mutation', async () => {
+    const responseData = { id: '42', name: 'Result' }
+    const mutationFn = vi.fn().mockResolvedValue(responseData)
+    const wrapper = createWrapper()
+
+    const { result } = renderHook(
+      () => useCRUDMutation(mutationFn, { invalidateKeys: [] }),
+      { wrapper }
+    )
+
+    await act(async () => {
+      result.current.mutate({})
+    })
+
+    await waitFor(() => expect(result.current.isSuccess).toBe(true))
+
+    expect(result.current.data).toEqual(responseData)
+  })
+})