@shaykec/app-agent 1.0.5 → 1.0.7

package/templates/shared/android/SupabaseBackend/strings.xml

@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!-- Auth Actions -->
+    <string name="supabase_sign_in">Sign In</string>
+    <string name="supabase_sign_up">Sign Up</string>
+    <string name="supabase_sign_out">Sign Out</string>
+    <string name="supabase_create_account">Create Account</string>
+    
+    <!-- Form Fields -->
+    <string name="supabase_email">Email</string>
+    <string name="supabase_password">Password</string>
+    <string name="supabase_confirm_password">Confirm Password</string>
+    
+    <!-- Magic Link -->
+    <string name="supabase_use_magic_link">Use Magic Link</string>
+    <string name="supabase_send_magic_link">Send Magic Link</string>
+    <string name="supabase_magic_link_sent_title">Check Your Email</string>
+    <string name="supabase_magic_link_sent_message">We sent a magic link to %1$s. Click the link to sign in.</string>
+    <string name="supabase_magic_link_instructions">The link will expire in 1 hour.</string>
+    <string name="supabase_open_email">Open Email</string>
+    <string name="supabase_resend_magic_link">Resend Magic Link</string>
+    <string name="supabase_resend_magic_link_countdown">Resend in %1$ds</string>
+    
+    <!-- Password Reset -->
+    <string name="supabase_forgot_password">Forgot Password?</string>
+    <string name="supabase_forgot_password_title">Reset Password</string>
+    <string name="supabase_forgot_password_message">Enter your email address and we\'ll send you a link to reset your password.</string>
+    <string name="supabase_send_reset_link">Send Reset Link</string>
+    <string name="supabase_password_reset_sent">Password Reset Sent</string>
+    <string name="supabase_password_reset_instructions">Check your email for instructions on how to reset your password.</string>
+    <string name="supabase_back_to_sign_in">Back to Sign In</string>
+    
+    <!-- Social Login -->
+    <string name="supabase_or_continue_with">or continue with</string>
+    <string name="supabase_sign_in_with_google">Sign in with Google</string>
+    <string name="supabase_sign_in_with_apple">Sign in with Apple</string>
+    <string name="supabase_sign_in_with_github">Sign in with GitHub</string>
+    <string name="supabase_sign_in_with_facebook">Sign in with Facebook</string>
+    
+    <!-- Navigation Links -->
+    <string name="supabase_no_account">Don\'t have an account?</string>
+    <string name="supabase_already_have_account">Already have an account?</string>
+    
+    <!-- Profile -->
+    <string name="supabase_profile">Profile</string>
+    <string name="supabase_no_email">No email</string>
+    <string name="supabase_provider_badge">Signed in with %1$s</string>
+    <string name="supabase_delete_account">Delete Account</string>
+    <string name="supabase_delete_account_title">Delete Account</string>
+    <string name="supabase_delete_account_message">Are you sure you want to delete your account? This action cannot be undone.</string>
+    <string name="supabase_delete">Delete</string>
+    <string name="supabase_cancel">Cancel</string>
+    
+    <!-- Errors -->
+    <string name="supabase_invalid_email">Invalid email address</string>
+    <string name="supabase_weak_password">Password must be at least 6 characters</string>
+    <string name="supabase_password_mismatch">Passwords do not match</string>
+    <string name="supabase_user_not_found">No account found with this email</string>
+    <string name="supabase_wrong_password">Incorrect password</string>
+    <string name="supabase_email_already_in_use">This email is already registered</string>
+    <string name="supabase_network_error">Network error. Please check your connection</string>
+    <string name="supabase_session_expired">Session expired. Please sign in again</string>
+</resources>

package/templates/shared/android/SupabaseProvider/SupabaseAuthManager.kt

