@fluxbase/sdk-react 0.0.1-rc.2

package/src/use-users.ts

@@ -0,0 +1,191 @@
+import { useState, useEffect, useCallback } from 'react'
+import { useFluxbaseClient } from './context'
+import type { EnrichedUser, ListUsersOptions } from '@fluxbase/sdk'
+
+export interface UseUsersOptions extends ListUsersOptions {
+  /**
+   * Whether to automatically fetch users on mount
+   * @default true
+   */
+  autoFetch?: boolean
+
+  /**
+   * Refetch interval in milliseconds (0 to disable)
+   * @default 0
+   */
+  refetchInterval?: number
+}
+
+export interface UseUsersReturn {
+  /**
+   * Array of users
+   */
+  users: EnrichedUser[]
+
+  /**
+   * Total number of users (for pagination)
+   */
+  total: number
+
+  /**
+   * Whether users are being fetched
+   */
+  isLoading: boolean
+
+  /**
+   * Any error that occurred
+   */
+  error: Error | null
+
+  /**
+   * Refetch users
+   */
+  refetch: () => Promise<void>
+
+  /**
+   * Invite a new user
+   */
+  inviteUser: (email: string, role: 'user' | 'admin') => Promise<void>
+
+  /**
+   * Update user role
+   */
+  updateUserRole: (userId: string, role: 'user' | 'admin') => Promise<void>
+
+  /**
+   * Delete a user
+   */
+  deleteUser: (userId: string) => Promise<void>
+
+  /**
+   * Reset user password
+   */
+  resetPassword: (userId: string) => Promise<{ message: string }>
+}
+
+/**
+ * Hook for managing users
+ *
+ * Provides user list with pagination, search, and management functions.
+ *
+ * @example
+ * ```tsx
+ * function UserList() {
+ *   const { users, total, isLoading, refetch, inviteUser, deleteUser } = useUsers({
+ *     limit: 20,
+ *     search: searchTerm
+ *   })
+ *
+ *   return (
+ *     <div>
+ *       {isLoading ? <Spinner /> : (
+ *         <ul>
+ *           {users.map(user => (
+ *             <li key={user.id}>
+ *               {user.email} - {user.role}
+ *               <button onClick={() => deleteUser(user.id)}>Delete</button>
+ *             </li>
+ *           ))}
+ *         </ul>
+ *       )}
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export function useUsers(options: UseUsersOptions = {}): UseUsersReturn {
+  const { autoFetch = true, refetchInterval = 0, ...listOptions } = options
+  const client = useFluxbaseClient()
+
+  const [users, setUsers] = useState<EnrichedUser[]>([])
+  const [total, setTotal] = useState(0)
+  const [isLoading, setIsLoading] = useState(autoFetch)
+  const [error, setError] = useState<Error | null>(null)
+
+  /**
+   * Fetch users from API
+   */
+  const fetchUsers = useCallback(async () => {
+    try {
+      setIsLoading(true)
+      setError(null)
+      const response = await client.admin.listUsers(listOptions)
+      setUsers(response.users)
+      setTotal(response.total)
+    } catch (err) {
+      setError(err as Error)
+    } finally {
+      setIsLoading(false)
+    }
+  }, [client, JSON.stringify(listOptions)])
+
+  /**
+   * Invite a new user
+   */
+  const inviteUser = useCallback(
+    async (email: string, role: 'user' | 'admin'): Promise<void> => {
+      await client.admin.inviteUser({ email, role })
+      await fetchUsers() // Refresh list
+    },
+    [client, fetchUsers]
+  )
+
+  /**
+   * Update user role
+   */
+  const updateUserRole = useCallback(
+    async (userId: string, role: 'user' | 'admin'): Promise<void> => {
+      await client.admin.updateUserRole(userId, role)
+      await fetchUsers() // Refresh list
+    },
+    [client, fetchUsers]
+  )
+
+  /**
+   * Delete a user
+   */
+  const deleteUser = useCallback(
+    async (userId: string): Promise<void> => {
+      await client.admin.deleteUser(userId)
+      await fetchUsers() // Refresh list
+    },
+    [client, fetchUsers]
+  )
+
+  /**
+   * Reset user password
+   */
+  const resetPassword = useCallback(
+    async (userId: string): Promise<{ message: string }> => {
+      return await client.admin.resetUserPassword(userId)
+    },
+    [client]
+  )
+
+  // Auto-fetch on mount
+  useEffect(() => {
+    if (autoFetch) {
+      fetchUsers()
+    }
+  }, [autoFetch, fetchUsers])
+
+  // Set up refetch interval
+  useEffect(() => {
+    if (refetchInterval > 0) {
+      const interval = setInterval(fetchUsers, refetchInterval)
+      return () => clearInterval(interval)
+    }
+  }, [refetchInterval, fetchUsers])
+
+  return {
+    users,
+    total,
+    isLoading,
+    error,
+    refetch: fetchUsers,
+    inviteUser,
+    updateUserRole,
+    deleteUser,
+    resetPassword
+  }
+}

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/context.tsx","./src/index.ts","./src/use-admin-auth.ts","./src/use-admin-hooks.ts","./src/use-api-keys.ts","./src/use-auth.ts","./src/use-query.ts","./src/use-realtime.ts","./src/use-rpc.ts","./src/use-storage.ts","./src/use-users.ts"],"version":"5.9.3"}

package/tsup.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'tsup'
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm', 'cjs'],
+  dts: true,
+  splitting: false,
+  sourcemap: true,
+  clean: true,
+  external: ['react', '@tanstack/react-query', '@fluxbase/sdk'],
+})

package/typedoc.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://typedoc.org/schema.json",
+  "entryPoints": [
+    "src/index.ts"
+  ],
+  "out": "../docs/static/api/sdk-react",
+  "name": "@fluxbase/sdk-react",
+  "readme": "README.md",
+  "plugin": [],
+  "excludePrivate": true,
+  "excludeProtected": false,
+  "excludeInternal": true,
+  "includeVersion": true,
+  "searchInComments": true,
+  "validation": {
+    "notExported": true,
+    "invalidLink": true,
+    "notDocumented": false
+  },
+  "categorizeByGroup": true,
+  "categoryOrder": [
+    "Context",
+    "Authentication Hooks",
+    "Database Hooks",
+    "Realtime Hooks",
+    "Storage Hooks",
+    "RPC Hooks",
+    "Types",
+    "*"
+  ],
+  "navigationLinks": {
+    "GitHub": "https://github.com/yourusername/fluxbase",
+    "Documentation": "https://fluxbase.eu"
+  }
+}