@soulbatical/tetra-ui 0.1.0

package/dist/hooks/useQueryState.js

@@ -0,0 +1,246 @@
+"use client";
+import { useSearchParams, useRouter, usePathname } from 'next/navigation.js';
+import { useCallback, useMemo } from 'react';
+/**
+ * Helper to update URL search params in Next.js App Router.
+ * Returns new URLSearchParams instance (immutable pattern).
+ */
+function updateSearchParams(current, updater) {
+    const next = new URLSearchParams(current.toString());
+    return updater(next);
+}
+export function useQueryState(defaultValues) {
+    const searchParams = useSearchParams();
+    const router = useRouter();
+    const pathname = usePathname();
+    /** Push new search params to URL */
+    const pushParams = useCallback((next) => {
+        const qs = next.toString();
+        router.replace(`${pathname}${qs ? `?${qs}` : ''}`, { scroll: false });
+    }, [router, pathname]);
+    // Parse a single parameter with type coercion
+    const parseParam = useCallback((key) => {
+        const value = searchParams.get(String(key));
+        if (value === null)
+            return undefined;
+        // Try to parse as JSON first (for objects/arrays)
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            // If it's a number string, parse it
+            if (/^\d+$/.test(value)) {
+                return Number(value);
+            }
+            // Otherwise return as string
+            return value;
+        }
+    }, [searchParams]);
+    // Set a single parameter
+    const setParam = useCallback((key, value) => {
+        const next = new URLSearchParams(searchParams.toString());
+        if (value === undefined || value === '' || value === null) {
+            next.delete(String(key));
+        }
+        else if (typeof value === 'object') {
+            next.set(String(key), JSON.stringify(value));
+        }
+        else {
+            next.set(String(key), String(value));
+        }
+        pushParams(next);
+    }, [searchParams, pushParams]);
+    // Set multiple parameters at once
+    const setParams = useCallback((params) => {
+        const next = new URLSearchParams(searchParams.toString());
+        Object.entries(params).forEach(([key, value]) => {
+            if (value === undefined || value === '' || value === null) {
+                next.delete(key);
+            }
+            else if (typeof value === 'object') {
+                next.set(key, JSON.stringify(value));
+            }
+            else {
+                next.set(key, String(value));
+            }
+        });
+        pushParams(next);
+    }, [searchParams, pushParams]);
+    // Clear a single parameter
+    const clearParam = useCallback((key) => {
+        const next = new URLSearchParams(searchParams.toString());
+        next.delete(String(key));
+        pushParams(next);
+    }, [searchParams, pushParams]);
+    // Clear all parameters
+    const clearParams = useCallback(() => {
+        pushParams(new URLSearchParams());
+    }, [pushParams]);
+    // Pagination helpers
+    const pagination = useMemo(() => {
+        const page = Number(searchParams.get('page')) || 1;
+        const perPage = Number(searchParams.get('perPage')) || 20;
+        return {
+            page,
+            perPage,
+            setPage: (newPage) => setParam('page', newPage),
+            setPerPage: (newPerPage) => setParam('perPage', newPerPage),
+        };
+    }, [searchParams, setParam]);
+    // Sorting helpers
+    const sorting = useMemo(() => {
+        const sort = searchParams.get('sort') || undefined;
+        const order = (searchParams.get('order') || 'asc');
+        return {
+            sort,
+            order,
+            setSort: (field, newOrder = 'asc') => {
+                if (field) {
+                    setParams({
+                        sort: field,
+                        order: newOrder,
+                    });
+                }
+                else {
+                    clearParam('sort');
+                    clearParam('order');
+                }
+            },
+        };
+    }, [searchParams, setParams, clearParam]);
+    // Search helpers
+    const search = useMemo(() => {
+        const query = searchParams.get('search') || undefined;
+        return {
+            query,
+            setQuery: (newQuery) => setParam('search', newQuery),
+        };
+    }, [searchParams, setParam]);
+    // Parse all filters (excluding pagination, sorting, search)
+    const filters = useMemo(() => {
+        const result = {};
+        const excludeKeys = ['page', 'perPage', 'sort', 'order', 'search'];
+        searchParams.forEach((value, key) => {
+            if (!excludeKeys.includes(key)) {
+                try {
+                    result[key] = JSON.parse(value);
+                }
+                catch {
+                    result[key] = /^\d+$/.test(value) ? Number(value) : value;
+                }
+            }
+        });
+        return result;
+    }, [searchParams]);
+    // Set multiple filters at once
+    const setFilters = useCallback((newFilters) => {
+        const next = new URLSearchParams(searchParams.toString());
+        // Preserve pagination, sorting, search
+        const preserved = {
+            page: searchParams.get('page'),
+            perPage: searchParams.get('perPage'),
+            sort: searchParams.get('sort'),
+            order: searchParams.get('order'),
+            search: searchParams.get('search'),
+        };
+        // Clear all params
+        Array.from(next.keys()).forEach((key) => next.delete(key));
+        // Restore preserved params
+        Object.entries(preserved).forEach(([key, value]) => {
+            if (value)
+                next.set(key, value);
+        });
+        // Set new filters
+        Object.entries(newFilters).forEach(([key, value]) => {
+            if (value !== undefined && value !== '' && value !== null) {
+                if (typeof value === 'object') {
+                    next.set(key, JSON.stringify(value));
+                }
+                else {
+                    next.set(key, String(value));
+                }
+            }
+        });
+        pushParams(next);
+    }, [searchParams, pushParams]);
+    // Clear all filters (preserve pagination, sorting, search)
+    const clearFilters = useCallback(() => {
+        const next = new URLSearchParams();
+        // Preserve these params
+        ['page', 'perPage', 'sort', 'order', 'search'].forEach((key) => {
+            const value = searchParams.get(key);
+            if (value)
+                next.set(key, value);
+        });
+        pushParams(next);
+    }, [searchParams, pushParams]);
+    // Check if any filters are active
+    const hasFilters = useMemo(() => {
+        const excludeKeys = ['page', 'perPage', 'sort', 'order', 'search'];
+        return Array.from(searchParams.keys()).some((key) => !excludeKeys.includes(key));
+    }, [searchParams]);
+    // Build query string for API calls
+    const buildQueryString = useCallback(() => {
+        return searchParams.toString();
+    }, [searchParams]);
+    // Hooks for simplified interface (always called, conditionally used)
+    const currentFilters = useMemo(() => {
+        if (!defaultValues)
+            return {};
+        const result = { ...defaultValues };
+        Object.keys(defaultValues).forEach((key) => {
+            const value = searchParams.get(key);
+            if (value !== null) {
+                try {
+                    result[key] = JSON.parse(value);
+                }
+                catch {
+                    // Keep as string - don't convert to number
+                    result[key] = value;
+                }
+            }
+        });
+        return result;
+    }, [searchParams, defaultValues]);
+    const setFilter = useCallback((key, value) => {
+        setParam(key, value);
+    }, [setParam]);
+    const resetFilters = useCallback(() => {
+        if (!defaultValues)
+            return;
+        const next = new URLSearchParams();
+        // Preserve non-filter params
+        searchParams.forEach((value, key) => {
+            if (!Object.keys(defaultValues).includes(key)) {
+                next.set(key, value);
+            }
+        });
+        pushParams(next);
+    }, [searchParams, pushParams, defaultValues]);
+    // If defaultValues are provided, return a simplified interface
+    if (defaultValues) {
+        return {
+            filters: currentFilters,
+            setFilter,
+            resetFilters,
+        };
+    }
+    // Original return for no defaultValues
+    return {
+        params: searchParams,
+        setParam,
+        setParams,
+        getParam: parseParam,
+        clearParam,
+        clearParams,
+        pagination,
+        sorting,
+        search,
+        filters,
+        setFilters,
+        clearFilters,
+        hasFilters,
+        buildQueryString,
+    };
+}
+//# sourceMappingURL=useQueryState.js.map