@@ -0,0 +1,254 @@
+package com.appship.shared.supabase
+
+import android.content.Context
+import io.github.jan.supabase.SupabaseClient
+import io.github.jan.supabase.auth.auth
+import io.github.jan.supabase.auth.providers.builtin.Email
+import io.github.jan.supabase.auth.providers.builtin.OTP
+import io.github.jan.supabase.auth.providers.oauth.OAuthProvider
+import io.github.jan.supabase.gotrue.auth
+import io.github.jan.supabase.gotrue.providers.builtin.Email as EmailProvider
+import io.github.jan.supabase.gotrue.providers.builtin.OTP as OTPProvider
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.asStateFlow
+
+/**
+ * Supabase authentication manager with email, magic link (OTP), and OAuth support.
+ * Manages auth state, session persistence, and sign-in flows.
+ */
+class SupabaseAuthManager(
+    private val supabase: SupabaseClient
+) {
+    private val _currentUser = MutableStateFlow(supabase.auth.currentUserOrNull())
+    val currentUser: StateFlow<io.github.jan.supabase.auth.user.UserInfo?> = _currentUser.asStateFlow()
+    
+    private val _isAuthenticated = MutableStateFlow<Boolean>(supabase.auth.currentUserOrNull() != null)
+    val isAuthenticated: StateFlow<Boolean> = _isAuthenticated.asStateFlow()
+    
+    private val _isLoading = MutableStateFlow<Boolean>(false)
+    val isLoading: StateFlow<Boolean> = _isLoading.asStateFlow()
+    
+    private val _error = MutableStateFlow<String?>(null)
+    val error: StateFlow<String?> = _error.asStateFlow()
+    
+    init {
+        setupAuthStateListener()
+    }
+    
+    private fun setupAuthStateListener() {
+        // Supabase auth state changes are handled via session updates
+        // Listen to auth state changes
+        supabase.auth.onAuthStateChange { _, session ->
+            _currentUser.value = session?.user
+            _isAuthenticated.value = session != null
+        }
+    }
+    
+    /**
+     * Sign in with email and password
+     */
+    suspend fun signIn(email: String, password: String): Result<io.github.jan.supabase.auth.user.UserInfo> {
+        return try {
+            _isLoading.value = true
+            _error.value = null
+            
+            val result = supabase.auth.signInWith(EmailProvider) {
+                this.email = email
+                this.password = password
+            }
+            
+            _currentUser.value = result.user
+            Result.success(result.user)
+        } catch (e: Exception) {
+            _error.value = e.message ?: "Sign in failed"
+            Result.failure(e)
+        } finally {
+            _isLoading.value = false
+        }
+    }
+    
+    /**
+     * Sign up with email and password
+     */
+    suspend fun signUp(email: String, password: String): Result<io.github.jan.supabase.auth.user.UserInfo> {
+        return try {
+            _isLoading.value = true
+            _error.value = null
+            
+            val result = supabase.auth.signUpWith(EmailProvider) {
+                this.email = email
+                this.password = password
+            }
+            
+            _currentUser.value = result.user
+            Result.success(result.user)
+        } catch (e: Exception) {
+            _error.value = e.message ?: "Sign up failed"
+            Result.failure(e)
+        } finally {
+            _isLoading.value = false
+        }
+    }
+    
+    /**
+     * Sign in with magic link (OTP)
+     * Sends a one-time password to the email
+     */
+    suspend fun signInWithMagicLink(email: String): Result<Unit> {
+        return try {
+            _isLoading.value = true
+            _error.value = null
+            
+            supabase.auth.signInWith(OTPProvider) {
+                this.email = email
+            }
+            
+            Result.success(Unit)
+        } catch (e: Exception) {
+            _error.value = e.message ?: "Magic link send failed"
+            Result.failure(e)
+        } finally {
+            _isLoading.value = false
+        }
+    }
+    
+    /**
+     * Verify OTP code from magic link
+     */
+    suspend fun verifyOTP(email: String, token: String): Result<io.github.jan.supabase.auth.user.UserInfo> {
+        return try {
+            _isLoading.value = true
+            _error.value = null
+            
+            val result = supabase.auth.verifyEmailOtp(
+                type = io.github.jan.supabase.auth.EmailOtpType.EMAIL,
+                email = email,
+                token = token
+            )
+            
+            _currentUser.value = result.user
+            Result.success(result.user)
+        } catch (e: Exception) {
+            _error.value = e.message ?: "OTP verification failed"
+            Result.failure(e)
+        } finally {
+            _isLoading.value = false
+        }
+    }
+    
+    /**
+     * Sign in with OAuth provider (Google, GitHub, etc.)
+     * Returns a URL that should be opened in a browser/webview
+     */
+    suspend fun signInWithOAuth(provider: OAuthProvider): Result<String> {
+        return try {
+            _isLoading.value = true
+            _error.value = null
+            
+            val url = supabase.auth.getOAuthUrl(provider)
+            Result.success(url)
+        } catch (e: Exception) {
+            _error.value = e.message ?: "OAuth sign in failed"
+            Result.failure(e)
+        } finally {
+            _isLoading.value = false
+        }
+    }
+    
+    /**
+     * Handle OAuth callback URL after user completes OAuth flow
+     */
+    suspend fun handleOAuthCallback(url: String): Result<io.github.jan.supabase.auth.user.UserInfo> {
+        return try {
+            _isLoading.value = true
+            _error.value = null
+            
+            val result = supabase.auth.verifyOAuthCallback(url)
+            _currentUser.value = result.user
+            Result.success(result.user)
+        } catch (e: Exception) {
+            _error.value = e.message ?: "OAuth callback handling failed"
+            Result.failure(e)
+        } finally {
+            _isLoading.value = false
+        }
+    }
+    
+    /**
+     * Sign out
+     */
+    suspend fun signOut() {
+        try {
+            supabase.auth.signOut()
+            _currentUser.value = null
+            _isAuthenticated.value = false
+        } catch (e: Exception) {
+            _error.value = e.message ?: "Sign out failed"
+        }
+    }
+    
+    /**
+     * Reset password via email
+     */
+    suspend fun resetPassword(email: String): Result<Unit> {
+        return try {
+            _isLoading.value = true
+            _error.value = null
+            
+            supabase.auth.resetPasswordForEmail(email)
+            Result.success(Unit)
+        } catch (e: Exception) {
+            _error.value = e.message ?: "Password reset failed"
+            Result.failure(e)
+        } finally {
+            _isLoading.value = false
+        }
+    }
+    
+    /**
+     * Update password
+     */
+    suspend fun updatePassword(newPassword: String): Result<Unit> {
+        return try {
+            _isLoading.value = true
+            _error.value = null
+            
+            supabase.auth.updateUser {
+                password = newPassword
+            }
+            
+            Result.success(Unit)
+        } catch (e: Exception) {
+            _error.value = e.message ?: "Password update failed"
+            Result.failure(e)
+        } finally {
+            _isLoading.value = false
+        }
+    }
+    
+    /**
+     * Get current user's email
+     */
+    fun getCurrentUserEmail(): String? = supabase.auth.currentUserOrNull()?.email
+    
+    /**
+     * Get current user's display name
+     */
+    fun getCurrentUserDisplayName(): String? = supabase.auth.currentUserOrNull()?.userMetadata?.get("display_name") as? String
+    
+    /**
+     * Update user's display name
+     */
+    suspend fun updateDisplayName(name: String): Result<Unit> {
+        return try {
+            supabase.auth.updateUser {
+                data("display_name", name)
+            }
+            Result.success(Unit)
+        } catch (e: Exception) {
+            _error.value = e.message ?: "Update display name failed"
+            Result.failure(e)
+        }
+    }
+}

