@weirdscience/based-client 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+import type { BasedClientOptions, BasedClient } from "./types";
+export declare function createClient(options: BasedClientOptions): BasedClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAuB,WAAW,EAAE,MAAM,SAAS,CAAC;AAEpF,wBAAgB,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAsJrE"}

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

@@ -0,0 +1,5 @@
+import type { MutationResult, DefaultTables } from "../types";
+type MutationOperation = "create" | "update" | "delete";
+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

@@ -0,0 +1 @@
+{"version":3,"file":"use-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-mutation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9D,KAAK,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExD,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,CA0DtB"}

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

@@ -0,0 +1,3 @@
+import type { QueryOptions, QueryResult, DefaultTables } from "../types";
+export declare function useQuery<T extends Record<string, Record<string, unknown>> = DefaultTables, K extends string & keyof T = string & keyof T>(table: K, options?: QueryOptions<T[K]>): QueryResult<T[K]>;
+//# sourceMappingURL=use-query.d.ts.map

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

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

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

@@ -0,0 +1,7 @@
+import type { AuthUser } from "../types";
+export declare function useUser(): {
+    user: AuthUser | null;
+    isLoading: boolean;
+    error: Error | null;
+};
+//# sourceMappingURL=use-user.d.ts.map

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

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createClient } from "./client";
+export { BasedProvider, useBasedClient } from "./provider";
+export { useUser } from "./hooks/use-user";
+export { useQuery } from "./hooks/use-query";
+export { useMutation } from "./hooks/use-mutation";
+export type { BasedClient, BasedClientOptions, AuthUser, AuthState, QueryOptions, QueryResult, MutationResult, DefaultTables, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,264 @@
+// src/client.ts
+function createClient(options) {
+  const { url, anonKey } = options;
+  const baseUrl = url.replace(/\/$/, "");
+  let state = {
+    user: null,
+    accessToken: null,
+    refreshToken: null
+  };
+  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;
+  }
+  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");
+    }
+    let res = await fetch(`${baseUrl}${path}`, { ...init, headers });
+    if (res.status === 401 && state.refreshToken) {
+      const refreshed = await refreshSession();
+      if (refreshed) {
+        headers.set("Authorization", `Bearer ${state.accessToken}`);
+        res = await fetch(`${baseUrl}${path}`, { ...init, headers });
+      }
+    }
+    return res;
+  }
+  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) {
+      const json = await res.json();
+      throw new Error(json.error?.message || "Sign up failed");
+    }
+    const { data } = await res.json();
+    state = {
+      user: data.user,
+      accessToken: data.accessToken,
+      refreshToken: data.refreshToken
+    };
+    notify();
+    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) {
+      const json = await res.json();
+      throw new Error(json.error?.message || "Sign in failed");
+    }
+    const { data } = await res.json();
+    state = {
+      user: data.user,
+      accessToken: data.accessToken,
+      refreshToken: data.refreshToken
+    };
+    notify();
+    return data.user;
+  }
+  async function signOut() {
+    if (state.accessToken) {
+      try {
+        await fetch(`${baseUrl}/auth/signout`, {
+          method: "POST",
+          headers: { Authorization: `Bearer ${state.accessToken}` }
+        });
+      } catch {}
+    }
+    state = { user: null, accessToken: null, refreshToken: null };
+    notify();
+  }
+  async function refreshSession() {
+    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) {
+        state = { user: null, accessToken: null, refreshToken: null };
+        notify();
+        return false;
+      }
+      const { data } = await res.json();
+      state = {
+        ...state,
+        accessToken: data.accessToken,
+        refreshToken: data.refreshToken
+      };
+      notify();
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  return {
+    auth: { signUp, signIn, signOut, refreshSession },
+    fetch: fetchWithAuth,
+    subscribe,
+    getState
+  };
+}
+// src/provider.tsx
+import { createContext, useContext } from "react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+var BasedContext = createContext(null);
+function BasedProvider({
+  client,
+  children
+}) {
+  return /* @__PURE__ */ jsxDEV(BasedContext.Provider, {
+    value: client,
+    children
+  }, undefined, false, undefined, this);
+}
+function useBasedClient() {
+  const client = useContext(BasedContext);
+  if (!client) {
+    throw new Error("useBasedClient must be used within a BasedProvider");
+  }
+  return client;
+}
+// src/hooks/use-user.ts
+import { useSyncExternalStore } from "react";
+function useUser() {
+  const client = useBasedClient();
+  const state = useSyncExternalStore(client.subscribe, () => client.getState(), () => client.getState());
+  return {
+    user: state.user,
+    isLoading: false,
+    error: null
+  };
+}
+// src/hooks/use-query.ts
+import { useState as useState2, useEffect as useEffect2, useCallback } from "react";
+function useQuery(table, options) {
+  const client = useBasedClient();
+  const [data, setData] = useState2(null);
+  const [total, setTotal] = useState2(0);
+  const [isLoading, setIsLoading] = useState2(true);
+  const [error, setError] = useState2(null);
+  const fetchData = useCallback(async () => {
+    setIsLoading(true);
+    setError(null);
+    const params = new URLSearchParams;
+    if (options?.limit)
+      params.set("limit", String(options.limit));
+    if (options?.offset)
+      params.set("offset", String(options.offset));
+    if (options?.filter) {
+      for (const [key, value] of Object.entries(options.filter)) {
+        if (value !== undefined)
+          params.set(key, String(value));
+      }
+    }
+    const query = params.toString();
+    const path = `/api/${table}${query ? `?${query}` : ""}`;
+    try {
+      const res = await client.fetch(path);
+      const json = await res.json();
+      if (!res.ok) {
+        setError(json.error || { code: "UNKNOWN", message: "Request failed" });
+        setData(null);
+        setTotal(0);
+      } else {
+        setData(json.data);
+        setTotal(json.total ?? 0);
+      }
+    } catch (err) {
+      setError({ code: "NETWORK_ERROR", message: err.message });
+      setData(null);
+      setTotal(0);
+    } finally {
+      setIsLoading(false);
+    }
+  }, [client, table, JSON.stringify(options)]);
+  useEffect2(() => {
+    fetchData();
+  }, [fetchData]);
+  return { data, total, isLoading, error, refetch: fetchData };
+}
+// src/hooks/use-mutation.ts
+import { useState as useState3, useCallback as useCallback2 } from "react";
+function useMutation(table, operation) {
+  const client = useBasedClient();
+  const [isLoading, setIsLoading] = useState3(false);
+  const [error, setError] = useState3(null);
+  const mutate = useCallback2(async (data) => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      let path;
+      let method;
+      let body;
+      switch (operation) {
+        case "create":
+          path = `/api/${table}`;
+          method = "POST";
+          body = JSON.stringify(data);
+          break;
+        case "update":
+          if (!data.id)
+            throw new Error("Update requires an 'id' field");
+          path = `/api/${table}/${data.id}`;
+          method = "PUT";
+          const { id, ...rest } = data;
+          body = JSON.stringify(rest);
+          break;
+        case "delete":
+          if (!data.id)
+            throw new Error("Delete requires an 'id' field");
+          path = `/api/${table}/${data.id}`;
+          method = "DELETE";
+          break;
+      }
+      const res = await client.fetch(path, { method, body });
+      const json = await res.json();
+      if (!res.ok) {
+        const err = json.error || { code: "UNKNOWN", message: "Mutation failed" };
+        setError(err);
+        throw new Error(err.message);
+      }
+      return json.data;
+    } catch (err) {
+      if (!error) {
+        setError({ code: "MUTATION_ERROR", message: err.message });
+      }
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [client, table, operation]);
+  return { mutate, isLoading, error };
+}
+export {
+  useUser,
+  useQuery,
+  useMutation,
+  useBasedClient,
+  createClient,
+  BasedProvider
+};