package/dist/hooks/useQueryState.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+export type { TetraConfig, AuthUser as TetraAuthUser, Organization as TetraOrganization, FilterConfig, SortFieldConfig, FeatureDisplayConfig, PageDisplayConfig, ListDisplayConfig, CardDisplayConfig, ApiResponse, ListParams, } from "./types/index.js";
+export { cn } from "./lib/utils.js";
+export { ThemeProvider, useTheme } from "./providers/ThemeProvider.js";
+export { QueryProvider } from "./providers/QueryProvider.js";
+export { useAuth, getAccessToken, waitForAuthReady, configureAuth, } from "./hooks/useAuth.js";
+export { useOrganizations, type Organization, } from "./hooks/useOrganizations.js";
+export { apiClient, configureApiClient, type GetAccessTokenFn, } from "./services/apiClient.js";
+export { ThemeToggle } from "./components/ThemeToggle.js";
+export { OrgSwitcher } from "./components/OrgSwitcher.js";
+export { ProtectedRoute } from "./components/ProtectedRoute.js";
+export { PageHeader } from "./components/PageHeader.js";
+export { GenericListLayout, type SortOption, type GenericListLayoutProps, } from "./components/GenericListLayout.js";
+export { generateList, BaseGrid } from "./components/ListGenerator.js";
+export { LoadingCard, LoadingSpinner, Skeleton, SkeletonCard, } from "./components/LoadingStates.js";
+export { StatusBadge } from "./components/StatusBadge.js";
+export { AutoCard, type CardConfig, type AutoCardProps, type LinkComponent } from "./components/AutoCard.js";
+export { CookieConsent, type CookieConsentProps } from "./components/CookieConsent.js";
+export { useDebounce } from "./hooks/useDebounce.js";
+export { useDialog } from "./hooks/useDialog.js";
+export { useIsMobile } from "./hooks/use-mobile.js";
+export { useInfiniteScroll } from "./hooks/useInfiniteScroll.js";
+export { useCacheInvalidation } from "./hooks/useCacheInvalidation.js";
+export { useFormSubmit } from "./hooks/useFormSubmit.js";
+export { useQueryState } from "./hooks/useQueryState.js";
+export { usePersistedQueryState, clearAllPersistedFilters, getPersistedFilters, } from "./hooks/usePersistedQueryState.js";
+export { useFilterConfigs, generateSortOptions, type FilterConfigsResponse, type PaginationConfig, } from "./hooks/useFilterConfigs.js";
+export { usePageContext, PageContextProvider, type PageContext, } from "./hooks/usePageContext.js";
+export { useGenericList } from "./hooks/useGenericList.js";
+export { useGenericListWithConfig } from "./hooks/useGenericListWithConfig.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,WAAW,EACX,QAAQ,IAAI,aAAa,EACzB,YAAY,IAAI,iBAAiB,EACjC,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAGpC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,OAAO,EACL,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,gBAAgB,EAChB,KAAK,YAAY,GAClB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,sBAAsB,GAC5B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EACL,WAAW,EACX,cAAc,EACd,QAAQ,EACR,YAAY,GACb,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC7G,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGvF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,KAAK,WAAW,GACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/index.js

