@snackbase/sdk 0.1.0

package/dist/react/index.d.mts

@@ -0,0 +1,63 @@
+import { Ft as PasswordResetRequest, It as RegisterData, Ot as AuthState, Pt as PasswordResetConfirm, _t as BaseRecord, kt as LoginCredentials, s as SnackBaseClient, vt as RecordListParams, yt as RecordListResponse } from "../index-Dr6K4PMl.mjs";
+import React from "react";
+
+//#region src/react/SnackBaseContext.d.ts
+interface SnackBaseProviderProps {
+  client: SnackBaseClient;
+  children: React.ReactNode;
+}
+declare const SnackBaseProvider: React.FC<SnackBaseProviderProps>;
+declare const useSnackBase: () => SnackBaseClient;
+//#endregion
+//#region src/react/hooks/useAuth.d.ts
+interface UseAuthResult extends AuthState {
+  login: (credentials: LoginCredentials) => Promise<any>;
+  logout: () => Promise<void>;
+  register: (data: RegisterData) => Promise<any>;
+  forgotPassword: (data: PasswordResetRequest) => Promise<any>;
+  resetPassword: (data: PasswordResetConfirm) => Promise<any>;
+  isLoading: boolean;
+}
+declare const useAuth: () => UseAuthResult;
+//#endregion
+//#region src/react/hooks/useQuery.d.ts
+interface UseQueryResult<T> {
+  data: RecordListResponse<T> | null;
+  loading: boolean;
+  error: Error | null;
+  refetch: () => Promise<void>;
+}
+declare const useQuery: <T = any>(collection: string, params?: RecordListParams) => UseQueryResult<T>;
+//#endregion
+//#region src/react/hooks/useRecord.d.ts
+interface UseRecordResult<T> {
+  data: (T & BaseRecord) | null;
+  loading: boolean;
+  error: Error | null;
+  refetch: () => Promise<void>;
+}
+interface UseRecordOptions {
+  fields?: string[] | string;
+  expand?: string[] | string;
+}
+declare const useRecord: <T = any>(collection: string, id: string, options?: UseRecordOptions) => UseRecordResult<T>;
+//#endregion
+//#region src/react/hooks/useMutation.d.ts
+interface UseMutationResult<T> {
+  create: (data: Partial<T>) => Promise<T & BaseRecord>;
+  update: (id: string, data: Partial<T>) => Promise<T & BaseRecord>;
+  del: (id: string) => Promise<boolean>;
+  loading: boolean;
+  error: Error | null;
+}
+declare const useMutation: <T = any>(collection: string) => UseMutationResult<T>;
+//#endregion
+//#region src/react/hooks/useSubscription.d.ts
+interface UseSubscriptionResult {
+  connected: boolean;
+  error: Error | null;
+}
+declare const useSubscription: <T = any>(collection: string, event: string, // e.g., 'create', 'update', 'delete', '*'
+callback: (data: any) => void) => UseSubscriptionResult;
+//#endregion
+export { SnackBaseProvider, SnackBaseProviderProps, UseAuthResult, UseMutationResult, UseQueryResult, UseRecordOptions, UseRecordResult, UseSubscriptionResult, useAuth, useMutation, useQuery, useRecord, useSnackBase, useSubscription };

package/dist/react/index.mjs

