fix: make DevTools opt-in to avoid conflicts with consuming apps

- Add enableDevTools prop to StacApiProvider (defaults to false)
- Remove automatic DevTools exposure in development mode
- Make window.__TANSTACK_QUERY_CLIENT__ optional to prevent type conflicts
- Update example app to enable DevTools in development

This prevents the library from overwriting QueryClient instances in consuming
applications while still allowing opt-in DevTools support.

Author: AliceR

example/src/App.jsx

@@ -4,8 +4,10 @@ import Main from './pages/Main';
 
 function App() {
   const apiUrl = process.env.REACT_APP_STAC_API;
+  const isDevelopment = process.env.NODE_ENV === 'development';
+
   return (
-    <StacApiProvider apiUrl={apiUrl}>
+    <StacApiProvider apiUrl={apiUrl} enableDevTools={isDevelopment}>
       <div className="App grid grid-rows-[min-content_1fr]">
         <Header />
         <main className="flex items-stretch">

src/context/index.tsx

@@ -11,6 +11,7 @@ type StacApiProviderType = {
   children: React.ReactNode;
   options?: GenericObject;
   queryClient?: QueryClient;
+  enableDevTools?: boolean;
 };
 
 function StacApiProviderInner({
@@ -55,11 +56,17 @@ function StacApiProviderInner({
   return <StacApiContext.Provider value={contextValue}>{children}</StacApiContext.Provider>;
 }
 
-export function StacApiProvider({ children, apiUrl, options, queryClient }: StacApiProviderType) {
+export function StacApiProvider({
+  children,
+  apiUrl,
+  options,
+  queryClient,
+  enableDevTools,
+}: StacApiProviderType) {
   const defaultClient = useMemo(() => new QueryClient(), []);
   const client: QueryClient = queryClient ?? defaultClient;
 
-  if (typeof window !== 'undefined' && process.env.NODE_ENV === 'development') {
+  if (enableDevTools && typeof window !== 'undefined') {
     // Connect TanStack Query DevTools (browser extension)
     window.__TANSTACK_QUERY_CLIENT__ = client;
   }
@@ -75,6 +82,6 @@ export function StacApiProvider({ children, apiUrl, options, queryClient }: Stac
 
 declare global {
   interface Window {
-    __TANSTACK_QUERY_CLIENT__: import('@tanstack/query-core').QueryClient;
+    __TANSTACK_QUERY_CLIENT__?: import('@tanstack/query-core').QueryClient;
   }
 }