@@ -0,0 +1,43 @@
+// ============================================
+// @tetra/ui — Shared React frontend framework
+// ============================================
+// Utilities
+export { cn } from "./lib/utils.js";
+// Providers
+export { ThemeProvider, useTheme } from "./providers/ThemeProvider.js";
+export { QueryProvider } from "./providers/QueryProvider.js";
+// Auth
+export { useAuth, getAccessToken, waitForAuthReady, configureAuth, } from "./hooks/useAuth.js";
+// Multi-tenant
+export { useOrganizations, } from "./hooks/useOrganizations.js";
+// Services
+export { apiClient, configureApiClient, } from "./services/apiClient.js";
+// Components
+export { ThemeToggle } from "./components/ThemeToggle.js";
+export { OrgSwitcher } from "./components/OrgSwitcher.js";
+export { ProtectedRoute } from "./components/ProtectedRoute.js";
+// Config-driven page components (ported from SparkBuddy)
+export { PageHeader } from "./components/PageHeader.js";
+export { GenericListLayout, } from "./components/GenericListLayout.js";
+export { generateList, BaseGrid } from "./components/ListGenerator.js";
+export { LoadingCard, LoadingSpinner, Skeleton, SkeletonCard, } from "./components/LoadingStates.js";
+export { StatusBadge } from "./components/StatusBadge.js";
+export { AutoCard } from "./components/AutoCard.js";
+export { CookieConsent } from "./components/CookieConsent.js";
+// Hooks — utility
+export { useDebounce } from "./hooks/useDebounce.js";
+export { useDialog } from "./hooks/useDialog.js";
+export { useIsMobile } from "./hooks/use-mobile.js";
+export { useInfiniteScroll } from "./hooks/useInfiniteScroll.js";
+export { useCacheInvalidation } from "./hooks/useCacheInvalidation.js";
+export { useFormSubmit } from "./hooks/useFormSubmit.js";
+// Hooks — query state & filters
+export { useQueryState } from "./hooks/useQueryState.js";
+export { usePersistedQueryState, clearAllPersistedFilters, getPersistedFilters, } from "./hooks/usePersistedQueryState.js";
+export { useFilterConfigs, generateSortOptions, } from "./hooks/useFilterConfigs.js";
+// Page context (for sidebars that read page state)
+export { usePageContext, PageContextProvider, } from "./hooks/usePageContext.js";
+// Hooks — generic list
+export { useGenericList } from "./hooks/useGenericList.js";
+export { useGenericListWithConfig } from "./hooks/useGenericListWithConfig.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,8CAA8C;AAC9C,+CAA+C;AAiB/C,YAAY;AACZ,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO;AACP,OAAO,EACL,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,eAAe;AACf,OAAO,EACL,gBAAgB,GAEjB,MAAM,6BAA6B,CAAC;AAErC,WAAW;AACX,OAAO,EACL,SAAS,EACT,kBAAkB,GAEnB,MAAM,yBAAyB,CAAC;AAEjC,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,yDAAyD;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EACL,iBAAiB,GAGlB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EACL,WAAW,EACX,cAAc,EACd,QAAQ,EACR,YAAY,GACb,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAA2D,MAAM,0BAA0B,CAAC;AAC7G,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AAEvF,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,gCAAgC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAGpB,MAAM,6BAA6B,CAAC;AAErC,mDAAmD;AACnD,OAAO,EACL,cAAc,EACd,mBAAmB,GAEpB,MAAM,2BAA2B,CAAC;AAEnC,uBAAuB;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/lib/utils.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAG7C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}

