@mimdb/react 0.1.0

package/dist/index.cjs

@@ -0,0 +1,265 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  MimDBProvider: () => MimDBProvider,
+  useAuth: () => useAuth,
+  useClient: () => useClient,
+  useDelete: () => useDelete,
+  useInsert: () => useInsert,
+  useQuery: () => useQuery,
+  useRealtime: () => useRealtime,
+  useUpdate: () => useUpdate,
+  useUpload: () => useUpload
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/context.ts
+var import_react = require("react");
+var MimDBContext = (0, import_react.createContext)(null);
+function useClient() {
+  const client = (0, import_react.useContext)(MimDBContext);
+  if (!client) {
+    throw new Error("useClient must be used within <MimDBProvider>");
+  }
+  return client;
+}
+
+// src/provider.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function MimDBProvider({ client, children }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(MimDBContext.Provider, { value: client, children });
+}
+
+// src/use-query.ts
+var import_react_query = require("@tanstack/react-query");
+function useQuery(table, options) {
+  const client = useClient();
+  return (0, import_react_query.useQuery)({
+    queryKey: ["mimdb", table, options],
+    queryFn: async () => {
+      let query = client.from(table).select(options?.select ?? "*");
+      if (options?.eq) {
+        for (const [col, val] of Object.entries(options.eq)) {
+          query = query.eq(col, val);
+        }
+      }
+      if (options?.neq) {
+        for (const [col, val] of Object.entries(options.neq)) {
+          query = query.neq(col, val);
+        }
+      }
+      if (options?.order) {
+        query = query.order(options.order.column, {
+          ascending: options.order.ascending
+        });
+      }
+      if (options?.limit) query = query.limit(options.limit);
+      if (options?.offset) query = query.offset(options.offset);
+      const { data, error } = await query;
+      if (error) throw error;
+      return data ?? [];
+    },
+    enabled: options?.enabled,
+    staleTime: options?.staleTime,
+    refetchInterval: options?.refetchInterval
+  });
+}
+
+// src/use-mutation.ts
+var import_react_query2 = require("@tanstack/react-query");
+function useInsert(table) {
+  const client = useClient();
+  const queryClient = (0, import_react_query2.useQueryClient)();
+  return (0, import_react_query2.useMutation)({
+    mutationFn: async (data) => {
+      const { data: result, error } = await client.from(table).insert(data).select().single();
+      if (error) throw error;
+      return result;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["mimdb", table] });
+    }
+  });
+}
+function useUpdate(table) {
+  const client = useClient();
+  const queryClient = (0, import_react_query2.useQueryClient)();
+  return (0, import_react_query2.useMutation)({
+    mutationFn: async ({ data, eq }) => {
+      let query = client.from(table).update(data);
+      for (const [col, val] of Object.entries(eq)) {
+        query = query.eq(col, val);
+      }
+      const { data: result, error } = await query.select().single();
+      if (error) throw error;
+      return result;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["mimdb", table] });
+    }
+  });
+}
+function useDelete(table) {
+  const client = useClient();
+  const queryClient = (0, import_react_query2.useQueryClient)();
+  return (0, import_react_query2.useMutation)({
+    mutationFn: async (eq) => {
+      let query = client.from(table).delete();
+      for (const [col, val] of Object.entries(eq)) {
+        query = query.eq(col, val);
+      }
+      const { error } = await query;
+      if (error) throw error;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["mimdb", table] });
+    }
+  });
+}
+
+// src/use-realtime.ts
+var import_react2 = require("react");
+var import_react_query3 = require("@tanstack/react-query");
+var import_realtime = require("@mimdb/realtime");
+function useRealtime(table, options) {
+  const client = useClient();
+  const queryClient = (0, import_react_query3.useQueryClient)();
+  const [status, setStatus] = (0, import_react2.useState)("pending");
+  const realtimeRef = (0, import_react2.useRef)(null);
+  (0, import_react2.useEffect)(() => {
+    const config = client.getConfig();
+    if (!realtimeRef.current) {
+      realtimeRef.current = new import_realtime.MimDBRealtimeClient({
+        url: config.url,
+        projectRef: config.ref,
+        apiKey: config.apiKey
+      });
+    }
+    const sub = realtimeRef.current.subscribe(table, {
+      event: options?.event ?? "*",
+      filter: options?.filter,
+      onEvent(event) {
+        options?.onEvent?.(event);
+        if (options?.invalidateQueries !== false) {
+          queryClient.invalidateQueries({ queryKey: ["mimdb", table] });
+        }
+      },
+      onSubscribed() {
+        setStatus("active");
+      },
+      onError() {
+        setStatus("error");
+      }
+    });
+    setStatus("pending");
+    return () => {
+      sub.unsubscribe();
+      setStatus("closed");
+    };
+  }, [table, options?.event, options?.filter]);
+  return { status };
+}
+
+// src/use-auth.ts
+var import_react3 = require("react");
+function useAuth() {
+  const client = useClient();
+  const [user, setUser] = (0, import_react3.useState)(null);
+  const [isLoading, setIsLoading] = (0, import_react3.useState)(true);
+  (0, import_react3.useEffect)(() => {
+    const session = client.auth.getSession();
+    if (session) {
+      client.auth.getUser().then(setUser).catch(() => setUser(null)).finally(() => setIsLoading(false));
+    } else {
+      setIsLoading(false);
+    }
+    const unsub = client.auth.onAuthStateChange((event, _session) => {
+      if (event === "SIGNED_IN" || event === "TOKEN_REFRESHED") {
+        client.auth.getUser().then(setUser).catch(() => setUser(null));
+      } else if (event === "SIGNED_OUT") {
+        setUser(null);
+      }
+    });
+    return unsub;
+  }, [client]);
+  const signIn = (0, import_react3.useCallback)(
+    async (email, password) => {
+      await client.auth.signIn(email, password);
+    },
+    [client]
+  );
+  const signUp = (0, import_react3.useCallback)(
+    async (email, password) => {
+      await client.auth.signUp(email, password);
+    },
+    [client]
+  );
+  const signOut = (0, import_react3.useCallback)(async () => {
+    await client.auth.signOut();
+  }, [client]);
+  const signInWithOAuth = (0, import_react3.useCallback)(
+    (provider, opts) => {
+      const url = client.auth.signInWithOAuth(provider, opts);
+      window.location.href = url;
+    },
+    [client]
+  );
+  return { user, isLoading, signIn, signUp, signOut, signInWithOAuth };
+}
+
+// src/use-upload.ts
+var import_react4 = require("react");
+function useUpload(bucket) {
+  const client = useClient();
+  const [isUploading, setIsUploading] = (0, import_react4.useState)(false);
+  const [error, setError] = (0, import_react4.useState)(null);
+  const upload = (0, import_react4.useCallback)(
+    async (path, file, opts) => {
+      setIsUploading(true);
+      setError(null);
+      try {
+        await client.storage.from(bucket).upload(path, file, opts);
+      } catch (err) {
+        const uploadError = err instanceof Error ? err : new Error(String(err));
+        setError(uploadError);
+        throw uploadError;
+      } finally {
+        setIsUploading(false);
+      }
+    },
+    [client, bucket]
+  );
+  return { upload, isUploading, error };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MimDBProvider,
+  useAuth,
+  useClient,
+  useDelete,
+  useInsert,
+  useQuery,
+  useRealtime,
+  useUpdate,
+  useUpload
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/context.ts","../src/provider.tsx","../src/use-query.ts","../src/use-mutation.ts","../src/use-realtime.ts","../src/use-auth.ts","../src/use-upload.ts"],"sourcesContent":["export { MimDBProvider, type MimDBProviderProps } from './provider'\nexport { useClient } from './context'\nexport { useQuery, type UseQueryOptions } from './use-query'\nexport { useInsert, useUpdate, useDelete, type UpdateInput } from './use-mutation'\nexport { useRealtime, type UseRealtimeOptions } from './use-realtime'\nexport { useAuth, type UseAuthResult } from './use-auth'\nexport { useUpload, type UseUploadResult } from './use-upload'\n","import { createContext, useContext } from 'react'\nimport type { MimDBClient } from '@mimdb/client'\n\n/**\n * React context that holds the MimDB client instance.\n *\n * Consumers should use the {@link useClient} hook rather than accessing\n * this context directly.\n *\n * @internal\n */\nconst MimDBContext = createContext<MimDBClient | null>(null)\n\n/**\n * Retrieve the MimDB client from the nearest `<MimDBProvider>`.\n *\n * @returns The `MimDBClient` instance provided by the enclosing provider.\n * @throws If called outside of a `<MimDBProvider>` tree.\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const client = useClient()\n *   // Use client.from(), client.auth, etc.\n * }\n * ```\n */\nexport function useClient(): MimDBClient {\n  const client = useContext(MimDBContext)\n  if (!client) {\n    throw new Error('useClient must be used within <MimDBProvider>')\n  }\n  return client\n}\n\nexport { MimDBContext }\n","import { type ReactNode } from 'react'\nimport { MimDBContext } from './context'\nimport type { MimDBClient } from '@mimdb/client'\n\n/**\n * Props for the {@link MimDBProvider} component.\n */\nexport interface MimDBProviderProps {\n  /** A configured `MimDBClient` instance to make available to child components. */\n  client: MimDBClient\n  /** The React subtree that will have access to the MimDB client. */\n  children: ReactNode\n}\n\n/**\n * Context provider that makes a `MimDBClient` available to all descendant\n * components via the {@link useClient} hook.\n *\n * Wrap your application (or a subtree) with this provider and pass a\n * pre-configured client instance.\n *\n * @param props - Provider props containing the client and children.\n *\n * @example\n * ```tsx\n * import { createClient } from '@mimdb/client'\n * import { MimDBProvider } from '@mimdb/react'\n *\n * const client = createClient('https://api.mimdb.dev', 'ref', 'key')\n *\n * function App() {\n *   return (\n *     <MimDBProvider client={client}>\n *       <MyApp />\n *     </MimDBProvider>\n *   )\n * }\n * ```\n */\nexport function MimDBProvider({ client, children }: MimDBProviderProps) {\n  return <MimDBContext.Provider value={client}>{children}</MimDBContext.Provider>\n}\n","import {\n  useQuery as useTanstackQuery,\n  type UseQueryResult,\n} from '@tanstack/react-query'\nimport { useClient } from './context'\n\n/**\n * Options for the {@link useQuery} hook.\n */\nexport interface UseQueryOptions {\n  /** Column selection string (PostgREST format). Defaults to `'*'`. */\n  select?: string\n  /** Equality filters applied as `query.eq(column, value)`. */\n  eq?: Record<string, string>\n  /** Not-equal filters applied as `query.neq(column, value)`. */\n  neq?: Record<string, string>\n  /** Column ordering configuration. */\n  order?: { column: string; ascending?: boolean }\n  /** Maximum number of rows to return. */\n  limit?: number\n  /** Number of rows to skip before returning results. */\n  offset?: number\n  /** Whether the query should execute. Maps to TanStack Query's `enabled`. */\n  enabled?: boolean\n  /** Duration in ms before cached data is considered stale. */\n  staleTime?: number\n  /** Polling interval in ms, or `false` to disable. */\n  refetchInterval?: number | false\n}\n\n/**\n * Fetch rows from a MimDB table using the REST API, backed by TanStack Query\n * for caching, deduplication, and background refetching.\n *\n * Automatically derives a stable query key from the table name and options\n * so cache invalidation works out of the box with the mutation hooks.\n *\n * @typeParam T - Expected row type. Defaults to a generic record.\n * @param table   - Name of the database table to query.\n * @param options - Query filters, modifiers, and TanStack Query settings.\n * @returns A TanStack `UseQueryResult` containing the row array and status flags.\n *\n * @example\n * ```tsx\n * const { data, isLoading } = useQuery<Todo>('todos', {\n *   eq: { done: 'false' },\n *   order: { column: 'created_at', ascending: false },\n *   limit: 20,\n * })\n * ```\n */\nexport function useQuery<T = Record<string, unknown>>(\n  table: string,\n  options?: UseQueryOptions,\n): UseQueryResult<T[], Error> {\n  const client = useClient()\n\n  return useTanstackQuery({\n    queryKey: ['mimdb', table, options],\n    queryFn: async () => {\n      let query = client.from<T>(table).select(options?.select ?? '*')\n\n      if (options?.eq) {\n        for (const [col, val] of Object.entries(options.eq)) {\n          query = query.eq(col, val)\n        }\n      }\n      if (options?.neq) {\n        for (const [col, val] of Object.entries(options.neq)) {\n          query = query.neq(col, val)\n        }\n      }\n      if (options?.order) {\n        query = query.order(options.order.column, {\n          ascending: options.order.ascending,\n        })\n      }\n      if (options?.limit) query = query.limit(options.limit)\n      if (options?.offset) query = query.offset(options.offset)\n\n      const { data, error } = await query\n      if (error) throw error\n      return (data ?? []) as T[]\n    },\n    enabled: options?.enabled,\n    staleTime: options?.staleTime,\n    refetchInterval: options?.refetchInterval,\n  })\n}\n","import {\n  useMutation as useTanstackMutation,\n  useQueryClient,\n  type UseMutationResult,\n} from '@tanstack/react-query'\nimport { useClient } from './context'\nimport type { MimDBError } from '@mimdb/client'\n\n/**\n * React hook for inserting a row into a MimDB table.\n *\n * On success, all `useQuery` caches for the same table are automatically\n * invalidated so lists stay in sync.\n *\n * @typeParam T - Expected row type. Defaults to a generic record.\n * @param table - Name of the database table.\n * @returns A TanStack `UseMutationResult` whose `mutate` / `mutateAsync`\n *          accepts a partial row to insert.\n *\n * @example\n * ```tsx\n * const insert = useInsert<Todo>('todos')\n * insert.mutate({ task: 'Buy milk', done: false })\n * ```\n */\nexport function useInsert<T = Record<string, unknown>>(\n  table: string,\n): UseMutationResult<T, MimDBError, Partial<T>> {\n  const client = useClient()\n  const queryClient = useQueryClient()\n\n  return useTanstackMutation({\n    mutationFn: async (data: Partial<T>) => {\n      const { data: result, error } = await client\n        .from<T>(table)\n        .insert(data)\n        .select()\n        .single()\n      if (error) throw error\n      return result as T\n    },\n    onSuccess: () => {\n      queryClient.invalidateQueries({ queryKey: ['mimdb', table] })\n    },\n  })\n}\n\n/**\n * Input shape for the {@link useUpdate} mutation.\n *\n * @typeParam T - Expected row type.\n */\nexport interface UpdateInput<T> {\n  /** Fields to update. */\n  data: Partial<T>\n  /** Equality filters identifying which rows to update. */\n  eq: Record<string, string>\n}\n\n/**\n * React hook for updating rows in a MimDB table.\n *\n * The mutation function accepts an object with `data` (fields to set) and\n * `eq` (equality filters to target specific rows). On success, all\n * `useQuery` caches for the same table are invalidated.\n *\n * @typeParam T - Expected row type. Defaults to a generic record.\n * @param table - Name of the database table.\n * @returns A TanStack `UseMutationResult`.\n *\n * @example\n * ```tsx\n * const update = useUpdate<Todo>('todos')\n * update.mutate({ data: { done: true }, eq: { id: '42' } })\n * ```\n */\nexport function useUpdate<T = Record<string, unknown>>(\n  table: string,\n): UseMutationResult<T, MimDBError, UpdateInput<T>> {\n  const client = useClient()\n  const queryClient = useQueryClient()\n\n  return useTanstackMutation({\n    mutationFn: async ({ data, eq }: UpdateInput<T>) => {\n      let query = client.from<T>(table).update(data)\n      for (const [col, val] of Object.entries(eq)) {\n        query = query.eq(col, val)\n      }\n      const { data: result, error } = await query.select().single()\n      if (error) throw error\n      return result as T\n    },\n    onSuccess: () => {\n      queryClient.invalidateQueries({ queryKey: ['mimdb', table] })\n    },\n  })\n}\n\n/**\n * React hook for deleting rows from a MimDB table.\n *\n * The mutation function accepts equality filters identifying which rows\n * to delete. On success, all `useQuery` caches for the same table are\n * invalidated.\n *\n * @param table - Name of the database table.\n * @returns A TanStack `UseMutationResult` whose `mutate` accepts equality filters.\n *\n * @example\n * ```tsx\n * const del = useDelete('todos')\n * del.mutate({ id: '42' })\n * ```\n */\nexport function useDelete(\n  table: string,\n): UseMutationResult<void, MimDBError, Record<string, string>> {\n  const client = useClient()\n  const queryClient = useQueryClient()\n\n  return useTanstackMutation({\n    mutationFn: async (eq: Record<string, string>) => {\n      let query = client.from(table).delete()\n      for (const [col, val] of Object.entries(eq)) {\n        query = query.eq(col, val)\n      }\n      const { error } = await query\n      if (error) throw error\n    },\n    onSuccess: () => {\n      queryClient.invalidateQueries({ queryKey: ['mimdb', table] })\n    },\n  })\n}\n","import { useEffect, useRef, useState } from 'react'\nimport { useQueryClient } from '@tanstack/react-query'\nimport {\n  MimDBRealtimeClient,\n  type RealtimeEvent,\n  type SubscriptionStatus,\n} from '@mimdb/realtime'\nimport { useClient } from './context'\n\n/**\n * Options for the {@link useRealtime} hook.\n *\n * @typeParam T - Expected row type for realtime events.\n */\nexport interface UseRealtimeOptions<T = Record<string, unknown>> {\n  /** Event type filter. Defaults to `'*'` (all events). */\n  event?: '*' | 'INSERT' | 'UPDATE' | 'DELETE'\n  /** Row filter expression (e.g. `'user_id=eq.42'`). */\n  filter?: string\n  /** Called for each matching realtime event. */\n  onEvent?: (event: RealtimeEvent<T>) => void\n  /**\n   * Whether to automatically invalidate the table's TanStack Query cache\n   * when an event is received. Defaults to `true`.\n   */\n  invalidateQueries?: boolean\n}\n\n/**\n * Subscribe to realtime database changes for a table via WebSocket.\n *\n * Creates a `MimDBRealtimeClient` using the connection config from\n * `MimDBClient.getConfig()` and subscribes to the specified table.\n * On each event, the table's TanStack Query cache is invalidated\n * (unless opted out) so queries refetch automatically.\n *\n * The subscription is cleaned up when the component unmounts or when\n * the `table`, `event`, or `filter` options change.\n *\n * @typeParam T - Expected row type for realtime events.\n * @param table   - Database table to subscribe to.\n * @param options - Event filters and callbacks.\n * @returns An object containing the current subscription status.\n *\n * @example\n * ```tsx\n * const { status } = useRealtime<Message>('messages', {\n *   event: 'INSERT',\n *   onEvent: (e) => console.log('New message:', e.new),\n * })\n * ```\n */\nexport function useRealtime<T = Record<string, unknown>>(\n  table: string,\n  options?: UseRealtimeOptions<T>,\n): { status: SubscriptionStatus } {\n  const client = useClient()\n  const queryClient = useQueryClient()\n  const [status, setStatus] = useState<SubscriptionStatus>('pending')\n  const realtimeRef = useRef<MimDBRealtimeClient | null>(null)\n\n  useEffect(() => {\n    const config = client.getConfig()\n\n    if (!realtimeRef.current) {\n      realtimeRef.current = new MimDBRealtimeClient({\n        url: config.url,\n        projectRef: config.ref,\n        apiKey: config.apiKey,\n      })\n    }\n\n    const sub = realtimeRef.current.subscribe<T>(table, {\n      event: options?.event ?? '*',\n      filter: options?.filter,\n      onEvent(event) {\n        options?.onEvent?.(event)\n        if (options?.invalidateQueries !== false) {\n          queryClient.invalidateQueries({ queryKey: ['mimdb', table] })\n        }\n      },\n      onSubscribed() {\n        setStatus('active')\n      },\n      onError() {\n        setStatus('error')\n      },\n    })\n\n    setStatus('pending')\n\n    return () => {\n      sub.unsubscribe()\n      setStatus('closed')\n    }\n  }, [table, options?.event, options?.filter]) // eslint-disable-line react-hooks/exhaustive-deps\n\n  return { status }\n}\n","import { useState, useEffect, useCallback } from 'react'\nimport { useClient } from './context'\nimport type { User } from '@mimdb/client'\n\n/**\n * Return type of the {@link useAuth} hook.\n */\nexport interface UseAuthResult {\n  /** The currently authenticated user, or null if signed out. */\n  user: User | null\n  /** True while the initial session check is in progress. */\n  isLoading: boolean\n  /** Sign in with email and password. */\n  signIn: (email: string, password: string) => Promise<void>\n  /** Create a new account with email and password. */\n  signUp: (email: string, password: string) => Promise<void>\n  /** Sign out the current user. */\n  signOut: () => Promise<void>\n  /** Redirect to an OAuth provider's authorization page. */\n  signInWithOAuth: (provider: string, opts: { redirectTo: string }) => void\n}\n\n/**\n * React hook for authentication state management.\n *\n * On mount, checks for an existing session and fetches the current user.\n * Subscribes to auth state changes so the returned `user` stays in sync\n * with sign-in, sign-out, and token refresh events.\n *\n * @returns An object with the current user, loading state, and auth methods.\n *\n * @example\n * ```tsx\n * function LoginPage() {\n *   const { user, isLoading, signIn, signOut } = useAuth()\n *\n *   if (isLoading) return <p>Loading...</p>\n *   if (user) return <button onClick={signOut}>Sign Out</button>\n *\n *   return (\n *     <button onClick={() => signIn('user@example.com', 'password')}>\n *       Sign In\n *     </button>\n *   )\n * }\n * ```\n */\nexport function useAuth(): UseAuthResult {\n  const client = useClient()\n  const [user, setUser] = useState<User | null>(null)\n  const [isLoading, setIsLoading] = useState(true)\n\n  useEffect(() => {\n    const session = client.auth.getSession()\n    if (session) {\n      client.auth\n        .getUser()\n        .then(setUser)\n        .catch(() => setUser(null))\n        .finally(() => setIsLoading(false))\n    } else {\n      setIsLoading(false)\n    }\n\n    const unsub = client.auth.onAuthStateChange((event, _session) => {\n      if (event === 'SIGNED_IN' || event === 'TOKEN_REFRESHED') {\n        client.auth\n          .getUser()\n          .then(setUser)\n          .catch(() => setUser(null))\n      } else if (event === 'SIGNED_OUT') {\n        setUser(null)\n      }\n    })\n\n    return unsub\n  }, [client])\n\n  const signIn = useCallback(\n    async (email: string, password: string) => {\n      await client.auth.signIn(email, password)\n    },\n    [client],\n  )\n\n  const signUp = useCallback(\n    async (email: string, password: string) => {\n      await client.auth.signUp(email, password)\n    },\n    [client],\n  )\n\n  const signOut = useCallback(async () => {\n    await client.auth.signOut()\n  }, [client])\n\n  const signInWithOAuth = useCallback(\n    (provider: string, opts: { redirectTo: string }) => {\n      const url = client.auth.signInWithOAuth(provider, opts)\n      window.location.href = url\n    },\n    [client],\n  )\n\n  return { user, isLoading, signIn, signUp, signOut, signInWithOAuth }\n}\n","import { useState, useCallback } from 'react'\nimport { useClient } from './context'\nimport type { UploadOptions } from '@mimdb/client'\n\n/**\n * Return type of the {@link useUpload} hook.\n */\nexport interface UseUploadResult {\n  /** Upload a file to the bucket. Re-throws on failure after setting `error`. */\n  upload: (path: string, file: Blob | File, opts?: UploadOptions) => Promise<void>\n  /** True while an upload is in progress. */\n  isUploading: boolean\n  /** The error from the most recent failed upload, or null. */\n  error: Error | null\n}\n\n/**\n * React hook for uploading files to a MimDB storage bucket.\n *\n * Tracks the upload's loading and error state so components can show\n * progress indicators or error messages without manual state management.\n *\n * @param bucket - Name of the storage bucket to upload to.\n * @returns An object with the `upload` function and status flags.\n *\n * @example\n * ```tsx\n * function AvatarUpload() {\n *   const { upload, isUploading, error } = useUpload('avatars')\n *\n *   const handleFile = (file: File) => {\n *     upload(`users/${userId}/avatar.png`, file, { contentType: 'image/png' })\n *   }\n *\n *   return (\n *     <>\n *       <input type=\"file\" onChange={(e) => handleFile(e.target.files![0])} />\n *       {isUploading && <p>Uploading...</p>}\n *       {error && <p>Error: {error.message}</p>}\n *     </>\n *   )\n * }\n * ```\n */\nexport function useUpload(bucket: string): UseUploadResult {\n  const client = useClient()\n  const [isUploading, setIsUploading] = useState(false)\n  const [error, setError] = useState<Error | null>(null)\n\n  const upload = useCallback(\n    async (path: string, file: Blob | File, opts?: UploadOptions) => {\n      setIsUploading(true)\n      setError(null)\n      try {\n        await client.storage.from(bucket).upload(path, file, opts)\n      } catch (err) {\n        const uploadError =\n          err instanceof Error ? err : new Error(String(err))\n        setError(uploadError)\n        throw uploadError\n      } finally {\n        setIsUploading(false)\n      }\n    },\n    [client, bucket],\n  )\n\n  return { upload, isUploading, error }\n}\n"],"mappings":"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","names":["useTanstackQuery","import_react_query","useTanstackMutation","import_react","import_react_query","import_react","import_react"]}

package/dist/index.d.cts

@@ -0,0 +1,306 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { MimDBClient, MimDBError, User, UploadOptions } from '@mimdb/client';
+import { UseQueryResult, UseMutationResult } from '@tanstack/react-query';
+import { RealtimeEvent, SubscriptionStatus } from '@mimdb/realtime';
+
+/**
+ * Props for the {@link MimDBProvider} component.
+ */
+interface MimDBProviderProps {
+    /** A configured `MimDBClient` instance to make available to child components. */
+    client: MimDBClient;
+    /** The React subtree that will have access to the MimDB client. */
+    children: ReactNode;
+}
+/**
+ * Context provider that makes a `MimDBClient` available to all descendant
+ * components via the {@link useClient} hook.
+ *
+ * Wrap your application (or a subtree) with this provider and pass a
+ * pre-configured client instance.
+ *
+ * @param props - Provider props containing the client and children.
+ *
+ * @example
+ * ```tsx
+ * import { createClient } from '@mimdb/client'
+ * import { MimDBProvider } from '@mimdb/react'
+ *
+ * const client = createClient('https://api.mimdb.dev', 'ref', 'key')
+ *
+ * function App() {
+ *   return (
+ *     <MimDBProvider client={client}>
+ *       <MyApp />
+ *     </MimDBProvider>
+ *   )
+ * }
+ * ```
+ */
+declare function MimDBProvider({ client, children }: MimDBProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Retrieve the MimDB client from the nearest `<MimDBProvider>`.
+ *
+ * @returns The `MimDBClient` instance provided by the enclosing provider.
+ * @throws If called outside of a `<MimDBProvider>` tree.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const client = useClient()
+ *   // Use client.from(), client.auth, etc.
+ * }
+ * ```
+ */
+declare function useClient(): MimDBClient;
+
+/**
+ * Options for the {@link useQuery} hook.
+ */
+interface UseQueryOptions {
+    /** Column selection string (PostgREST format). Defaults to `'*'`. */
+    select?: string;
+    /** Equality filters applied as `query.eq(column, value)`. */
+    eq?: Record<string, string>;
+    /** Not-equal filters applied as `query.neq(column, value)`. */
+    neq?: Record<string, string>;
+    /** Column ordering configuration. */
+    order?: {
+        column: string;
+        ascending?: boolean;
+    };
+    /** Maximum number of rows to return. */
+    limit?: number;
+    /** Number of rows to skip before returning results. */
+    offset?: number;
+    /** Whether the query should execute. Maps to TanStack Query's `enabled`. */
+    enabled?: boolean;
+    /** Duration in ms before cached data is considered stale. */
+    staleTime?: number;
+    /** Polling interval in ms, or `false` to disable. */
+    refetchInterval?: number | false;
+}
+/**
+ * Fetch rows from a MimDB table using the REST API, backed by TanStack Query
+ * for caching, deduplication, and background refetching.
+ *
+ * Automatically derives a stable query key from the table name and options
+ * so cache invalidation works out of the box with the mutation hooks.
+ *
+ * @typeParam T - Expected row type. Defaults to a generic record.
+ * @param table   - Name of the database table to query.
+ * @param options - Query filters, modifiers, and TanStack Query settings.
+ * @returns A TanStack `UseQueryResult` containing the row array and status flags.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useQuery<Todo>('todos', {
+ *   eq: { done: 'false' },
+ *   order: { column: 'created_at', ascending: false },
+ *   limit: 20,
+ * })
+ * ```
+ */
+declare function useQuery<T = Record<string, unknown>>(table: string, options?: UseQueryOptions): UseQueryResult<T[], Error>;
+
+/**
+ * React hook for inserting a row into a MimDB table.
+ *
+ * On success, all `useQuery` caches for the same table are automatically
+ * invalidated so lists stay in sync.
+ *
+ * @typeParam T - Expected row type. Defaults to a generic record.
+ * @param table - Name of the database table.
+ * @returns A TanStack `UseMutationResult` whose `mutate` / `mutateAsync`
+ *          accepts a partial row to insert.
+ *
+ * @example
+ * ```tsx
+ * const insert = useInsert<Todo>('todos')
+ * insert.mutate({ task: 'Buy milk', done: false })
+ * ```
+ */
+declare function useInsert<T = Record<string, unknown>>(table: string): UseMutationResult<T, MimDBError, Partial<T>>;
+/**
+ * Input shape for the {@link useUpdate} mutation.
+ *
+ * @typeParam T - Expected row type.
+ */
+interface UpdateInput<T> {
+    /** Fields to update. */
+    data: Partial<T>;
+    /** Equality filters identifying which rows to update. */
+    eq: Record<string, string>;
+}
+/**
+ * React hook for updating rows in a MimDB table.
+ *
+ * The mutation function accepts an object with `data` (fields to set) and
+ * `eq` (equality filters to target specific rows). On success, all
+ * `useQuery` caches for the same table are invalidated.
+ *
+ * @typeParam T - Expected row type. Defaults to a generic record.
+ * @param table - Name of the database table.
+ * @returns A TanStack `UseMutationResult`.
+ *
+ * @example
+ * ```tsx
+ * const update = useUpdate<Todo>('todos')
+ * update.mutate({ data: { done: true }, eq: { id: '42' } })
+ * ```
+ */
+declare function useUpdate<T = Record<string, unknown>>(table: string): UseMutationResult<T, MimDBError, UpdateInput<T>>;
+/**
+ * React hook for deleting rows from a MimDB table.
+ *
+ * The mutation function accepts equality filters identifying which rows
+ * to delete. On success, all `useQuery` caches for the same table are
+ * invalidated.
+ *
+ * @param table - Name of the database table.
+ * @returns A TanStack `UseMutationResult` whose `mutate` accepts equality filters.
+ *
+ * @example
+ * ```tsx
+ * const del = useDelete('todos')
+ * del.mutate({ id: '42' })
+ * ```
+ */
+declare function useDelete(table: string): UseMutationResult<void, MimDBError, Record<string, string>>;
+
+/**
+ * Options for the {@link useRealtime} hook.
+ *
+ * @typeParam T - Expected row type for realtime events.
+ */
+interface UseRealtimeOptions<T = Record<string, unknown>> {
+    /** Event type filter. Defaults to `'*'` (all events). */
+    event?: '*' | 'INSERT' | 'UPDATE' | 'DELETE';
+    /** Row filter expression (e.g. `'user_id=eq.42'`). */
+    filter?: string;
+    /** Called for each matching realtime event. */
+    onEvent?: (event: RealtimeEvent<T>) => void;
+    /**
+     * Whether to automatically invalidate the table's TanStack Query cache
+     * when an event is received. Defaults to `true`.
+     */
+    invalidateQueries?: boolean;
+}
+/**
+ * Subscribe to realtime database changes for a table via WebSocket.
+ *
+ * Creates a `MimDBRealtimeClient` using the connection config from
+ * `MimDBClient.getConfig()` and subscribes to the specified table.
+ * On each event, the table's TanStack Query cache is invalidated
+ * (unless opted out) so queries refetch automatically.
+ *
+ * The subscription is cleaned up when the component unmounts or when
+ * the `table`, `event`, or `filter` options change.
+ *
+ * @typeParam T - Expected row type for realtime events.
+ * @param table   - Database table to subscribe to.
+ * @param options - Event filters and callbacks.
+ * @returns An object containing the current subscription status.
+ *
+ * @example
+ * ```tsx
+ * const { status } = useRealtime<Message>('messages', {
+ *   event: 'INSERT',
+ *   onEvent: (e) => console.log('New message:', e.new),
+ * })
+ * ```
+ */
+declare function useRealtime<T = Record<string, unknown>>(table: string, options?: UseRealtimeOptions<T>): {
+    status: SubscriptionStatus;
+};
+
+/**
+ * Return type of the {@link useAuth} hook.
+ */
+interface UseAuthResult {
+    /** The currently authenticated user, or null if signed out. */
+    user: User | null;
+    /** True while the initial session check is in progress. */
+    isLoading: boolean;
+    /** Sign in with email and password. */
+    signIn: (email: string, password: string) => Promise<void>;
+    /** Create a new account with email and password. */
+    signUp: (email: string, password: string) => Promise<void>;
+    /** Sign out the current user. */
+    signOut: () => Promise<void>;
+    /** Redirect to an OAuth provider's authorization page. */
+    signInWithOAuth: (provider: string, opts: {
+        redirectTo: string;
+    }) => void;
+}
+/**
+ * React hook for authentication state management.
+ *
+ * On mount, checks for an existing session and fetches the current user.
+ * Subscribes to auth state changes so the returned `user` stays in sync
+ * with sign-in, sign-out, and token refresh events.
+ *
+ * @returns An object with the current user, loading state, and auth methods.
+ *
+ * @example
+ * ```tsx
+ * function LoginPage() {
+ *   const { user, isLoading, signIn, signOut } = useAuth()
+ *
+ *   if (isLoading) return <p>Loading...</p>
+ *   if (user) return <button onClick={signOut}>Sign Out</button>
+ *
+ *   return (
+ *     <button onClick={() => signIn('user@example.com', 'password')}>
+ *       Sign In
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+declare function useAuth(): UseAuthResult;
+
+/**
+ * Return type of the {@link useUpload} hook.
+ */
+interface UseUploadResult {
+    /** Upload a file to the bucket. Re-throws on failure after setting `error`. */
+    upload: (path: string, file: Blob | File, opts?: UploadOptions) => Promise<void>;
+    /** True while an upload is in progress. */
+    isUploading: boolean;
+    /** The error from the most recent failed upload, or null. */
+    error: Error | null;
+}
+/**
+ * React hook for uploading files to a MimDB storage bucket.
+ *
+ * Tracks the upload's loading and error state so components can show
+ * progress indicators or error messages without manual state management.
+ *
+ * @param bucket - Name of the storage bucket to upload to.
+ * @returns An object with the `upload` function and status flags.
+ *
+ * @example
+ * ```tsx
+ * function AvatarUpload() {
+ *   const { upload, isUploading, error } = useUpload('avatars')
+ *
+ *   const handleFile = (file: File) => {
+ *     upload(`users/${userId}/avatar.png`, file, { contentType: 'image/png' })
+ *   }
+ *
+ *   return (
+ *     <>
+ *       <input type="file" onChange={(e) => handleFile(e.target.files![0])} />
+ *       {isUploading && <p>Uploading...</p>}
+ *       {error && <p>Error: {error.message}</p>}
+ *     </>
+ *   )
+ * }
+ * ```
+ */
+declare function useUpload(bucket: string): UseUploadResult;
+
+export { MimDBProvider, type MimDBProviderProps, type UpdateInput, type UseAuthResult, type UseQueryOptions, type UseRealtimeOptions, type UseUploadResult, useAuth, useClient, useDelete, useInsert, useQuery, useRealtime, useUpdate, useUpload };

package/dist/index.d.ts

@@ -0,0 +1,306 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { MimDBClient, MimDBError, User, UploadOptions } from '@mimdb/client';
+import { UseQueryResult, UseMutationResult } from '@tanstack/react-query';
+import { RealtimeEvent, SubscriptionStatus } from '@mimdb/realtime';
+
+/**
+ * Props for the {@link MimDBProvider} component.
+ */
+interface MimDBProviderProps {
+    /** A configured `MimDBClient` instance to make available to child components. */
+    client: MimDBClient;
+    /** The React subtree that will have access to the MimDB client. */
+    children: ReactNode;
+}
+/**
+ * Context provider that makes a `MimDBClient` available to all descendant
+ * components via the {@link useClient} hook.
+ *
+ * Wrap your application (or a subtree) with this provider and pass a
+ * pre-configured client instance.
+ *
+ * @param props - Provider props containing the client and children.
+ *
+ * @example
+ * ```tsx
+ * import { createClient } from '@mimdb/client'
+ * import { MimDBProvider } from '@mimdb/react'
+ *
+ * const client = createClient('https://api.mimdb.dev', 'ref', 'key')
+ *
+ * function App() {
+ *   return (
+ *     <MimDBProvider client={client}>
+ *       <MyApp />
+ *     </MimDBProvider>
+ *   )
+ * }
+ * ```
+ */
+declare function MimDBProvider({ client, children }: MimDBProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Retrieve the MimDB client from the nearest `<MimDBProvider>`.
+ *
+ * @returns The `MimDBClient` instance provided by the enclosing provider.
+ * @throws If called outside of a `<MimDBProvider>` tree.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const client = useClient()
+ *   // Use client.from(), client.auth, etc.
+ * }
+ * ```
+ */
+declare function useClient(): MimDBClient;
+
+/**
+ * Options for the {@link useQuery} hook.
+ */
+interface UseQueryOptions {
+    /** Column selection string (PostgREST format). Defaults to `'*'`. */
+    select?: string;
+    /** Equality filters applied as `query.eq(column, value)`. */
+    eq?: Record<string, string>;
+    /** Not-equal filters applied as `query.neq(column, value)`. */
+    neq?: Record<string, string>;
+    /** Column ordering configuration. */
+    order?: {
+        column: string;
+        ascending?: boolean;
+    };
+    /** Maximum number of rows to return. */
+    limit?: number;
+    /** Number of rows to skip before returning results. */
+    offset?: number;
+    /** Whether the query should execute. Maps to TanStack Query's `enabled`. */
+    enabled?: boolean;
+    /** Duration in ms before cached data is considered stale. */
+    staleTime?: number;
+    /** Polling interval in ms, or `false` to disable. */
+    refetchInterval?: number | false;
+}
+/**
+ * Fetch rows from a MimDB table using the REST API, backed by TanStack Query
+ * for caching, deduplication, and background refetching.
+ *
+ * Automatically derives a stable query key from the table name and options
+ * so cache invalidation works out of the box with the mutation hooks.
+ *
+ * @typeParam T - Expected row type. Defaults to a generic record.
+ * @param table   - Name of the database table to query.
+ * @param options - Query filters, modifiers, and TanStack Query settings.
+ * @returns A TanStack `UseQueryResult` containing the row array and status flags.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useQuery<Todo>('todos', {
+ *   eq: { done: 'false' },
+ *   order: { column: 'created_at', ascending: false },
+ *   limit: 20,
+ * })
+ * ```
+ */
+declare function useQuery<T = Record<string, unknown>>(table: string, options?: UseQueryOptions): UseQueryResult<T[], Error>;
+
+/**
+ * React hook for inserting a row into a MimDB table.
+ *
+ * On success, all `useQuery` caches for the same table are automatically
+ * invalidated so lists stay in sync.
+ *
+ * @typeParam T - Expected row type. Defaults to a generic record.
+ * @param table - Name of the database table.
+ * @returns A TanStack `UseMutationResult` whose `mutate` / `mutateAsync`
+ *          accepts a partial row to insert.
+ *
+ * @example
+ * ```tsx
+ * const insert = useInsert<Todo>('todos')
+ * insert.mutate({ task: 'Buy milk', done: false })
+ * ```
+ */
+declare function useInsert<T = Record<string, unknown>>(table: string): UseMutationResult<T, MimDBError, Partial<T>>;
+/**
+ * Input shape for the {@link useUpdate} mutation.
+ *
+ * @typeParam T - Expected row type.
+ */
+interface UpdateInput<T> {
+    /** Fields to update. */
+    data: Partial<T>;
+    /** Equality filters identifying which rows to update. */
+    eq: Record<string, string>;
+}
+/**
+ * React hook for updating rows in a MimDB table.
+ *
+ * The mutation function accepts an object with `data` (fields to set) and
+ * `eq` (equality filters to target specific rows). On success, all
+ * `useQuery` caches for the same table are invalidated.
+ *
+ * @typeParam T - Expected row type. Defaults to a generic record.
+ * @param table - Name of the database table.
+ * @returns A TanStack `UseMutationResult`.
+ *
+ * @example
+ * ```tsx
+ * const update = useUpdate<Todo>('todos')
+ * update.mutate({ data: { done: true }, eq: { id: '42' } })
+ * ```
+ */
+declare function useUpdate<T = Record<string, unknown>>(table: string): UseMutationResult<T, MimDBError, UpdateInput<T>>;
+/**
+ * React hook for deleting rows from a MimDB table.
+ *
+ * The mutation function accepts equality filters identifying which rows
+ * to delete. On success, all `useQuery` caches for the same table are
+ * invalidated.
+ *
+ * @param table - Name of the database table.
+ * @returns A TanStack `UseMutationResult` whose `mutate` accepts equality filters.
+ *
+ * @example
+ * ```tsx
+ * const del = useDelete('todos')
+ * del.mutate({ id: '42' })
+ * ```
+ */
+declare function useDelete(table: string): UseMutationResult<void, MimDBError, Record<string, string>>;
+
+/**
+ * Options for the {@link useRealtime} hook.
+ *
+ * @typeParam T - Expected row type for realtime events.
+ */
+interface UseRealtimeOptions<T = Record<string, unknown>> {
+    /** Event type filter. Defaults to `'*'` (all events). */
+    event?: '*' | 'INSERT' | 'UPDATE' | 'DELETE';
+    /** Row filter expression (e.g. `'user_id=eq.42'`). */
+    filter?: string;
+    /** Called for each matching realtime event. */
+    onEvent?: (event: RealtimeEvent<T>) => void;
+    /**
+     * Whether to automatically invalidate the table's TanStack Query cache
+     * when an event is received. Defaults to `true`.
+     */
+    invalidateQueries?: boolean;
+}
+/**
+ * Subscribe to realtime database changes for a table via WebSocket.
+ *
+ * Creates a `MimDBRealtimeClient` using the connection config from
+ * `MimDBClient.getConfig()` and subscribes to the specified table.
+ * On each event, the table's TanStack Query cache is invalidated
+ * (unless opted out) so queries refetch automatically.
+ *
+ * The subscription is cleaned up when the component unmounts or when
+ * the `table`, `event`, or `filter` options change.
+ *
+ * @typeParam T - Expected row type for realtime events.
+ * @param table   - Database table to subscribe to.
+ * @param options - Event filters and callbacks.
+ * @returns An object containing the current subscription status.
+ *
+ * @example
+ * ```tsx
+ * const { status } = useRealtime<Message>('messages', {
+ *   event: 'INSERT',
+ *   onEvent: (e) => console.log('New message:', e.new),
+ * })
+ * ```
+ */
+declare function useRealtime<T = Record<string, unknown>>(table: string, options?: UseRealtimeOptions<T>): {
+    status: SubscriptionStatus;
+};
+
+/**
+ * Return type of the {@link useAuth} hook.
+ */
+interface UseAuthResult {
+    /** The currently authenticated user, or null if signed out. */
+    user: User | null;
+    /** True while the initial session check is in progress. */
+    isLoading: boolean;
+    /** Sign in with email and password. */
+    signIn: (email: string, password: string) => Promise<void>;
+    /** Create a new account with email and password. */
+    signUp: (email: string, password: string) => Promise<void>;
+    /** Sign out the current user. */
+    signOut: () => Promise<void>;
+    /** Redirect to an OAuth provider's authorization page. */
+    signInWithOAuth: (provider: string, opts: {
+        redirectTo: string;
+    }) => void;
+}
+/**
+ * React hook for authentication state management.
+ *
+ * On mount, checks for an existing session and fetches the current user.
+ * Subscribes to auth state changes so the returned `user` stays in sync
+ * with sign-in, sign-out, and token refresh events.
+ *
+ * @returns An object with the current user, loading state, and auth methods.
+ *
+ * @example
+ * ```tsx
+ * function LoginPage() {
+ *   const { user, isLoading, signIn, signOut } = useAuth()
+ *
+ *   if (isLoading) return <p>Loading...</p>
+ *   if (user) return <button onClick={signOut}>Sign Out</button>
+ *
+ *   return (
+ *     <button onClick={() => signIn('user@example.com', 'password')}>
+ *       Sign In
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+declare function useAuth(): UseAuthResult;
+
+/**
+ * Return type of the {@link useUpload} hook.
+ */
+interface UseUploadResult {
+    /** Upload a file to the bucket. Re-throws on failure after setting `error`. */
+    upload: (path: string, file: Blob | File, opts?: UploadOptions) => Promise<void>;
+    /** True while an upload is in progress. */
+    isUploading: boolean;
+    /** The error from the most recent failed upload, or null. */
+    error: Error | null;
+}
+/**
+ * React hook for uploading files to a MimDB storage bucket.
+ *
+ * Tracks the upload's loading and error state so components can show
+ * progress indicators or error messages without manual state management.
+ *
+ * @param bucket - Name of the storage bucket to upload to.
+ * @returns An object with the `upload` function and status flags.
+ *
+ * @example
+ * ```tsx
+ * function AvatarUpload() {
+ *   const { upload, isUploading, error } = useUpload('avatars')
+ *
+ *   const handleFile = (file: File) => {
+ *     upload(`users/${userId}/avatar.png`, file, { contentType: 'image/png' })
+ *   }
+ *
+ *   return (
+ *     <>
+ *       <input type="file" onChange={(e) => handleFile(e.target.files![0])} />
+ *       {isUploading && <p>Uploading...</p>}
+ *       {error && <p>Error: {error.message}</p>}
+ *     </>
+ *   )
+ * }
+ * ```
+ */
+declare function useUpload(bucket: string): UseUploadResult;
+
+export { MimDBProvider, type MimDBProviderProps, type UpdateInput, type UseAuthResult, type UseQueryOptions, type UseRealtimeOptions, type UseUploadResult, useAuth, useClient, useDelete, useInsert, useQuery, useRealtime, useUpdate, useUpload };

package/dist/index.js

@@ -0,0 +1,237 @@
+// src/context.ts
+import { createContext, useContext } from "react";
+var MimDBContext = createContext(null);
+function useClient() {
+  const client = useContext(MimDBContext);
+  if (!client) {
+    throw new Error("useClient must be used within <MimDBProvider>");
+  }
+  return client;
+}
+
+// src/provider.tsx
+import { jsx } from "react/jsx-runtime";
+function MimDBProvider({ client, children }) {
+  return /* @__PURE__ */ jsx(MimDBContext.Provider, { value: client, children });
+}
+
+// src/use-query.ts
+import {
+  useQuery as useTanstackQuery
+} from "@tanstack/react-query";
+function useQuery(table, options) {
+  const client = useClient();
+  return useTanstackQuery({
+    queryKey: ["mimdb", table, options],
+    queryFn: async () => {
+      let query = client.from(table).select(options?.select ?? "*");
+      if (options?.eq) {
+        for (const [col, val] of Object.entries(options.eq)) {
+          query = query.eq(col, val);
+        }
+      }
+      if (options?.neq) {
+        for (const [col, val] of Object.entries(options.neq)) {
+          query = query.neq(col, val);
+        }
+      }
+      if (options?.order) {
+        query = query.order(options.order.column, {
+          ascending: options.order.ascending
+        });
+      }
+      if (options?.limit) query = query.limit(options.limit);
+      if (options?.offset) query = query.offset(options.offset);
+      const { data, error } = await query;
+      if (error) throw error;
+      return data ?? [];
+    },
+    enabled: options?.enabled,
+    staleTime: options?.staleTime,
+    refetchInterval: options?.refetchInterval
+  });
+}
+
+// src/use-mutation.ts
+import {
+  useMutation as useTanstackMutation,
+  useQueryClient
+} from "@tanstack/react-query";
+function useInsert(table) {
+  const client = useClient();
+  const queryClient = useQueryClient();
+  return useTanstackMutation({
+    mutationFn: async (data) => {
+      const { data: result, error } = await client.from(table).insert(data).select().single();
+      if (error) throw error;
+      return result;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["mimdb", table] });
+    }
+  });
+}
+function useUpdate(table) {
+  const client = useClient();
+  const queryClient = useQueryClient();
+  return useTanstackMutation({
+    mutationFn: async ({ data, eq }) => {
+      let query = client.from(table).update(data);
+      for (const [col, val] of Object.entries(eq)) {
+        query = query.eq(col, val);
+      }
+      const { data: result, error } = await query.select().single();
+      if (error) throw error;
+      return result;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["mimdb", table] });
+    }
+  });
+}
+function useDelete(table) {
+  const client = useClient();
+  const queryClient = useQueryClient();
+  return useTanstackMutation({
+    mutationFn: async (eq) => {
+      let query = client.from(table).delete();
+      for (const [col, val] of Object.entries(eq)) {
+        query = query.eq(col, val);
+      }
+      const { error } = await query;
+      if (error) throw error;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["mimdb", table] });
+    }
+  });
+}
+
+// src/use-realtime.ts
+import { useEffect, useRef, useState } from "react";
+import { useQueryClient as useQueryClient2 } from "@tanstack/react-query";
+import {
+  MimDBRealtimeClient
+} from "@mimdb/realtime";
+function useRealtime(table, options) {
+  const client = useClient();
+  const queryClient = useQueryClient2();
+  const [status, setStatus] = useState("pending");
+  const realtimeRef = useRef(null);
+  useEffect(() => {
+    const config = client.getConfig();
+    if (!realtimeRef.current) {
+      realtimeRef.current = new MimDBRealtimeClient({
+        url: config.url,
+        projectRef: config.ref,
+        apiKey: config.apiKey
+      });
+    }
+    const sub = realtimeRef.current.subscribe(table, {
+      event: options?.event ?? "*",
+      filter: options?.filter,
+      onEvent(event) {
+        options?.onEvent?.(event);
+        if (options?.invalidateQueries !== false) {
+          queryClient.invalidateQueries({ queryKey: ["mimdb", table] });
+        }
+      },
+      onSubscribed() {
+        setStatus("active");
+      },
+      onError() {
+        setStatus("error");
+      }
+    });
+    setStatus("pending");
+    return () => {
+      sub.unsubscribe();
+      setStatus("closed");
+    };
+  }, [table, options?.event, options?.filter]);
+  return { status };
+}
+
+// src/use-auth.ts
+import { useState as useState2, useEffect as useEffect2, useCallback } from "react";
+function useAuth() {
+  const client = useClient();
+  const [user, setUser] = useState2(null);
+  const [isLoading, setIsLoading] = useState2(true);
+  useEffect2(() => {
+    const session = client.auth.getSession();
+    if (session) {
+      client.auth.getUser().then(setUser).catch(() => setUser(null)).finally(() => setIsLoading(false));
+    } else {
+      setIsLoading(false);
+    }
+    const unsub = client.auth.onAuthStateChange((event, _session) => {
+      if (event === "SIGNED_IN" || event === "TOKEN_REFRESHED") {
+        client.auth.getUser().then(setUser).catch(() => setUser(null));
+      } else if (event === "SIGNED_OUT") {
+        setUser(null);
+      }
+    });
+    return unsub;
+  }, [client]);
+  const signIn = useCallback(
+    async (email, password) => {
+      await client.auth.signIn(email, password);
+    },
+    [client]
+  );
+  const signUp = useCallback(
+    async (email, password) => {
+      await client.auth.signUp(email, password);
+    },
+    [client]
+  );
+  const signOut = useCallback(async () => {
+    await client.auth.signOut();
+  }, [client]);
+  const signInWithOAuth = useCallback(
+    (provider, opts) => {
+      const url = client.auth.signInWithOAuth(provider, opts);
+      window.location.href = url;
+    },
+    [client]
+  );
+  return { user, isLoading, signIn, signUp, signOut, signInWithOAuth };
+}
+
+// src/use-upload.ts
+import { useState as useState3, useCallback as useCallback2 } from "react";
+function useUpload(bucket) {
+  const client = useClient();
+  const [isUploading, setIsUploading] = useState3(false);
+  const [error, setError] = useState3(null);
+  const upload = useCallback2(
+    async (path, file, opts) => {
+      setIsUploading(true);
+      setError(null);
+      try {
+        await client.storage.from(bucket).upload(path, file, opts);
+      } catch (err) {
+        const uploadError = err instanceof Error ? err : new Error(String(err));
+        setError(uploadError);
+        throw uploadError;
+      } finally {
+        setIsUploading(false);
+      }
+    },
+    [client, bucket]
+  );
+  return { upload, isUploading, error };
+}
+export {
+  MimDBProvider,
+  useAuth,
+  useClient,
+  useDelete,
+  useInsert,
+  useQuery,
+  useRealtime,
+  useUpdate,
+  useUpload
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts","../src/provider.tsx","../src/use-query.ts","../src/use-mutation.ts","../src/use-realtime.ts","../src/use-auth.ts","../src/use-upload.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\nimport type { MimDBClient } from '@mimdb/client'\n\n/**\n * React context that holds the MimDB client instance.\n *\n * Consumers should use the {@link useClient} hook rather than accessing\n * this context directly.\n *\n * @internal\n */\nconst MimDBContext = createContext<MimDBClient | null>(null)\n\n/**\n * Retrieve the MimDB client from the nearest `<MimDBProvider>`.\n *\n * @returns The `MimDBClient` instance provided by the enclosing provider.\n * @throws If called outside of a `<MimDBProvider>` tree.\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const client = useClient()\n *   // Use client.from(), client.auth, etc.\n * }\n * ```\n */\nexport function useClient(): MimDBClient {\n  const client = useContext(MimDBContext)\n  if (!client) {\n    throw new Error('useClient must be used within <MimDBProvider>')\n  }\n  return client\n}\n\nexport { MimDBContext }\n","import { type ReactNode } from 'react'\nimport { MimDBContext } from './context'\nimport type { MimDBClient } from '@mimdb/client'\n\n/**\n * Props for the {@link MimDBProvider} component.\n */\nexport interface MimDBProviderProps {\n  /** A configured `MimDBClient` instance to make available to child components. */\n  client: MimDBClient\n  /** The React subtree that will have access to the MimDB client. */\n  children: ReactNode\n}\n\n/**\n * Context provider that makes a `MimDBClient` available to all descendant\n * components via the {@link useClient} hook.\n *\n * Wrap your application (or a subtree) with this provider and pass a\n * pre-configured client instance.\n *\n * @param props - Provider props containing the client and children.\n *\n * @example\n * ```tsx\n * import { createClient } from '@mimdb/client'\n * import { MimDBProvider } from '@mimdb/react'\n *\n * const client = createClient('https://api.mimdb.dev', 'ref', 'key')\n *\n * function App() {\n *   return (\n *     <MimDBProvider client={client}>\n *       <MyApp />\n *     </MimDBProvider>\n *   )\n * }\n * ```\n */\nexport function MimDBProvider({ client, children }: MimDBProviderProps) {\n  return <MimDBContext.Provider value={client}>{children}</MimDBContext.Provider>\n}\n","import {\n  useQuery as useTanstackQuery,\n  type UseQueryResult,\n} from '@tanstack/react-query'\nimport { useClient } from './context'\n\n/**\n * Options for the {@link useQuery} hook.\n */\nexport interface UseQueryOptions {\n  /** Column selection string (PostgREST format). Defaults to `'*'`. */\n  select?: string\n  /** Equality filters applied as `query.eq(column, value)`. */\n  eq?: Record<string, string>\n  /** Not-equal filters applied as `query.neq(column, value)`. */\n  neq?: Record<string, string>\n  /** Column ordering configuration. */\n  order?: { column: string; ascending?: boolean }\n  /** Maximum number of rows to return. */\n  limit?: number\n  /** Number of rows to skip before returning results. */\n  offset?: number\n  /** Whether the query should execute. Maps to TanStack Query's `enabled`. */\n  enabled?: boolean\n  /** Duration in ms before cached data is considered stale. */\n  staleTime?: number\n  /** Polling interval in ms, or `false` to disable. */\n  refetchInterval?: number | false\n}\n\n/**\n * Fetch rows from a MimDB table using the REST API, backed by TanStack Query\n * for caching, deduplication, and background refetching.\n *\n * Automatically derives a stable query key from the table name and options\n * so cache invalidation works out of the box with the mutation hooks.\n *\n * @typeParam T - Expected row type. Defaults to a generic record.\n * @param table   - Name of the database table to query.\n * @param options - Query filters, modifiers, and TanStack Query settings.\n * @returns A TanStack `UseQueryResult` containing the row array and status flags.\n *\n * @example\n * ```tsx\n * const { data, isLoading } = useQuery<Todo>('todos', {\n *   eq: { done: 'false' },\n *   order: { column: 'created_at', ascending: false },\n *   limit: 20,\n * })\n * ```\n */\nexport function useQuery<T = Record<string, unknown>>(\n  table: string,\n  options?: UseQueryOptions,\n): UseQueryResult<T[], Error> {\n  const client = useClient()\n\n  return useTanstackQuery({\n    queryKey: ['mimdb', table, options],\n    queryFn: async () => {\n      let query = client.from<T>(table).select(options?.select ?? '*')\n\n      if (options?.eq) {\n        for (const [col, val] of Object.entries(options.eq)) {\n          query = query.eq(col, val)\n        }\n      }\n      if (options?.neq) {\n        for (const [col, val] of Object.entries(options.neq)) {\n          query = query.neq(col, val)\n        }\n      }\n      if (options?.order) {\n        query = query.order(options.order.column, {\n          ascending: options.order.ascending,\n        })\n      }\n      if (options?.limit) query = query.limit(options.limit)\n      if (options?.offset) query = query.offset(options.offset)\n\n      const { data, error } = await query\n      if (error) throw error\n      return (data ?? []) as T[]\n    },\n    enabled: options?.enabled,\n    staleTime: options?.staleTime,\n    refetchInterval: options?.refetchInterval,\n  })\n}\n","import {\n  useMutation as useTanstackMutation,\n  useQueryClient,\n  type UseMutationResult,\n} from '@tanstack/react-query'\nimport { useClient } from './context'\nimport type { MimDBError } from '@mimdb/client'\n\n/**\n * React hook for inserting a row into a MimDB table.\n *\n * On success, all `useQuery` caches for the same table are automatically\n * invalidated so lists stay in sync.\n *\n * @typeParam T - Expected row type. Defaults to a generic record.\n * @param table - Name of the database table.\n * @returns A TanStack `UseMutationResult` whose `mutate` / `mutateAsync`\n *          accepts a partial row to insert.\n *\n * @example\n * ```tsx\n * const insert = useInsert<Todo>('todos')\n * insert.mutate({ task: 'Buy milk', done: false })\n * ```\n */\nexport function useInsert<T = Record<string, unknown>>(\n  table: string,\n): UseMutationResult<T, MimDBError, Partial<T>> {\n  const client = useClient()\n  const queryClient = useQueryClient()\n\n  return useTanstackMutation({\n    mutationFn: async (data: Partial<T>) => {\n      const { data: result, error } = await client\n        .from<T>(table)\n        .insert(data)\n        .select()\n        .single()\n      if (error) throw error\n      return result as T\n    },\n    onSuccess: () => {\n      queryClient.invalidateQueries({ queryKey: ['mimdb', table] })\n    },\n  })\n}\n\n/**\n * Input shape for the {@link useUpdate} mutation.\n *\n * @typeParam T - Expected row type.\n */\nexport interface UpdateInput<T> {\n  /** Fields to update. */\n  data: Partial<T>\n  /** Equality filters identifying which rows to update. */\n  eq: Record<string, string>\n}\n\n/**\n * React hook for updating rows in a MimDB table.\n *\n * The mutation function accepts an object with `data` (fields to set) and\n * `eq` (equality filters to target specific rows). On success, all\n * `useQuery` caches for the same table are invalidated.\n *\n * @typeParam T - Expected row type. Defaults to a generic record.\n * @param table - Name of the database table.\n * @returns A TanStack `UseMutationResult`.\n *\n * @example\n * ```tsx\n * const update = useUpdate<Todo>('todos')\n * update.mutate({ data: { done: true }, eq: { id: '42' } })\n * ```\n */\nexport function useUpdate<T = Record<string, unknown>>(\n  table: string,\n): UseMutationResult<T, MimDBError, UpdateInput<T>> {\n  const client = useClient()\n  const queryClient = useQueryClient()\n\n  return useTanstackMutation({\n    mutationFn: async ({ data, eq }: UpdateInput<T>) => {\n      let query = client.from<T>(table).update(data)\n      for (const [col, val] of Object.entries(eq)) {\n        query = query.eq(col, val)\n      }\n      const { data: result, error } = await query.select().single()\n      if (error) throw error\n      return result as T\n    },\n    onSuccess: () => {\n      queryClient.invalidateQueries({ queryKey: ['mimdb', table] })\n    },\n  })\n}\n\n/**\n * React hook for deleting rows from a MimDB table.\n *\n * The mutation function accepts equality filters identifying which rows\n * to delete. On success, all `useQuery` caches for the same table are\n * invalidated.\n *\n * @param table - Name of the database table.\n * @returns A TanStack `UseMutationResult` whose `mutate` accepts equality filters.\n *\n * @example\n * ```tsx\n * const del = useDelete('todos')\n * del.mutate({ id: '42' })\n * ```\n */\nexport function useDelete(\n  table: string,\n): UseMutationResult<void, MimDBError, Record<string, string>> {\n  const client = useClient()\n  const queryClient = useQueryClient()\n\n  return useTanstackMutation({\n    mutationFn: async (eq: Record<string, string>) => {\n      let query = client.from(table).delete()\n      for (const [col, val] of Object.entries(eq)) {\n        query = query.eq(col, val)\n      }\n      const { error } = await query\n      if (error) throw error\n    },\n    onSuccess: () => {\n      queryClient.invalidateQueries({ queryKey: ['mimdb', table] })\n    },\n  })\n}\n","import { useEffect, useRef, useState } from 'react'\nimport { useQueryClient } from '@tanstack/react-query'\nimport {\n  MimDBRealtimeClient,\n  type RealtimeEvent,\n  type SubscriptionStatus,\n} from '@mimdb/realtime'\nimport { useClient } from './context'\n\n/**\n * Options for the {@link useRealtime} hook.\n *\n * @typeParam T - Expected row type for realtime events.\n */\nexport interface UseRealtimeOptions<T = Record<string, unknown>> {\n  /** Event type filter. Defaults to `'*'` (all events). */\n  event?: '*' | 'INSERT' | 'UPDATE' | 'DELETE'\n  /** Row filter expression (e.g. `'user_id=eq.42'`). */\n  filter?: string\n  /** Called for each matching realtime event. */\n  onEvent?: (event: RealtimeEvent<T>) => void\n  /**\n   * Whether to automatically invalidate the table's TanStack Query cache\n   * when an event is received. Defaults to `true`.\n   */\n  invalidateQueries?: boolean\n}\n\n/**\n * Subscribe to realtime database changes for a table via WebSocket.\n *\n * Creates a `MimDBRealtimeClient` using the connection config from\n * `MimDBClient.getConfig()` and subscribes to the specified table.\n * On each event, the table's TanStack Query cache is invalidated\n * (unless opted out) so queries refetch automatically.\n *\n * The subscription is cleaned up when the component unmounts or when\n * the `table`, `event`, or `filter` options change.\n *\n * @typeParam T - Expected row type for realtime events.\n * @param table   - Database table to subscribe to.\n * @param options - Event filters and callbacks.\n * @returns An object containing the current subscription status.\n *\n * @example\n * ```tsx\n * const { status } = useRealtime<Message>('messages', {\n *   event: 'INSERT',\n *   onEvent: (e) => console.log('New message:', e.new),\n * })\n * ```\n */\nexport function useRealtime<T = Record<string, unknown>>(\n  table: string,\n  options?: UseRealtimeOptions<T>,\n): { status: SubscriptionStatus } {\n  const client = useClient()\n  const queryClient = useQueryClient()\n  const [status, setStatus] = useState<SubscriptionStatus>('pending')\n  const realtimeRef = useRef<MimDBRealtimeClient | null>(null)\n\n  useEffect(() => {\n    const config = client.getConfig()\n\n    if (!realtimeRef.current) {\n      realtimeRef.current = new MimDBRealtimeClient({\n        url: config.url,\n        projectRef: config.ref,\n        apiKey: config.apiKey,\n      })\n    }\n\n    const sub = realtimeRef.current.subscribe<T>(table, {\n      event: options?.event ?? '*',\n      filter: options?.filter,\n      onEvent(event) {\n        options?.onEvent?.(event)\n        if (options?.invalidateQueries !== false) {\n          queryClient.invalidateQueries({ queryKey: ['mimdb', table] })\n        }\n      },\n      onSubscribed() {\n        setStatus('active')\n      },\n      onError() {\n        setStatus('error')\n      },\n    })\n\n    setStatus('pending')\n\n    return () => {\n      sub.unsubscribe()\n      setStatus('closed')\n    }\n  }, [table, options?.event, options?.filter]) // eslint-disable-line react-hooks/exhaustive-deps\n\n  return { status }\n}\n","import { useState, useEffect, useCallback } from 'react'\nimport { useClient } from './context'\nimport type { User } from '@mimdb/client'\n\n/**\n * Return type of the {@link useAuth} hook.\n */\nexport interface UseAuthResult {\n  /** The currently authenticated user, or null if signed out. */\n  user: User | null\n  /** True while the initial session check is in progress. */\n  isLoading: boolean\n  /** Sign in with email and password. */\n  signIn: (email: string, password: string) => Promise<void>\n  /** Create a new account with email and password. */\n  signUp: (email: string, password: string) => Promise<void>\n  /** Sign out the current user. */\n  signOut: () => Promise<void>\n  /** Redirect to an OAuth provider's authorization page. */\n  signInWithOAuth: (provider: string, opts: { redirectTo: string }) => void\n}\n\n/**\n * React hook for authentication state management.\n *\n * On mount, checks for an existing session and fetches the current user.\n * Subscribes to auth state changes so the returned `user` stays in sync\n * with sign-in, sign-out, and token refresh events.\n *\n * @returns An object with the current user, loading state, and auth methods.\n *\n * @example\n * ```tsx\n * function LoginPage() {\n *   const { user, isLoading, signIn, signOut } = useAuth()\n *\n *   if (isLoading) return <p>Loading...</p>\n *   if (user) return <button onClick={signOut}>Sign Out</button>\n *\n *   return (\n *     <button onClick={() => signIn('user@example.com', 'password')}>\n *       Sign In\n *     </button>\n *   )\n * }\n * ```\n */\nexport function useAuth(): UseAuthResult {\n  const client = useClient()\n  const [user, setUser] = useState<User | null>(null)\n  const [isLoading, setIsLoading] = useState(true)\n\n  useEffect(() => {\n    const session = client.auth.getSession()\n    if (session) {\n      client.auth\n        .getUser()\n        .then(setUser)\n        .catch(() => setUser(null))\n        .finally(() => setIsLoading(false))\n    } else {\n      setIsLoading(false)\n    }\n\n    const unsub = client.auth.onAuthStateChange((event, _session) => {\n      if (event === 'SIGNED_IN' || event === 'TOKEN_REFRESHED') {\n        client.auth\n          .getUser()\n          .then(setUser)\n          .catch(() => setUser(null))\n      } else if (event === 'SIGNED_OUT') {\n        setUser(null)\n      }\n    })\n\n    return unsub\n  }, [client])\n\n  const signIn = useCallback(\n    async (email: string, password: string) => {\n      await client.auth.signIn(email, password)\n    },\n    [client],\n  )\n\n  const signUp = useCallback(\n    async (email: string, password: string) => {\n      await client.auth.signUp(email, password)\n    },\n    [client],\n  )\n\n  const signOut = useCallback(async () => {\n    await client.auth.signOut()\n  }, [client])\n\n  const signInWithOAuth = useCallback(\n    (provider: string, opts: { redirectTo: string }) => {\n      const url = client.auth.signInWithOAuth(provider, opts)\n      window.location.href = url\n    },\n    [client],\n  )\n\n  return { user, isLoading, signIn, signUp, signOut, signInWithOAuth }\n}\n","import { useState, useCallback } from 'react'\nimport { useClient } from './context'\nimport type { UploadOptions } from '@mimdb/client'\n\n/**\n * Return type of the {@link useUpload} hook.\n */\nexport interface UseUploadResult {\n  /** Upload a file to the bucket. Re-throws on failure after setting `error`. */\n  upload: (path: string, file: Blob | File, opts?: UploadOptions) => Promise<void>\n  /** True while an upload is in progress. */\n  isUploading: boolean\n  /** The error from the most recent failed upload, or null. */\n  error: Error | null\n}\n\n/**\n * React hook for uploading files to a MimDB storage bucket.\n *\n * Tracks the upload's loading and error state so components can show\n * progress indicators or error messages without manual state management.\n *\n * @param bucket - Name of the storage bucket to upload to.\n * @returns An object with the `upload` function and status flags.\n *\n * @example\n * ```tsx\n * function AvatarUpload() {\n *   const { upload, isUploading, error } = useUpload('avatars')\n *\n *   const handleFile = (file: File) => {\n *     upload(`users/${userId}/avatar.png`, file, { contentType: 'image/png' })\n *   }\n *\n *   return (\n *     <>\n *       <input type=\"file\" onChange={(e) => handleFile(e.target.files![0])} />\n *       {isUploading && <p>Uploading...</p>}\n *       {error && <p>Error: {error.message}</p>}\n *     </>\n *   )\n * }\n * ```\n */\nexport function useUpload(bucket: string): UseUploadResult {\n  const client = useClient()\n  const [isUploading, setIsUploading] = useState(false)\n  const [error, setError] = useState<Error | null>(null)\n\n  const upload = useCallback(\n    async (path: string, file: Blob | File, opts?: UploadOptions) => {\n      setIsUploading(true)\n      setError(null)\n      try {\n        await client.storage.from(bucket).upload(path, file, opts)\n      } catch (err) {\n        const uploadError =\n          err instanceof Error ? err : new Error(String(err))\n        setError(uploadError)\n        throw uploadError\n      } finally {\n        setIsUploading(false)\n      }\n    },\n    [client, bucket],\n  )\n\n  return { upload, isUploading, error }\n}\n"],"mappings":"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","names":["useQueryClient","useQueryClient","useState","useEffect","useState","useEffect","useState","useCallback","useState","useCallback"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@mimdb/react",
+  "version": "0.1.0",
+  "description": "React hooks for MimDB",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "@tanstack/react-query": ">=5.0.0",
+    "@mimdb/client": ">=0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "vitest": "^4.1.1",
+    "typescript": "^6.0.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "@types/react": "^18.3.0",
+    "@tanstack/react-query": "^5.83.0",
+    "@testing-library/react": "^16.3.0",
+    "@mimdb/client": "workspace:*",
+    "@mimdb/realtime": "workspace:*",
+    "jsdom": "^26.1.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MimDB/SDK",
+    "directory": "packages/react"
+  },
+  "keywords": ["mimdb", "mimisbrunnr", "react", "hooks", "baas"]
+}