package/dist/provider.d.ts

@@ -0,0 +1,8 @@
+import { type ReactNode } from "react";
+import type { BasedClient } from "./types";
+export declare function BasedProvider({ client, children, }: {
+    client: BasedClient;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useBasedClient(): BasedClient;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB,2CAIA;AAED,wBAAgB,cAAc,IAAI,WAAW,CAM5C"}

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+export interface BasedClientOptions {
+    url: string;
+    anonKey: string;
+}
+export interface AuthUser {
+    id: string;
+    email: string;
+}
+export interface AuthState {
+    user: AuthUser | null;
+    accessToken: string | null;
+    refreshToken: string | null;
+}
+export interface BasedClient {
+    auth: {
+        signUp(email: string, password: string): Promise<AuthUser>;
+        signIn(email: string, password: string): Promise<AuthUser>;
+        signOut(): Promise<void>;
+        refreshSession(): Promise<boolean>;
+    };
+    fetch(path: string, init?: RequestInit): Promise<Response>;
+    subscribe(listener: () => void): () => void;
+    getState(): AuthState;
+}
+export interface QueryOptions<T = Record<string, unknown>> {
+    filter?: Partial<Record<keyof T, string | number | boolean>>;
+    limit?: number;
+    offset?: number;
+}
+export interface QueryResult<T = unknown> {
+    data: T[] | null;
+    total: number;
+    isLoading: boolean;
+    error: {
+        code: string;
+        message: string;
+    } | null;
+    refetch: () => void;
+}
+export interface MutationResult<T = unknown> {
+    mutate: (data: Partial<T> & Record<string, unknown>) => Promise<T>;
+    isLoading: boolean;
+    error: {
+        code: string;
+        message: string;
+    } | null;
+}
+export interface DefaultTables {
+    [table: string]: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE;QACJ,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QACzB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;KACpC,CAAC;IACF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3D,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,QAAQ,IAAI,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACjD;AAID,MAAM,WAAW,aAAa;IAC5B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@weirdscience/based-client",
+  "version": "0.1.0",
+  "description": "React SDK for Based — a minimal self-hosted BaaS",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/WeirdScience-dev/based.git",
+    "directory": "packages/client"
+  },
+  "homepage": "https://based.weirdscience.dev",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && bun build src/index.ts --outdir dist --target browser --format esm --external react && bun x tsc --emitDeclarationOnly --declaration --outDir dist",
+    "prepublishOnly": "bun run build",
+    "test": "bun test"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "typescript": "^5.0.0"
+  }
+}