package/dist/lib/utils.js

@@ -0,0 +1,6 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+//# sourceMappingURL=utils.js.map

package/dist/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,MAAM,UAAU,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/providers/QueryProvider.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from "react";
+/**
+ * Standard React Query provider for all VCA projects.
+ * Default: 60s staleTime, 1 retry.
+ */
+export declare function QueryProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=QueryProvider.d.ts.map

package/dist/providers/QueryProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryProvider.d.ts","sourceRoot":"","sources":["../../src/providers/QueryProvider.tsx"],"names":[],"mappings":"AAEA,OAAc,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGxD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAgBlE"}

package/dist/providers/QueryProvider.js

@@ -0,0 +1,20 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useState } from "react";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+/**
+ * Standard React Query provider for all VCA projects.
+ * Default: 60s staleTime, 1 retry.
+ */
+export function QueryProvider({ children }) {
+    const [queryClient] = useState(() => new QueryClient({
+        defaultOptions: {
+            queries: {
+                staleTime: 60 * 1000,
+                retry: 1,
+            },
+        },
+    }));
+    return (_jsx(QueryClientProvider, { client: queryClient, children: children }));
+}
+//# sourceMappingURL=QueryProvider.js.map

package/dist/providers/QueryProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryProvider.js","sourceRoot":"","sources":["../../src/providers/QueryProvider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEzE;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAAE,QAAQ,EAA2B;IACjE,MAAM,CAAC,WAAW,CAAC,GAAG,QAAQ,CAC5B,GAAG,EAAE,CACH,IAAI,WAAW,CAAC;QACd,cAAc,EAAE;YACd,OAAO,EAAE;gBACP,SAAS,EAAE,EAAE,GAAG,IAAI;gBACpB,KAAK,EAAE,CAAC;aACT;SACF;KACF,CAAC,CACL,CAAC;IAEF,OAAO,CACL,KAAC,mBAAmB,IAAC,MAAM,EAAE,WAAW,YAAG,QAAQ,GAAuB,CAC3E,CAAC;AACJ,CAAC"}

package/dist/providers/ThemeProvider.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode } from "react";
+interface ThemeProviderProps {
+    children: ReactNode;
+    /** Default theme (default: "dark") */
+    defaultTheme?: "light" | "dark" | "system";
+}
+/**
+ * Standard theme provider for all VCA projects.
+ * Uses next-themes. Sets .dark class on <html> for Tailwind.
+ */
+export declare function ThemeProvider({ children, defaultTheme, }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+/** Re-export next-themes useTheme — one import for consumers */
+export declare const useTheme: () => import("next-themes").UseThemeProps;
+export {};
+//# sourceMappingURL=ThemeProvider.d.ts.map

package/dist/providers/ThemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/providers/ThemeProvider.tsx"],"names":[],"mappings":"AAEA,OAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG9C,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,SAAS,CAAC;IACpB,sCAAsC;IACtC,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC5C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,YAAqB,GACtB,EAAE,kBAAkB,2CAMpB;AAED,gEAAgE;AAChE,eAAO,MAAM,QAAQ,2CAAe,CAAC"}

package/dist/providers/ThemeProvider.js

@@ -0,0 +1,13 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ThemeProvider as NextThemesProvider, useTheme as useNextTheme } from "next-themes";
+/**
+ * Standard theme provider for all VCA projects.
+ * Uses next-themes. Sets .dark class on <html> for Tailwind.
+ */
+export function ThemeProvider({ children, defaultTheme = "dark", }) {
+    return (_jsx(NextThemesProvider, { attribute: "class", defaultTheme: defaultTheme, enableSystem: true, children: children }));
+}
+/** Re-export next-themes useTheme — one import for consumers */
+export const useTheme = useNextTheme;
+//# sourceMappingURL=ThemeProvider.js.map

