@weirdscience/based-client 0.4.1 → 0.6.1

package/dist/hooks/use-mutation.d.ts

@@ -1,5 +1,3 @@
-import type { MutationResult, DefaultTables } from "../types";
-type MutationOperation = "create" | "update" | "upsert" | "delete";
+import type { MutationResult, MutationOperation, DefaultTables } from "../types";
 export declare function useMutation<T extends Record<string, Record<string, unknown>> = DefaultTables, K extends string & keyof T = string & keyof T>(table: K, operation: MutationOperation): MutationResult<T[K]>;
-export {};
 //# sourceMappingURL=use-mutation.d.ts.map

package/dist/hooks/use-mutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-mutation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9D,KAAK,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnE,wBAAgB,WAAW,CACzB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,aAAa,EACjE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,EAE7C,KAAK,EAAE,CAAC,EACR,SAAS,EAAE,iBAAiB,GAC3B,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CA0CtB"}
+{"version":3,"file":"use-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-mutation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,cAAc,EACd,iBAAiB,EACjB,aAAa,EACd,MAAM,UAAU,CAAC;AAElB,wBAAgB,WAAW,CACzB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,aAAa,EACjE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,EAC7C,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,iBAAiB,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CA6C9D"}

package/dist/hooks/use-query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-query.d.ts","sourceRoot":"","sources":["../../src/hooks/use-query.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzE,wBAAgB,QAAQ,CACtB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,aAAa,EACjE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,EAE7C,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC3B,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CA0CnB"}
+{"version":3,"file":"use-query.d.ts","sourceRoot":"","sources":["../../src/hooks/use-query.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAEV,YAAY,EACZ,WAAW,EACX,aAAa,EACd,MAAM,UAAU,CAAC;AAmBlB,wBAAgB,QAAQ,CACtB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,aAAa,EACjE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,EAC7C,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CA6E3D"}

package/dist/hooks/use-record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-record.d.ts","sourceRoot":"","sources":["../../src/hooks/use-record.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE3E,wBAAgB,SAAS,CACvB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,aAAa,EACjE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,EAE7C,KAAK,EAAE,CAAC,EACR,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC7B,OAAO,CAAC,EAAE,aAAa,GACtB,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAmCpB"}
+{"version":3,"file":"use-record.d.ts","sourceRoot":"","sources":["../../src/hooks/use-record.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,aAAa,EACb,YAAY,EACZ,aAAa,EACd,MAAM,UAAU,CAAC;AAElB,wBAAgB,SAAS,CACvB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,aAAa,EACjE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,EAE7C,KAAK,EAAE,CAAC,EACR,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC7B,OAAO,CAAC,EAAE,aAAa,GACtB,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAwDpB"}

package/dist/hooks/use-user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-user.d.ts","sourceRoot":"","sources":["../../src/hooks/use-user.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,wBAAgB,OAAO,IAAI;IACzB,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB,CAcA"}
+{"version":3,"file":"use-user.d.ts","sourceRoot":"","sources":["../../src/hooks/use-user.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,UAAU,CAAC;AAepD,wBAAgB,OAAO,IAAI;IACzB,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB,CAcA"}

package/dist/index.cjs

@@ -0,0 +1,593 @@
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  useUser: () => useUser,
+  useRecord: () => useRecord,
+  useQuery: () => useQuery,
+  useMutation: () => useMutation,
+  useBasedClient: () => useBasedClient,
+  createClient: () => createClient,
+  BasedProvider: () => BasedProvider,
+  BasedError: () => BasedError
+});
+module.exports = __toCommonJS(exports_src);
+
+// src/types.ts
+class BasedError extends Error {
+  code;
+  status;
+  details;
+  constructor(code, message, status, details) {
+    super(message);
+    this.name = "BasedError";
+    this.code = code;
+    this.status = status;
+    this.details = details;
+  }
+}
+function toHookError(err) {
+  if (err instanceof BasedError) {
+    return {
+      code: err.code,
+      message: err.message,
+      status: err.status,
+      details: err.details
+    };
+  }
+  return {
+    code: "NETWORK_ERROR",
+    message: err instanceof Error ? err.message : String(err)
+  };
+}
+
+// src/client.ts
+var DEFAULT_STORAGE_KEY = "based.session";
+function defaultStorage() {
+  if (typeof globalThis === "undefined")
+    return null;
+  const ls = globalThis.localStorage;
+  if (!ls || typeof ls.getItem !== "function")
+    return null;
+  return {
+    getItem: (k) => ls.getItem(k),
+    setItem: (k, v) => ls.setItem(k, v),
+    removeItem: (k) => ls.removeItem(k)
+  };
+}
+function createClient(options) {
+  const { url, anonKey } = options;
+  const baseUrl = url.replace(/\/$/, "");
+  const storage = options.storage === false ? null : options.storage ?? defaultStorage();
+  const storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;
+  let state = {
+    user: null,
+    accessToken: null,
+    refreshToken: null,
+    isLoading: !!storage
+  };
+  const listeners = new Set;
+  function notify() {
+    for (const listener of listeners)
+      listener();
+  }
+  function subscribe(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+  }
+  function getState() {
+    return state;
+  }
+  function onAuthStateChange(callback) {
+    return subscribe(() => callback(state));
+  }
+  async function persist() {
+    if (!storage)
+      return;
+    const snapshot = {
+      user: state.user,
+      accessToken: state.accessToken,
+      refreshToken: state.refreshToken
+    };
+    if (!snapshot.refreshToken) {
+      await storage.removeItem(storageKey);
+      return;
+    }
+    await storage.setItem(storageKey, JSON.stringify(snapshot));
+  }
+  function setState(next) {
+    state = { ...state, ...next };
+    notify();
+    persist().catch(() => {});
+  }
+  const readyPromise = (async () => {
+    if (!storage) {
+      setState({ isLoading: false });
+      return;
+    }
+    try {
+      const raw = await storage.getItem(storageKey);
+      if (!raw) {
+        setState({ isLoading: false });
+        return;
+      }
+      const stored = JSON.parse(raw);
+      if (!stored.refreshToken) {
+        setState({ isLoading: false });
+        return;
+      }
+      state = {
+        user: stored.user,
+        accessToken: stored.accessToken,
+        refreshToken: stored.refreshToken,
+        isLoading: true
+      };
+      notify();
+      const user = await getUser();
+      if (!user) {
+        const refreshed = await refreshSession();
+        if (refreshed) {
+          await getUser();
+        }
+      }
+    } catch {
+      try {
+        await storage.removeItem(storageKey);
+      } catch {}
+    } finally {
+      setState({ isLoading: false });
+    }
+  })();
+  function ready() {
+    return readyPromise;
+  }
+  async function fetchWithAuth(path, init = {}) {
+    const headers = new Headers(init.headers);
+    if (state.accessToken) {
+      headers.set("Authorization", `Bearer ${state.accessToken}`);
+    } else {
+      headers.set("apikey", anonKey);
+    }
+    if (!headers.has("Content-Type") && init.body) {
+      headers.set("Content-Type", "application/json");
+    }
+    const tokenAtRequest = state.accessToken;
+    let res = await fetch(`${baseUrl}${path}`, { ...init, headers });
+    if (res.status === 401 && state.refreshToken) {
+      const alreadyRefreshed = state.accessToken !== tokenAtRequest;
+      const refreshed = alreadyRefreshed ? true : await refreshSession();
+      if (refreshed && state.accessToken) {
+        headers.set("Authorization", `Bearer ${state.accessToken}`);
+        res = await fetch(`${baseUrl}${path}`, { ...init, headers });
+      }
+    }
+    return res;
+  }
+  async function authError(res, fallback) {
+    const json = await res.json().catch(() => null);
+    return new BasedError(json?.error?.code ?? "AUTH_ERROR", json?.error?.message || fallback, res.status, json?.error?.details);
+  }
+  async function signUp(email, password) {
+    const res = await fetch(`${baseUrl}/auth/signup`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ email, password })
+    });
+    if (!res.ok) {
+      throw await authError(res, "Sign up failed");
+    }
+    const { data } = await res.json();
+    setState({
+      user: data.user,
+      accessToken: data.accessToken,
+      refreshToken: data.refreshToken,
+      isLoading: false
+    });
+    return data.user;
+  }
+  async function signIn(email, password) {
+    const res = await fetch(`${baseUrl}/auth/signin`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ email, password })
+    });
+    if (!res.ok) {
+      throw await authError(res, "Sign in failed");
+    }
+    const { data } = await res.json();
+    setState({
+      user: data.user,
+      accessToken: data.accessToken,
+      refreshToken: data.refreshToken,
+      isLoading: false
+    });
+    return data.user;
+  }
+  async function signOut() {
+    if (state.accessToken) {
+      try {
+        await fetch(`${baseUrl}/auth/signout`, {
+          method: "POST",
+          headers: { Authorization: `Bearer ${state.accessToken}` }
+        });
+      } catch {}
+    }
+    setState({ user: null, accessToken: null, refreshToken: null, isLoading: false });
+  }
+  let refreshInFlight = null;
+  function refreshSession() {
+    if (!refreshInFlight) {
+      refreshInFlight = doRefresh().finally(() => {
+        refreshInFlight = null;
+      });
+    }
+    return refreshInFlight;
+  }
+  async function doRefresh() {
+    if (!state.refreshToken)
+      return false;
+    try {
+      const res = await fetch(`${baseUrl}/auth/refresh`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ refreshToken: state.refreshToken })
+      });
+      if (!res.ok) {
+        setState({ user: null, accessToken: null, refreshToken: null, isLoading: false });
+        return false;
+      }
+      const { data } = await res.json();
+      setState({
+        accessToken: data.accessToken,
+        refreshToken: data.refreshToken
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async function getUser() {
+    if (!state.accessToken)
+      return null;
+    try {
+      const res = await fetch(`${baseUrl}/auth/me`, {
+        headers: { Authorization: `Bearer ${state.accessToken}` }
+      });
+      if (!res.ok) {
+        if (res.status === 401) {
+          setState({ user: null });
+        }
+        return null;
+      }
+      const { data } = await res.json();
+      const user = { id: data.id, email: data.email, role: data.role };
+      setState({ user });
+      return user;
+    } catch {
+      return null;
+    }
+  }
+  async function parseOrThrow(res, fallbackCode) {
+    let json = {};
+    try {
+      json = await res.json();
+    } catch {}
+    if (!res.ok) {
+      const err = json.error;
+      throw new BasedError(err?.code || fallbackCode, err?.message || `Request failed with status ${res.status}`, res.status, err?.details);
+    }
+    return json;
+  }
+  function from(table) {
+    const basePath = `/api/${table}`;
+    return {
+      async select(opts) {
+        const params = new URLSearchParams;
+        if (opts?.limit !== undefined)
+          params.set("limit", String(opts.limit));
+        if (opts?.offset !== undefined)
+          params.set("offset", String(opts.offset));
+        if (opts?.order !== undefined)
+          params.set("order", opts.order);
+        if (opts?.filter) {
+          for (const [key, value] of Object.entries(opts.filter)) {
+            if (value !== undefined)
+              params.set(key, String(value));
+          }
+        }
+        const query = params.toString();
+        const res = await fetchWithAuth(`${basePath}${query ? `?${query}` : ""}`);
+        const json = await parseOrThrow(res, "SELECT_FAILED");
+        return { data: json.data, total: json.total ?? json.data.length };
+      },
+      async get(id) {
+        const res = await fetchWithAuth(`${basePath}/${encodeURIComponent(id)}`);
+        if (res.status === 404)
+          return null;
+        const json = await parseOrThrow(res, "GET_FAILED");
+        return json.data;
+      },
+      async insert(data) {
+        const res = await fetchWithAuth(basePath, {
+          method: "POST",
+          body: JSON.stringify(data)
+        });
+        const json = await parseOrThrow(res, "INSERT_FAILED");
+        return json.data;
+      },
+      async update(id, data) {
+        const body = { ...data };
+        delete body.id;
+        const res = await fetchWithAuth(`${basePath}/${encodeURIComponent(id)}`, {
+          method: "PUT",
+          body: JSON.stringify(body)
+        });
+        const json = await parseOrThrow(res, "UPDATE_FAILED");
+        return json.data;
+      },
+      async upsert(data) {
+        const body = { ...data };
+        const id = body.id;
+        if (!id) {
+          throw new BasedError("MISSING_ID", "upsert() requires `data.id`. Use insert() to let the server generate one.", 400);
+        }
+        delete body.id;
+        const res = await fetchWithAuth(`${basePath}/${encodeURIComponent(id)}`, {
+          method: "PUT",
+          body: JSON.stringify(body)
+        });
+        const json = await parseOrThrow(res, "UPSERT_FAILED");
+        return json.data;
+      },
+      async delete(id) {
+        const res = await fetchWithAuth(`${basePath}/${encodeURIComponent(id)}`, {
+          method: "DELETE"
+        });
+        await parseOrThrow(res, "DELETE_FAILED");
+        return { deleted: true };
+      }
+    };
+  }
+  return {
+    auth: { signUp, signIn, signOut, refreshSession, getUser, onAuthStateChange },
+    fetch: fetchWithAuth,
+    from,
+    subscribe,
+    getState,
+    ready
+  };
+}
+// src/provider.tsx
+var import_react = require("react");
+var jsx_runtime = require("react/jsx-runtime");
+"use client";
+var BasedContext = import_react.createContext(null);
+function BasedProvider({
+  client,
+  children
+}) {
+  return /* @__PURE__ */ jsx_runtime.jsx(BasedContext.Provider, {
+    value: client,
+    children
+  });
+}
+function useBasedClient() {
+  const client = import_react.useContext(BasedContext);
+  if (!client) {
+    throw new Error("useBasedClient must be used within a BasedProvider");
+  }
+  return client;
+}
+// src/hooks/use-user.ts
+var import_react2 = require("react");
+"use client";
+var SERVER_SNAPSHOT = Object.freeze({
+  user: null,
+  accessToken: null,
+  refreshToken: null,
+  isLoading: true
+});
+function useUser() {
+  const client = useBasedClient();
+  const state = import_react2.useSyncExternalStore(client.subscribe, () => client.getState(), () => SERVER_SNAPSHOT);
+  return {
+    user: state.user,
+    isLoading: state.isLoading,
+    error: null
+  };
+}
+// src/hooks/use-query.ts
+var import_react3 = require("react");
+"use client";
+function stableKey(value) {
+  if (value === undefined)
+    return "undefined";
+  if (value === null || typeof value !== "object")
+    return JSON.stringify(value);
+  if (Array.isArray(value))
+    return `[${value.map(stableKey).join(",")}]`;
+  const entries = Object.entries(value).filter(([, v]) => v !== undefined).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+  return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${stableKey(v)}`).join(",")}}`;
+}
+function useQuery(table, options) {
+  const client = useBasedClient();
+  const enabled = options?.enabled !== false;
+  const authKey = import_react3.useSyncExternalStore(client.subscribe, () => client.getState().user?.id ?? null, () => null);
+  const [data, setData] = import_react3.useState(null);
+  const [total, setTotal] = import_react3.useState(0);
+  const [isLoading, setIsLoading] = import_react3.useState(enabled);
+  const [error, setError] = import_react3.useState(null);
+  const optionsKey = stableKey(options);
+  const selectOptions = import_react3.useMemo(() => ({
+    filter: options?.filter,
+    limit: options?.limit,
+    offset: options?.offset,
+    order: options?.order
+  }), [optionsKey]);
+  const latestRequest = import_react3.useRef(0);
+  const runQuery = import_react3.useCallback(async () => {
+    const requestId = ++latestRequest.current;
+    setIsLoading(true);
+    setError(null);
+    try {
+      const result = await client.from(table).select(selectOptions);
+      if (latestRequest.current !== requestId)
+        return;
+      setData(result.data);
+      setTotal(result.total);
+    } catch (err) {
+      if (latestRequest.current !== requestId)
+        return;
+      setError(toHookError(err));
+      setData(null);
+      setTotal(0);
+    } finally {
+      if (latestRequest.current === requestId)
+        setIsLoading(false);
+    }
+  }, [client, table, selectOptions]);
+  import_react3.useEffect(() => {
+    if (!enabled) {
+      latestRequest.current += 1;
+      setData(null);
+      setTotal(0);
+      setError(null);
+      setIsLoading(false);
+      return;
+    }
+    runQuery();
+    return () => {
+      latestRequest.current += 1;
+    };
+  }, [enabled, authKey, runQuery]);
+  return { data, total, isLoading, error, refetch: runQuery };
+}
+// src/hooks/use-record.ts
+var import_react4 = require("react");
+"use client";
+function useRecord(table, id, options) {
+  const client = useBasedClient();
+  const enabled = options?.enabled !== false && !!id;
+  const authKey = import_react4.useSyncExternalStore(client.subscribe, () => client.getState().user?.id ?? null, () => null);
+  const [data, setData] = import_react4.useState(null);
+  const [isLoading, setIsLoading] = import_react4.useState(enabled);
+  const [error, setError] = import_react4.useState(null);
+  const latestRequest = import_react4.useRef(0);
+  const runQuery = import_react4.useCallback(async () => {
+    if (!id)
+      return;
+    const requestId = ++latestRequest.current;
+    setIsLoading(true);
+    setError(null);
+    try {
+      const row = await client.from(table).get(id);
+      if (latestRequest.current !== requestId)
+        return;
+      setData(row);
+    } catch (err) {
+      if (latestRequest.current !== requestId)
+        return;
+      setError(toHookError(err));
+      setData(null);
+    } finally {
+      if (latestRequest.current === requestId)
+        setIsLoading(false);
+    }
+  }, [client, table, id]);
+  import_react4.useEffect(() => {
+    if (!enabled) {
+      latestRequest.current += 1;
+      setData(null);
+      setError(null);
+      setIsLoading(false);
+      return;
+    }
+    runQuery();
+    return () => {
+      latestRequest.current += 1;
+    };
+  }, [enabled, authKey, runQuery]);
+  return { data, isLoading, error, refetch: runQuery };
+}
+// src/hooks/use-mutation.ts
+var import_react5 = require("react");
+"use client";
+function useMutation(table, operation) {
+  const client = useBasedClient();
+  const [isLoading, setIsLoading] = import_react5.useState(false);
+  const [error, setError] = import_react5.useState(null);
+  const mutate = import_react5.useCallback(async (data) => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      const builder = client.from(table);
+      switch (operation) {
+        case "create":
+          return await builder.insert(data);
+        case "update": {
+          if (!data.id)
+            throw new BasedError("MISSING_ID", "Update requires an 'id' field", 400);
+          return await builder.update(String(data.id), data);
+        }
+        case "upsert": {
+          if (!data.id)
+            throw new BasedError("MISSING_ID", "Upsert requires an 'id' field", 400);
+          return await builder.upsert(data);
+        }
+        case "delete": {
+          if (!data.id)
+            throw new BasedError("MISSING_ID", "Delete requires an 'id' field", 400);
+          await builder.delete(String(data.id));
+          return data;
+        }
+      }
+    } catch (err) {
+      setError(toHookError(err));
+      return null;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [client, table, operation]);
+  return { mutate, isLoading, error };
+}
+
+// src/index.ts
+"use client";

package/dist/index.d.ts

@@ -1,9 +1,8 @@
-export { createClient } from "./client";
+export { createClient, BasedError, type BasedClient, type BasedClientOptions, type BasedTable, type ListResult, type StorageAdapter, type AuthUser, type AuthState, type QueryOptions, type DefaultTables, } from "./core";
 export { BasedProvider, useBasedClient } from "./provider";
 export { useUser } from "./hooks/use-user";
 export { useQuery } from "./hooks/use-query";
 export { useRecord } from "./hooks/use-record";
 export { useMutation } from "./hooks/use-mutation";
-export { BasedError } from "./types";
-export type { BasedClient, BasedClientOptions, BasedTable, ListResult, StorageAdapter, AuthUser, AuthState, QueryOptions, QueryResult, RecordOptions, RecordResult, MutationResult, DefaultTables, } from "./types";
+export type { QueryResult, RecordOptions, RecordResult, HookError, MutationResult, MutationOperation, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,cAAc,EACd,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,EACd,aAAa,GACd,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,YAAY,EACZ,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,YAAY,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,SAAS,EACT,cAAc,EACd,iBAAiB,GAClB,MAAM,SAAS,CAAC"}