package/templates/shared/android/SupabaseProvider/SupabaseConfig.kt

@@ -0,0 +1,89 @@
+package com.appship.shared.supabase
+
+import io.github.jan.supabase.SupabaseClient
+import io.github.jan.supabase.createSupabaseClient
+import io.github.jan.supabase.gotrue.auth
+import io.github.jan.supabase.postgrest.postgrest
+import io.github.jan.supabase.realtime.realtime
+
+/**
+ * Supabase configuration with placeholder values.
+ * CUSTOMIZE: Replace with your Supabase project settings.
+ */
+object SupabaseConfig {
+    // CUSTOMIZE: Your Supabase project URL (found in Supabase Dashboard > Settings > API)
+    const val SUPABASE_URL = "https://your-project.supabase.co"
+    
+    // CUSTOMIZE: Your Supabase anonymous key (found in Supabase Dashboard > Settings > API)
+    // This is safe to use in client apps - Row Level Security (RLS) protects your data
+    const val SUPABASE_ANON_KEY = "your-anon-key"
+    
+    // CUSTOMIZE: Database table names
+    const val TABLE_ITEMS = "items"
+    const val TABLE_CATEGORIES = "categories"
+    const val TABLE_USERS = "users"
+    
+    // CUSTOMIZE: Add more table names as needed
+    // const val TABLE_ORDERS = "orders"
+    // const val TABLE_REVIEWS = "reviews"
+    
+    /**
+     * Create a Supabase client instance.
+     * Call this once in your app's dependency injection setup.
+     */
+    fun createClient(): SupabaseClient {
+        return createSupabaseClient(
+            supabaseUrl = SUPABASE_URL,
+            supabaseKey = SUPABASE_ANON_KEY
+        ) {
+            install(auth)
+            install(postgrest)
+            install(realtime)
+        }
+    }
+    
+    /**
+     * Row-Level Security (RLS) policy hints.
+     * Copy these SQL policies to Supabase Dashboard > Authentication > Policies
+     * 
+     * -- Enable RLS on tables
+     * ALTER TABLE items ENABLE ROW LEVEL SECURITY;
+     * ALTER TABLE categories ENABLE ROW LEVEL SECURITY;
+     * ALTER TABLE users ENABLE ROW LEVEL SECURITY;
+     * 
+     * -- Users can only read/write their own items
+     * CREATE POLICY "Users can view own items"
+     *   ON items FOR SELECT
+     *   USING (auth.uid() = user_id);
+     * 
+     * CREATE POLICY "Users can insert own items"
+     *   ON items FOR INSERT
+     *   WITH CHECK (auth.uid() = user_id);
+     * 
+     * CREATE POLICY "Users can update own items"
+     *   ON items FOR UPDATE
+     *   USING (auth.uid() = user_id);
+     * 
+     * CREATE POLICY "Users can delete own items"
+     *   ON items FOR DELETE
+     *   USING (auth.uid() = user_id);
+     * 
+     * -- Categories are read-only for all authenticated users
+     * CREATE POLICY "Users can view categories"
+     *   ON categories FOR SELECT
+     *   USING (auth.role() = 'authenticated');
+     * 
+     * -- User profiles
+     * CREATE POLICY "Users can view own profile"
+     *   ON users FOR SELECT
+     *   USING (auth.uid() = id);
+     * 
+     * CREATE POLICY "Users can update own profile"
+     *   ON users FOR UPDATE
+     *   USING (auth.uid() = id);
+     */
+    val RLS_POLICY_HINT = """
+        Configure Row-Level Security (RLS) policies in Supabase Dashboard.
+        Ensure users can only access their own data.
+    """.trimIndent()
+}