@@ -0,0 +1,271 @@
+import React, { createContext, useCallback, useContext, useEffect, useRef, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/react/SnackBaseContext.tsx
+const SnackBaseContext = createContext(null);
+const SnackBaseProvider = ({ client, children }) => {
+	return /* @__PURE__ */ jsx(SnackBaseContext.Provider, {
+		value: client,
+		children
+	});
+};
+const useSnackBase = () => {
+	const context = useContext(SnackBaseContext);
+	if (!context) throw new Error("useSnackBase must be used within a SnackBaseProvider");
+	return context;
+};
+
+//#endregion
+//#region src/react/hooks/useAuth.ts
+const useAuth = () => {
+	const client = useSnackBase();
+	const [state, setState] = useState({
+		user: client.user,
+		account: client.account,
+		token: client.auth.token,
+		refreshToken: client.auth.refreshToken,
+		isAuthenticated: client.isAuthenticated,
+		expiresAt: null
+	});
+	const [isLoading, setIsLoading] = useState(false);
+	useEffect(() => {
+		setState({
+			user: client.user,
+			account: client.account,
+			token: client.auth.token,
+			refreshToken: client.auth.refreshToken,
+			isAuthenticated: client.isAuthenticated,
+			expiresAt: null
+		});
+		const updateState = (newState) => {
+			setState(newState);
+		};
+		const clearState = () => {
+			setState({
+				user: null,
+				account: null,
+				token: null,
+				refreshToken: null,
+				isAuthenticated: false,
+				expiresAt: null
+			});
+		};
+		const unsubscribeLogin = client.on("auth:login", updateState);
+		const unsubscribeRefresh = client.on("auth:refresh", updateState);
+		const unsubscribeLogout = client.on("auth:logout", clearState);
+		return () => {
+			unsubscribeLogin();
+			unsubscribeRefresh();
+			unsubscribeLogout();
+		};
+	}, [client]);
+	const login = useCallback(async (credentials) => {
+		setIsLoading(true);
+		try {
+			return await client.login(credentials);
+		} finally {
+			setIsLoading(false);
+		}
+	}, [client]);
+	const logout = useCallback(async () => {
+		setIsLoading(true);
+		try {
+			await client.logout();
+		} finally {
+			setIsLoading(false);
+		}
+	}, [client]);
+	const register = useCallback(async (data) => {
+		setIsLoading(true);
+		try {
+			return await client.register(data);
+		} finally {
+			setIsLoading(false);
+		}
+	}, [client]);
+	const forgotPassword = useCallback(async (data) => {
+		setIsLoading(true);
+		try {
+			return await client.forgotPassword(data);
+		} finally {
+			setIsLoading(false);
+		}
+	}, [client]);
+	const resetPassword = useCallback(async (data) => {
+		setIsLoading(true);
+		try {
+			return await client.resetPassword(data);
+		} finally {
+			setIsLoading(false);
+		}
+	}, [client]);
+	return {
+		...state,
+		login,
+		logout,
+		register,
+		forgotPassword,
+		resetPassword,
+		isLoading
+	};
+};
+
+//#endregion
+//#region src/react/hooks/useQuery.ts
+const useQuery = (collection, params) => {
+	const client = useSnackBase();
+	const [data, setData] = useState(null);
+	const [loading, setLoading] = useState(true);
+	const [error, setError] = useState(null);
+	const paramsKey = JSON.stringify(params);
+	const paramsRef = useRef(params);
+	if (JSON.stringify(paramsRef.current) !== paramsKey) paramsRef.current = params;
+	const fetchData = useCallback(async () => {
+		setLoading(true);
+		setError(null);
+		try {
+			setData(await client.records.list(collection, paramsRef.current));
+		} catch (err) {
+			setError(err);
+		} finally {
+			setLoading(false);
+		}
+	}, [
+		client,
+		collection,
+		paramsKey
+	]);
+	useEffect(() => {
+		fetchData();
+	}, [fetchData]);
+	return {
+		data,
+		loading,
+		error,
+		refetch: fetchData
+	};
+};
+
+//#endregion
+//#region src/react/hooks/useRecord.ts
+const useRecord = (collection, id, options) => {
+	const client = useSnackBase();
+	const [data, setData] = useState(null);
+	const [loading, setLoading] = useState(true);
+	const [error, setError] = useState(null);
+	const fetchData = useCallback(async () => {
+		if (!id) return;
+		setLoading(true);
+		setError(null);
+		try {
+			setData(await client.records.get(collection, id, options));
+		} catch (err) {
+			setError(err);
+		} finally {
+			setLoading(false);
+		}
+	}, [
+		client,
+		collection,
+		id,
+		JSON.stringify(options)
+	]);
+	useEffect(() => {
+		fetchData();
+	}, [fetchData]);
+	return {
+		data,
+		loading,
+		error,
+		refetch: fetchData
+	};
+};
+
+//#endregion
+//#region src/react/hooks/useMutation.ts
+const useMutation = (collection) => {
+	const client = useSnackBase();
+	const [loading, setLoading] = useState(false);
+	const [error, setError] = useState(null);
+	return {
+		create: useCallback(async (data) => {
+			setLoading(true);
+			setError(null);
+			try {
+				return await client.records.create(collection, data);
+			} catch (err) {
+				setError(err);
+				throw err;
+			} finally {
+				setLoading(false);
+			}
+		}, [client, collection]),
+		update: useCallback(async (id, data) => {
+			setLoading(true);
+			setError(null);
+			try {
+				return await client.records.update(collection, id, data);
+			} catch (err) {
+				setError(err);
+				throw err;
+			} finally {
+				setLoading(false);
+			}
+		}, [client, collection]),
+		del: useCallback(async (id) => {
+			setLoading(true);
+			setError(null);
+			try {
+				await client.records.delete(collection, id);
+				return true;
+			} catch (err) {
+				setError(err);
+				throw err;
+			} finally {
+				setLoading(false);
+			}
+		}, [client, collection]),
+		loading,
+		error
+	};
+};
+
+//#endregion
+//#region src/react/hooks/useSubscription.ts
+const useSubscription = (collection, event, callback) => {
+	const client = useSnackBase();
+	const [connected, setConnected] = useState(false);
+	const [error, setError] = useState(null);
+	useEffect(() => {
+		let unsubscribe;
+		const setupSubscription = async () => {
+			try {
+				await client.realtime.subscribe(collection, event === "*" ? void 0 : [event]);
+				setConnected(true);
+				const eventType = event === "*" ? `${collection}.*` : `${collection}.${event}`;
+				unsubscribe = client.realtime.on(eventType, (e) => {
+					callback(e.data);
+				});
+			} catch (err) {
+				setError(err);
+				setConnected(false);
+			}
+		};
+		setupSubscription();
+		return () => {
+			if (unsubscribe) unsubscribe();
+			client.realtime.unsubscribe(collection).catch(console.error);
+		};
+	}, [
+		client,
+		collection,
+		event
+	]);
+	return {
+		connected,
+		error
+	};
+};
+
+//#endregion
+export { SnackBaseProvider, useAuth, useMutation, useQuery, useRecord, useSnackBase, useSubscription };

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@snackbase/sdk",
+  "version": "0.1.0",
+  "description": "JavaScript/TypeScript SDK for SnackBase",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react/index.mjs",
+      "require": "./dist/react/index.js",
+      "types": "./dist/react/index.d.ts"
+    }
+  },
+  "scripts": {
+    "dev": "tsdown src/index.ts src/react/index.ts --watch",
+    "build": "tsdown src/index.ts src/react/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@vitejs/plugin-react": "^5.1.2",
+    "jsdom": "^27.4.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "tsdown": "^0.20.0-beta.4",
+    "typescript": "^5.3.3",
+    "vite": "^7.3.1",
+    "vitest": "^1.2.1"
+  }
+}