package/dist/providers/ThemeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.js","sourceRoot":"","sources":["../../src/providers/ThemeProvider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ5F;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,QAAQ,EACR,YAAY,GAAG,MAAM,GACF;IACnB,OAAO,CACL,KAAC,kBAAkB,IAAC,SAAS,EAAC,OAAO,EAAC,YAAY,EAAE,YAAY,EAAE,YAAY,kBAC3E,QAAQ,GACU,CACtB,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC"}

package/dist/services/apiClient.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Standard API client for all VCA projects.
+ * Injects Bearer token from auth module.
+ * Configure with createApiClient(baseUrl, getAccessToken).
+ */
+export type GetAccessTokenFn = () => string | null;
+/**
+ * Initialize the API client. Call once at app startup.
+ * @param baseUrl - API base URL (e.g., from NEXT_PUBLIC_API_URL)
+ * @param getAccessToken - Function that returns the current access token
+ */
+export declare function configureApiClient(baseUrl: string, getAccessToken: GetAccessTokenFn): void;
+export declare const apiClient: {
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    put<T>(path: string, body: unknown): Promise<T>;
+    patch<T>(path: string, body: unknown): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+};
+//# sourceMappingURL=apiClient.d.ts.map

package/dist/services/apiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../../src/services/apiClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,MAAM,GAAG,IAAI,CAAC;AAKnD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,gBAAgB,QAIjC;AA4BD,eAAO,MAAM,SAAS;QACV,CAAC,QAAQ,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;SAM3B,CAAC,QAAQ,MAAM,SAAS,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;QAU7C,CAAC,QAAQ,MAAM,QAAQ,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;UAUzC,CAAC,QAAQ,MAAM,QAAQ,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;WAU1C,CAAC,QAAQ,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAQ1C,CAAC"}

package/dist/services/apiClient.js

@@ -0,0 +1,85 @@
+/**
+ * Standard API client for all VCA projects.
+ * Injects Bearer token from auth module.
+ * Configure with createApiClient(baseUrl, getAccessToken).
+ */
+let _baseUrl = "";
+let _getAccessToken = () => null;
+/**
+ * Initialize the API client. Call once at app startup.
+ * @param baseUrl - API base URL (e.g., from NEXT_PUBLIC_API_URL)
+ * @param getAccessToken - Function that returns the current access token
+ */
+export function configureApiClient(baseUrl, getAccessToken) {
+    _baseUrl = baseUrl;
+    _getAccessToken = getAccessToken;
+}
+async function throwIfError(res) {
+    if (res.ok)
+        return;
+    let detail = "";
+    try {
+        const body = await res.json();
+        detail = body.detail || body.error || body.message || "";
+    }
+    catch {
+        // no JSON body
+    }
+    const msg = detail
+        ? `API ${res.status}: ${detail}`
+        : `API error: ${res.status}`;
+    throw new Error(msg);
+}
+function getHeaders() {
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    const token = _getAccessToken();
+    if (token) {
+        headers["Authorization"] = `Bearer ${token}`;
+    }
+    return headers;
+}
+export const apiClient = {
+    async get(path) {
+        const res = await fetch(`${_baseUrl}${path}`, { headers: getHeaders() });
+        await throwIfError(res);
+        return res.json();
+    },
+    async post(path, body) {
+        const res = await fetch(`${_baseUrl}${path}`, {
+            method: "POST",
+            headers: getHeaders(),
+            body: body != null ? JSON.stringify(body) : undefined,
+        });
+        await throwIfError(res);
+        return res.json();
+    },
+    async put(path, body) {
+        const res = await fetch(`${_baseUrl}${path}`, {
+            method: "PUT",
+            headers: getHeaders(),
+            body: JSON.stringify(body),
+        });
+        await throwIfError(res);
+        return res.json();
+    },
+    async patch(path, body) {
+        const res = await fetch(`${_baseUrl}${path}`, {
+            method: "PATCH",
+            headers: getHeaders(),
+            body: JSON.stringify(body),
+        });
+        await throwIfError(res);
+        return res.json();
+    },
+    async delete(path) {
+        const res = await fetch(`${_baseUrl}${path}`, {
+            method: "DELETE",
+            headers: getHeaders(),
+        });
+        await throwIfError(res);
+        return res.json();
+    },
+};
+//# sourceMappingURL=apiClient.js.map

package/dist/services/apiClient.js.map

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