package/templates/shared/android/SupabaseProvider/SupabaseDataProvider.kt

@@ -0,0 +1,232 @@
+package com.appship.shared.supabase
+
+import io.github.jan.supabase.SupabaseClient
+import io.github.jan.supabase.postgrest.from
+import io.github.jan.supabase.realtime.RealtimeChannel
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.asStateFlow
+import kotlinx.coroutines.launch
+
+/**
+ * DataRepository implementation using Supabase Kotlin client.
+ * Uses Supabase PostgREST for queries and real-time subscriptions.
+ * 
+ * Note: Supabase doesn't have built-in offline persistence.
+ * Use CachedRepository wrapper for offline support.
+ * 
+ * CUSTOMIZE: Replace Item, Category with your app's domain models.
+ * CUSTOMIZE: Adjust table names in SupabaseConfig.
+ */
+class SupabaseDataProvider(
+    private val supabase: SupabaseClient,
+    private val scope: CoroutineScope = CoroutineScope(Dispatchers.IO)
+) : DataRepository {
+    private val _items = MutableStateFlow<List<Item>>(emptyList())
+    override val items: StateFlow<List<Item>> = _items.asStateFlow()
+    
+    private val _categories = MutableStateFlow<List<Category>>(emptyList())
+    override val categories: StateFlow<List<Category>> = _categories.asStateFlow()
+    
+    private val _favoriteItems = MutableStateFlow<List<Item>>(emptyList())
+    override val favoriteItems: StateFlow<List<Item>> = _favoriteItems.asStateFlow()
+    
+    private var itemsChannel: RealtimeChannel? = null
+    private var categoriesChannel: RealtimeChannel? = null
+    
+    init {
+        setupRealtimeSubscriptions()
+        scope.launch {
+            loadData()
+        }
+    }
+    
+    private fun setupRealtimeSubscriptions() {
+        // Real-time subscription for items
+        itemsChannel = supabase.channel("items_channel") {
+            on("postgres_changes") {
+                filter = "table=eq:${SupabaseConfig.TABLE_ITEMS}"
+                // Reload items when changes occur
+                scope.launch {
+                    loadData()
+                }
+            }
+        }
+        itemsChannel?.subscribe()
+        
+        // Real-time subscription for categories
+        categoriesChannel = supabase.channel("categories_channel") {
+            on("postgres_changes") {
+                filter = "table=eq:${SupabaseConfig.TABLE_CATEGORIES}"
+                // Reload categories when changes occur
+                scope.launch {
+                    loadCategories()
+                }
+            }
+        }
+        categoriesChannel?.subscribe()
+    }
+    
+    override fun loadData() {
+        scope.launch {
+            loadItems()
+            loadCategories()
+        }
+    }
+    
+    private suspend fun loadItems() {
+        try {
+            val userId = supabase.auth.currentUserOrNull()?.id ?: return
+            val result = supabase.from(SupabaseConfig.TABLE_ITEMS)
+                .select {
+                    filter {
+                        eq("user_id", userId)
+                    }
+                    order("created_at", ascending = false)
+                }
+                .decodeList<Item>()
+            
+            _items.value = result
+            _favoriteItems.value = result.filter { it.isFavorite }
+        } catch (e: Exception) {
+            // CUSTOMIZE: Handle error appropriately
+            e.printStackTrace()
+        }
+    }
+    
+    private suspend fun loadCategories() {
+        try {
+            val result = supabase.from(SupabaseConfig.TABLE_CATEGORIES)
+                .select()
+                .decodeList<Category>()
+            
+            _categories.value = result
+        } catch (e: Exception) {
+            // CUSTOMIZE: Handle error appropriately
+            e.printStackTrace()
+        }
+    }
+    
+    override fun addItem(item: Item) {
+        scope.launch {
+            addItemInternal(item)
+        }
+    }
+    
+    private suspend fun addItemInternal(item: Item) {
+        try {
+            val userId = supabase.auth.currentUserOrNull()?.id ?: return
+            val data = item.copy(
+                id = java.util.UUID.randomUUID().toString(),
+                metadata = item.metadata + ("user_id" to userId, "created_at" to System.currentTimeMillis())
+            )
+            supabase.from(SupabaseConfig.TABLE_ITEMS)
+                .insert(data)
+        } catch (e: Exception) {
+            // CUSTOMIZE: Handle error appropriately
+            throw e
+        }
+    }
+    
+    override fun updateItem(item: Item) {
+        scope.launch {
+            updateItemInternal(item)
+        }
+    }
+    
+    private suspend fun updateItemInternal(item: Item) {
+        try {
+            supabase.from(SupabaseConfig.TABLE_ITEMS)
+                .update(item) {
+                    filter {
+                        eq("id", item.id)
+                    }
+                }
+        } catch (e: Exception) {
+            // CUSTOMIZE: Handle error appropriately
+            throw e
+        }
+    }
+    
+    override fun deleteItem(item: Item) {
+        scope.launch {
+            deleteItemInternal(item)
+        }
+    }
+    
+    private suspend fun deleteItemInternal(item: Item) {
+        try {
+            supabase.from(SupabaseConfig.TABLE_ITEMS)
+                .delete {
+                    filter {
+                        eq("id", item.id)
+                    }
+                }
+        } catch (e: Exception) {
+            // CUSTOMIZE: Handle error appropriately
+            throw e
+        }
+    }
+    
+    override fun toggleFavorite(item: Item) {
+        val updated = item.copy(isFavorite = !item.isFavorite)
+        updateItem(updated)
+    }
+    
+    override fun searchItems(query: String): List<Item> {
+        if (query.isBlank()) return _items.value
+        val lower = query.lowercase()
+        return _items.value.filter {
+            it.title.lowercase().contains(lower) || 
+            it.subtitle?.lowercase()?.contains(lower) == true
+        }
+    }
+    
+    override fun itemsByCategory(categoryName: String): List<Item> {
+        return _items.value.filter { it.category == categoryName }
+    }
+    
+    fun cleanup() {
+        itemsChannel?.unsubscribe()
+        categoriesChannel?.unsubscribe()
+    }
+}
+
+/**
+ * CUSTOMIZE: Replace with your app's domain models.
+ * These are placeholder models that the agent will replace during integration.
+ */
+data class Item(
+    val id: String,
+    val title: String,
+    val subtitle: String? = null,
+    val category: String? = null,
+    val isFavorite: Boolean = false,
+    val metadata: Map<String, Any> = emptyMap()
+)
+
+data class Category(
+    val id: String,
+    val name: String,
+    val metadata: Map<String, Any> = emptyMap()
+)
+
+/**
+ * CUSTOMIZE: Replace with your app's DataRepository interface.
+ * This is a placeholder interface that matches the Skeleton template pattern.
+ */
+interface DataRepository {
+    val items: StateFlow<List<Item>>
+    val categories: StateFlow<List<Category>>
+    val favoriteItems: StateFlow<List<Item>>
+    
+    fun loadData()
+    fun addItem(item: Item)
+    fun updateItem(item: Item)
+    fun deleteItem(item: Item)
+    fun toggleFavorite(item: Item)
+    fun searchItems(query: String): List<Item>
+    fun itemsByCategory(categoryName: String): List<Item>
+}

