@vaiftech/sdk-expo 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 VAIF Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,238 @@
+# @vaif/sdk-expo
+
+React Native and Expo SDK for VAIF Studio - a Backend-as-a-Service platform.
+
+## Installation
+
+```bash
+npm install @vaif/sdk-expo @vaif/client @react-native-async-storage/async-storage
+# or
+pnpm add @vaif/sdk-expo @vaif/client @react-native-async-storage/async-storage
+# or
+yarn add @vaif/sdk-expo @vaif/client @react-native-async-storage/async-storage
+```
+
+## Quick Start
+
+```tsx
+import { VaifProvider } from '@vaif/sdk-expo';
+import { createVaifClient } from '@vaif/client';
+import AsyncStorage from '@react-native-async-storage/async-storage';
+
+const client = createVaifClient({
+  baseUrl: 'https://api.myproject.vaif.io',
+  apiKey: 'vaif_pk_xxx',
+});
+
+export default function App() {
+  return (
+    <VaifProvider client={client} storage={AsyncStorage}>
+      <MainApp />
+    </VaifProvider>
+  );
+}
+```
+
+## Features
+
+### Persistent Sessions
+
+Sessions are automatically persisted using AsyncStorage, so users stay logged in:
+
+```tsx
+import { useAuth } from '@vaif/sdk-expo';
+
+function LoginScreen() {
+  const { user, isLoading, signIn } = useAuth();
+
+  // Session restored from AsyncStorage on app start
+  if (isLoading) return <ActivityIndicator />;
+  if (user) return <Redirect to="/home" />;
+
+  return (
+    <Button
+      title="Sign In"
+      onPress={() => signIn({ email, password })}
+    />
+  );
+}
+```
+
+### Image Upload from Camera/Gallery
+
+Upload images directly from Expo ImagePicker:
+
+```tsx
+import { useUpload } from '@vaif/sdk-expo';
+import * as ImagePicker from 'expo-image-picker';
+
+function ImageUpload() {
+  const { uploadUri, isUploading, progress } = useUpload();
+
+  const pickAndUpload = async () => {
+    const result = await ImagePicker.launchImageLibraryAsync({
+      mediaTypes: ImagePicker.MediaTypeOptions.Images,
+      quality: 0.8,
+    });
+
+    if (!result.canceled) {
+      const { uri } = result.assets[0];
+      const uploaded = await uploadUri(uri, `photos/${Date.now()}.jpg`);
+      console.log('Uploaded:', uploaded?.url);
+    }
+  };
+
+  return (
+    <View>
+      <Button
+        title={isUploading ? `Uploading ${progress}%` : 'Select Image'}
+        onPress={pickAndUpload}
+        disabled={isUploading}
+      />
+    </View>
+  );
+}
+```
+
+### Realtime Updates
+
+```tsx
+import { useRealtime, useRealtimePresence } from '@vaif/sdk-expo';
+
+function ChatRoom({ roomId }) {
+  // Listen for new messages
+  useRealtime('messages', {
+    filters: [{ field: 'room_id', operator: 'eq', value: roomId }],
+    onInsert: (message) => {
+      // New message received
+    },
+  });
+
+  // Track online users
+  const { users, track, leave } = useRealtimePresence(`room-${roomId}`);
+
+  useEffect(() => {
+    track({ status: 'online' });
+    return () => leave();
+  }, []);
+
+  return (
+    <View>
+      <Text>Online: {users.length}</Text>
+    </View>
+  );
+}
+```
+
+## Hooks Reference
+
+### Authentication
+
+```tsx
+import { useAuth, useUser, useSession } from '@vaif/sdk-expo';
+
+// Full auth functionality
+const {
+  user,
+  isLoading,
+  isAuthenticated,
+  signIn,
+  signUp,
+  signOut,
+  signInWithOAuth,
+  updateProfile,
+  changePassword,
+} = useAuth();
+
+// Just the user
+const { user, isLoading } = useUser();
+
+// Session management
+const { session, refresh } = useSession();
+```
+
+### Data
+
+```tsx
+import { useQuery, useMutation, useRealtime } from '@vaif/sdk-expo';
+
+// Fetch data
+const { data, isLoading, error, refetch } = useQuery<Post>('posts', {
+  filters: [{ field: 'published', operator: 'eq', value: true }],
+  orderBy: [{ field: 'createdAt', direction: 'desc' }],
+});
+
+// Mutations
+const { create, update, remove, isLoading } = useMutation<Post>('posts');
+
+// Realtime subscriptions
+useRealtime<Post>('posts', {
+  onInsert: (post) => { /* new post */ },
+  onUpdate: (post) => { /* updated post */ },
+  onDelete: (post) => { /* deleted post */ },
+});
+```
+
+### Storage
+
+```tsx
+import { useUpload, useDownload, usePublicUrl } from '@vaif/sdk-expo';
+
+// Upload files
+const { upload, uploadUri, isUploading, progress } = useUpload();
+
+// Download files
+const { download, isDownloading } = useDownload();
+
+// Get public URL
+const url = usePublicUrl('avatars/user-123.jpg');
+```
+
+### Functions
+
+```tsx
+import { useFunction } from '@vaif/sdk-expo';
+
+const { invoke, isInvoking, result, error } = useFunction('process-image');
+
+const handleProcess = async () => {
+  await invoke({ imageUrl: 'https://...' });
+};
+```
+
+### Presence & Broadcast
+
+```tsx
+import { useRealtimePresence, useRealtimeBroadcast } from '@vaif/sdk-expo';
+
+// Presence tracking
+const { users, track, leave } = useRealtimePresence('room-1');
+
+// Broadcast messaging
+const { send, lastMessage, subscribe } = useRealtimeBroadcast('room-1');
+```
+
+## TypeScript Support
+
+All hooks support TypeScript generics:
+
+```tsx
+interface User {
+  id: string;
+  email: string;
+  name: string;
+}
+
+const { data } = useQuery<User>('users');
+// data is User[] | undefined
+```
+
+## Related Packages
+
+- [@vaif/client](https://www.npmjs.com/package/@vaif/client) - Core client SDK
+- [@vaif/react](https://www.npmjs.com/package/@vaif/react) - React (web) hooks
+- [@vaif/cli](https://www.npmjs.com/package/@vaif/cli) - CLI tools
+
+## License
+
+MIT