package/templates/shared/android/SupabaseProvider/strings.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!-- Supabase Auth Module -->
+    <string name="supabase_auth_sign_in_title">Sign In</string>
+    <string name="supabase_auth_sign_up_title">Create Account</string>
+    <string name="supabase_auth_email_label">Email</string>
+    <string name="supabase_auth_password_label">Password</string>
+    <string name="supabase_auth_sign_in_button">Sign In</string>
+    <string name="supabase_auth_sign_up_button">Sign Up</string>
+    <string name="supabase_auth_sign_out_button">Sign Out</string>
+    <string name="supabase_auth_forgot_password">Forgot Password?</string>
+    <string name="supabase_auth_reset_password">Reset Password</string>
+    <string name="supabase_auth_reset_password_sent">Password reset email sent</string>
+    <string name="supabase_auth_magic_link">Sign in with magic link</string>
+    <string name="supabase_auth_magic_link_sent">Magic link sent to your email</string>
+    <string name="supabase_auth_verify_code">Verify Code</string>
+    <string name="supabase_auth_enter_code">Enter the code sent to your email</string>
+    <string name="supabase_auth_google_sign_in">Sign in with Google</string>
+    <string name="supabase_auth_github_sign_in">Sign in with GitHub</string>
+    <string name="supabase_auth_already_have_account">Already have an account? Sign in</string>
+    <string name="supabase_auth_no_account">Don\'t have an account? Sign up</string>
+    <string name="supabase_auth_loading">Signing in…</string>
+    <string name="supabase_auth_error_invalid_email">Invalid email address</string>
+    <string name="supabase_auth_error_weak_password">Password should be at least 6 characters</string>
+    <string name="supabase_auth_error_user_not_found">No account found with this email</string>
+    <string name="supabase_auth_error_wrong_password">Incorrect password</string>
+    <string name="supabase_auth_error_email_already_in_use">This email is already registered</string>
+    <string name="supabase_auth_error_network">Network error. Please check your connection.</string>
+    <string name="supabase_auth_error_unknown">An error occurred. Please try again.</string>
+</resources>