@shaykec/app-agent 1.0.5 → 1.0.6

package/templates/shared/ios/FirebaseBackend/Strings.swift

@@ -0,0 +1,69 @@
+import Foundation
+
+/// Centralized strings for FirebaseBackend module.
+enum Strings {
+    enum Firebase {
+        enum Login {
+            static let title = "Welcome Back"
+            static let subtitle = "Sign in to continue"
+            static let emailLabel = "Email"
+            static let emailPlaceholder = "Enter your email"
+            static let passwordLabel = "Password"
+            static let passwordPlaceholder = "Enter your password"
+            static let signInButton = "Sign In"
+            static let forgotPasswordButton = "Forgot Password?"
+            static let orDivider = "OR"
+            static let googleButton = "Continue with Google"
+            static let noAccountPrompt = "Don't have an account?"
+            static let signUpLink = "Sign Up"
+        }
+        
+        enum SignUp {
+            static let title = "Create Account"
+            static let subtitle = "Sign up to get started"
+            static let navigationTitle = "Sign Up"
+            static let displayNameLabel = "Display Name"
+            static let displayNamePlaceholder = "Enter your name"
+            static let emailLabel = "Email"
+            static let emailPlaceholder = "Enter your email"
+            static let passwordLabel = "Password"
+            static let passwordPlaceholder = "Create a password"
+            static let confirmPasswordLabel = "Confirm Password"
+            static let confirmPasswordPlaceholder = "Confirm your password"
+            static let passwordHint = "Password must be at least 6 characters"
+            static let passwordMismatch = "Passwords do not match"
+            static let createAccountButton = "Create Account"
+        }
+        
+        enum ForgotPassword {
+            static let title = "Reset Password"
+            static let subtitle = "Enter your email address and we'll send you a link to reset your password"
+            static let navigationTitle = "Forgot Password"
+            static let emailLabel = "Email"
+            static let emailPlaceholder = "Enter your email"
+            static let sendButton = "Send Reset Link"
+            static let successTitle = "Check Your Email"
+            static func successMessage(email: String) -> String {
+                "We've sent a password reset link to \(email)"
+            }
+        }
+        
+        enum Profile {
+            static let navigationTitle = "Profile"
+            static func userId(_ uid: String) -> String {
+                "User ID: \(uid)"
+            }
+            static let providersTitle = "Connected Accounts"
+            static let emailProvider = "Email"
+            static let googleProvider = "Google"
+            static let appleProvider = "Apple"
+            static let signOutButton = "Sign Out"
+            static let deleteAccountButton = "Delete Account"
+            static let cancelButton = "Cancel"
+            static let signOutAlertTitle = "Sign Out"
+            static let signOutAlertMessage = "Are you sure you want to sign out?"
+            static let deleteAccountAlertTitle = "Delete Account"
+            static let deleteAccountAlertMessage = "This action cannot be undone. All your data will be permanently deleted."
+        }
+    }
+}

package/templates/shared/ios/FirebaseProvider/FirebaseAuthService.swift

@@ -0,0 +1,83 @@
+import Foundation
+import FirebaseAuth
+import AuthenticationServices
+
+/// Firebase Authentication service supporting email, Google, and Apple Sign-In.
+class FirebaseAuthService: ObservableObject {
+    static let shared = FirebaseAuthService()
+    
+    @Published var currentUser: FirebaseAuth.User? // CUSTOMIZE: Replace with your User type if different
+    @Published var isAuthenticated: Bool = false
+    @Published var isLoading: Bool = false
+    @Published var errorMessage: String?
+    
+    private var authStateListener: AuthStateDidChangeListenerHandle?
+    
+    private init() {
+        authStateListener = Auth.auth().addStateDidChangeListener { [weak self] _, user in
+            self?.currentUser = user
+            self?.isAuthenticated = user != nil
+        }
+    }
+    
+    deinit {
+        if let listener = authStateListener {
+            Auth.auth().removeStateDidChangeListener(listener)
+        }
+    }
+    
+    // MARK: - Email Auth
+    
+    func signIn(email: String, password: String) async throws {
+        isLoading = true
+        defer { isLoading = false }
+        do {
+            let result = try await Auth.auth().signIn(withEmail: email, password: password)
+            currentUser = result.user
+            errorMessage = nil
+        } catch {
+            errorMessage = error.localizedDescription
+            throw error
+        }
+    }
+    
+    func signUp(email: String, password: String) async throws {
+        isLoading = true
+        defer { isLoading = false }
+        do {
+            let result = try await Auth.auth().createUser(withEmail: email, password: password)
+            currentUser = result.user
+            errorMessage = nil
+        } catch {
+            errorMessage = error.localizedDescription
+            throw error
+        }
+    }
+    
+    func signOut() throws {
+        try Auth.auth().signOut()
+        currentUser = nil
+        isAuthenticated = false
+        errorMessage = nil
+    }
+    
+    func resetPassword(email: String) async throws {
+        try await Auth.auth().sendPasswordReset(withEmail: email)
+    }
+    
+    // MARK: - Google Sign-In
+    
+    func signInWithGoogle() async throws {
+        // CUSTOMIZE: Implement Google Sign-In using GoogleSignIn SDK
+        // See: https://firebase.google.com/docs/auth/ios/google-signin
+        throw NSError(domain: "FirebaseAuthService", code: -1, userInfo: [NSLocalizedDescriptionKey: "Google Sign-In not implemented"])
+    }
+    
+    // MARK: - Apple Sign-In
+    
+    func signInWithApple() async throws {
+        // CUSTOMIZE: Implement Apple Sign-In using AuthenticationServices
+        // See: https://firebase.google.com/docs/auth/ios/apple
+        throw NSError(domain: "FirebaseAuthService", code: -1, userInfo: [NSLocalizedDescriptionKey: "Apple Sign-In not implemented"])
+    }
+}

package/templates/shared/ios/FirebaseProvider/FirebaseConfig.swift

@@ -0,0 +1,36 @@
+import Foundation
+
+/// Firebase project configuration.
+/// Replace placeholder values with your Firebase project credentials.
+struct FirebaseConfig {
+    // CUSTOMIZE: Replace with your Firebase project values
+    // Download GoogleService-Info.plist from Firebase Console and add to project
+    
+    static let projectId = "your-project-id"           // CUSTOMIZE
+    static let storageBucket = "your-project.appspot.com"  // CUSTOMIZE
+    
+    /// Firestore collection names — customize for your domain
+    struct Collections {
+        static let items = "items"           // CUSTOMIZE: e.g., "recipes", "products"
+        static let categories = "categories" // CUSTOMIZE: e.g., "cuisines", "brands"
+        static let users = "users"
+        static let favorites = "favorites"
+    }
+    
+    /// Firestore rules template for this app structure
+    static let firestoreRulesHint = """
+    rules_version = '2';
+    service cloud.firestore {
+      match /databases/{database}/documents {
+        match /items/{itemId} {
+          allow read: if request.auth != null;
+          allow write: if request.auth != null && request.auth.uid == resource.data.userId;
+        }
+        match /categories/{categoryId} {
+          allow read: if true;
+          allow write: if false;
+        }
+      }
+    }
+    """
+}

package/templates/shared/ios/FirebaseProvider/FirebaseDataProvider.swift

@@ -0,0 +1,111 @@
+import Foundation
+import FirebaseFirestore
+import FirebaseAuth
+
+/// DataRepository implementation backed by Firebase Firestore.
+/// Uses Firestore's built-in offline persistence for automatic caching.
+class FirebaseDataProvider: ObservableObject, DataRepository {
+    static let shared = FirebaseDataProvider()
+    
+    @Published var items: [Item] = []
+    @Published var categories: [Category] = []
+    @Published var favoriteItems: [Item] = []
+    
+    private let db = Firestore.firestore()
+    private var listeners: [ListenerRegistration] = []
+    
+    private init() {
+        setupListeners()
+    }
+    
+    deinit {
+        listeners.forEach { $0.remove() }
+    }
+    
+    // MARK: - Real-time Listeners
+    
+    private func setupListeners() {
+        guard let userId = Auth.auth().currentUser?.uid else { return }
+        
+        // Listen for items
+        let itemsListener = db.collection(FirebaseConfig.Collections.items)
+            .whereField("userId", isEqualTo: userId)
+            .order(by: "createdAt", descending: true)
+            .addSnapshotListener { [weak self] snapshot, error in
+                guard let documents = snapshot?.documents else { return }
+                self?.items = documents.compactMap { doc in
+                    var item = try? doc.data(as: Item.self)
+                    item?.metadata["documentId"] = doc.documentID
+                    return item
+                }
+                self?.favoriteItems = self?.items.filter { $0.isFavorite } ?? []
+            }
+        listeners.append(itemsListener)
+        
+        // Listen for categories
+        let categoriesListener = db.collection(FirebaseConfig.Collections.categories)
+            .addSnapshotListener { [weak self] snapshot, error in
+                guard let documents = snapshot?.documents else { return }
+                self?.categories = documents.compactMap { doc in
+                    var category = try? doc.data(as: Category.self)
+                    return category
+                }
+            }
+        listeners.append(categoriesListener)
+    }
+    
+    // MARK: - DataRepository
+    
+    func loadData() {
+        // Remove existing listeners
+        listeners.forEach { $0.remove() }
+        listeners.removeAll()
+        // Setup new listeners
+        setupListeners()
+    }
+    
+    func addItem(_ item: Item) {
+        guard let userId = Auth.auth().currentUser?.uid else { return }
+        var newItem = item
+        newItem.metadata["userId"] = userId
+        do {
+            try db.collection(FirebaseConfig.Collections.items).document(item.id).setData(from: newItem)
+        } catch {
+            print("FirebaseDataProvider: Failed to add item: \(error.localizedDescription)")
+        }
+    }
+    
+    func updateItem(_ item: Item) {
+        do {
+            try db.collection(FirebaseConfig.Collections.items).document(item.id).setData(from: item, merge: true)
+        } catch {
+            print("FirebaseDataProvider: Failed to update item: \(error.localizedDescription)")
+        }
+    }
+    
+    func deleteItem(_ item: Item) {
+        db.collection(FirebaseConfig.Collections.items).document(item.id).delete { error in
+            if let error = error {
+                print("FirebaseDataProvider: Failed to delete item: \(error.localizedDescription)")
+            }
+        }
+    }
+    
+    func toggleFavorite(_ item: Item) {
+        var updated = item
+        updated.isFavorite.toggle()
+        updateItem(updated)
+    }
+    
+    func searchItems(query: String) -> [Item] {
+        guard !query.isEmpty else { return items }
+        return items.filter {
+            $0.title.localizedCaseInsensitiveContains(query) ||
+            $0.subtitle.localizedCaseInsensitiveContains(query)
+        }
+    }
+    
+    func itemsByCategory(_ categoryName: String) -> [Item] {
+        items.filter { $0.category == categoryName }
+    }
+}

package/templates/shared/ios/FirebaseProvider/INTEGRATION.md

@@ -0,0 +1,203 @@
+# FirebaseProvider Module — Integration Guide
+
+## Prerequisites
+
+### iOS
+1. **Add Firebase SDK via Swift Package Manager:**
+   - In Xcode: File → Add Packages...
+   - URL: `https://github.com/firebase/firebase-ios-sdk`
+   - Select: `FirebaseFirestore`, `FirebaseAuth`
+
+2. **Add GoogleService-Info.plist:**
+   - Download from Firebase Console → Project Settings → iOS app
+   - Add to Xcode project (ensure "Copy items if needed" is checked)
+   - Ensure it's added to the app target
+
+3. **Initialize Firebase in App:**
+   ```swift
+   import FirebaseCore
+   
+   @main
+   struct YourApp: App {
+       init() {
+           FirebaseApp.configure()
+       }
+       // ...
+   }
+   ```
+
+### Android
+See `templates/shared/android/FirebaseProvider/INTEGRATION.md` for Android setup.
+
+## AppConfig Additions
+
+Add to `AppConfig.Features`:
+
+```swift
+// CUSTOMIZE:FEATURES
+static let enableFirebase = true
+```
+
+Update `AppConfig.DataSource`:
+
+```swift
+// CUSTOMIZE:DATASOURCE
+struct DataSource {
+    enum SourceType {
+        case localStorage   // Core Data — real local database
+        case mock           // In-memory seed data — for development/testing only
+        case firebase       // Firebase Firestore — cloud database with offline support
+    }
+    static let active: SourceType = .firebase  // CUSTOMIZE
+}
+```
+
+## DataSourceResolver Wiring
+
+Update `DataSourceResolver` to include Firebase:
+
+```swift
+enum DataSourceResolver {
+    static var repository: any DataRepository {
+        switch AppConfig.DataSource.active {
+        case .localStorage:
+            return LocalStorageProvider.shared
+        case .mock:
+            return MockDataProvider.shared
+        case .firebase:
+            return FirebaseDataProvider.shared
+        }
+    }
+}
+```
+
+**Important:** Once DataSourceResolver is configured, app code (including tests) should use `DataSourceResolver.repository` instead of directly accessing `MockDataProvider.shared` or other providers. This ensures code works with any configured data source.
+
+## Navigation Wiring
+
+### Auth Flow
+
+Add authentication gate to Profile tab or as onboarding:
+
+```swift
+import FirebaseAuth
+
+struct ProfileView: View {
+    @StateObject private var authService = FirebaseAuthService.shared
+    
+    var body: some View {
+        if authService.isAuthenticated {
+            // Profile content
+        } else {
+            FirebaseAuthView()
+        }
+    }
+}
+```
+
+### Auth View (Create)
+
+Create `FirebaseAuthView.swift` in your app:
+
+```swift
+import SwiftUI
+
+struct FirebaseAuthView: View {
+    @StateObject private var authService = FirebaseAuthService.shared
+    @State private var email = ""
+    @State private var password = ""
+    @State private var isSignUp = false
+    
+    var body: some View {
+        VStack(spacing: 20) {
+            Text(isSignUp ? Strings.Firebase.signUp : Strings.Firebase.signIn)
+                .font(.largeTitle)
+            
+            TextField(Strings.Firebase.email, text: $email)
+                .textFieldStyle(.roundedBorder)
+                .autocapitalization(.none)
+            
+            SecureField(Strings.Firebase.password, text: $password)
+                .textFieldStyle(.roundedBorder)
+            
+            Button(action: {
+                Task {
+                    if isSignUp {
+                        try? await authService.signUp(email: email, password: password)
+                    } else {
+                        try? await authService.signIn(email: email, password: password)
+                    }
+                }
+            }) {
+                Text(isSignUp ? Strings.Firebase.signUp : Strings.Firebase.signIn)
+                    .frame(maxWidth: .infinity)
+            }
+            .buttonStyle(.borderedProminent)
+            .disabled(authService.isLoading)
+            
+            Button(isSignUp ? Strings.Firebase.signIn : Strings.Firebase.signUp) {
+                isSignUp.toggle()
+            }
+        }
+        .padding()
+    }
+}
+```
+
+## String Merge
+
+Add `Strings.Firebase` enum to the app's `Strings.swift` file. All strings are in the module's `Strings.swift`.
+
+## Test IDs
+
+| Test ID | Element |
+|---------|---------|
+| `firebase_auth_email_field` | Email text field |
+| `firebase_auth_password_field` | Password text field |
+| `firebase_auth_sign_in_button` | Sign in button |
+| `firebase_auth_sign_up_button` | Sign up button |
+| `firebase_auth_sign_out_button` | Sign out button |
+| `firebase_auth_error_message` | Error message label |
+| `firebase_auth_google_button` | Google Sign-In button |
+| `firebase_auth_apple_button` | Apple Sign-In button |
+
+## Module Dependencies
+
+- **ErrorHandling** (optional) — for displaying auth errors
+- **NetworkBanner** (optional) — for connectivity awareness
+
+## Usage Notes
+
+- **Offline Support:** Firestore has built-in offline persistence. No additional caching layer needed.
+- **Real-time Updates:** `FirebaseDataProvider` uses Firestore listeners for automatic real-time synchronization.
+- **User Isolation:** Items are filtered by `userId` field. Ensure `userId` is set when creating items.
+- **Security Rules:** Configure Firestore security rules in Firebase Console. See `FirebaseConfig.firestoreRulesHint` for a template.
+- **Collection Names:** Customize collection names in `FirebaseConfig.Collections` to match your domain (e.g., "recipes" instead of "items").
+- **Not Needed:** Do NOT use `CachedRepository` with Firebase — Firestore already handles offline caching automatically.
+
+## Firestore Data Structure
+
+Items are stored with this structure:
+```json
+{
+  "id": "item-123",
+  "title": "Item Title",
+  "subtitle": "Subtitle",
+  "description": "Description",
+  "category": "Category Name",
+  "isFavorite": false,
+  "createdAt": "2024-01-01T00:00:00Z",
+  "userId": "firebase-user-id",
+  "metadata": {}
+}
+```
+
+Categories are stored as:
+```json
+{
+  "id": "cat-123",
+  "name": "Category Name",
+  "icon": "folder.fill",
+  "itemCount": 5
+}
+```

package/templates/shared/ios/FirebaseProvider/Strings.swift

@@ -0,0 +1,40 @@
+import Foundation
+
+// MARK: - Firebase Strings
+extension Strings {
+    enum Firebase {
+        // Auth
+        static let signIn = "Sign In"
+        static let signUp = "Sign Up"
+        static let signOut = "Sign Out"
+        static let email = "Email"
+        static let password = "Password"
+        static let confirmPassword = "Confirm Password"
+        static let forgotPassword = "Forgot Password?"
+        static let resetPassword = "Reset Password"
+        static let resetPasswordSent = "Password reset email sent"
+        static let signInWithGoogle = "Sign in with Google"
+        static let signInWithApple = "Sign in with Apple"
+        
+        // Errors
+        static let authError = "Authentication Error"
+        static let invalidEmail = "Invalid email address"
+        static let weakPassword = "Password must be at least 6 characters"
+        static let passwordMismatch = "Passwords do not match"
+        static let userNotFound = "No account found with this email"
+        static let wrongPassword = "Incorrect password"
+        static let emailAlreadyInUse = "This email is already registered"
+        static let networkError = "Network error. Please check your connection"
+        
+        // Status
+        static let signingIn = "Signing in..."
+        static let signingUp = "Creating account..."
+        static let authenticated = "Authenticated"
+        static let notAuthenticated = "Not authenticated"
+        
+        // Data
+        static let loadingData = "Loading data..."
+        static let syncError = "Sync error"
+        static let offlineMode = "Offline mode - changes will sync when online"
+    }
+}

package/templates/shared/ios/SecretsConfig/INTEGRATION.md

@@ -0,0 +1,96 @@
+# SecretsConfig Module — Integration Guide (iOS)
+
+## Prerequisites
+
+### 1. Create the secrets file
+
+```bash
+cp Secrets.xcconfig.template Secrets.xcconfig
+```
+
+### 2. Add xcconfig to Xcode build settings
+
+In Xcode, select your project > Info > Configurations. Under both Debug and Release, set the configuration file for your app target to `Secrets.xcconfig`.
+
+Alternatively, if you already have a base `.xcconfig`, add this line:
+```
+#include "Secrets.xcconfig"
+```
+
+### 3. Add variables to Info.plist
+
+For each key you use, add a matching entry to `Info.plist`:
+```xml
+<key>WIX_CLIENT_ID</key>
+<string>$(WIX_CLIENT_ID)</string>
+<key>WIX_SITE_ID</key>
+<string>$(WIX_SITE_ID)</string>
+<key>WIX_REDIRECT_URL</key>
+<string>$(WIX_REDIRECT_URL)</string>
+<key>WIX_API_KEY</key>
+<string>$(WIX_API_KEY)</string>
+<key>SUPABASE_URL</key>
+<string>$(SUPABASE_URL)</string>
+<key>SUPABASE_ANON_KEY</key>
+<string>$(SUPABASE_ANON_KEY)</string>
+```
+
+### 4. Add to .gitignore
+
+```
+Secrets.xcconfig
+```
+
+The `.template` file is safe to commit — it contains only placeholder values.
+
+## AppConfig Additions
+
+No AppConfig changes needed. `SecretsConfig` reads directly from `Info.plist`.
+
+## Navigation Wiring
+
+None — `SecretsConfig` is a utility module with no UI.
+
+## String Merge
+
+None — no user-facing strings.
+
+## Test IDs
+
+None — no UI elements.
+
+## Module Dependencies
+
+- None (uses only Foundation and built-in Bundle APIs)
+
+## Usage Notes
+
+### Reading keys in code
+
+```swift
+// Read a specific key
+let clientId = SecretsConfig.wixClientId
+
+// Check if a service is configured
+if SecretsConfig.isWixMemberConfigured {
+    // Initialize Wix services
+}
+
+if SecretsConfig.isSupabaseConfigured {
+    // Initialize Supabase client
+}
+```
+
+### Adding new keys
+
+1. Add the key to `Secrets.xcconfig.template` with a placeholder value
+2. Add a `static let` property to `SecretsConfig.swift` using `value(for:)`
+3. Add the `$(KEY_NAME)` entry to `Info.plist`
+
+### Security model
+
+| Key Type | Where it goes | Safety |
+|----------|--------------|--------|
+| Client-safe public keys (Supabase anon key, Wix client ID) | Secrets.xcconfig -> Info.plist | Safe in client, protected by RLS/OAuth |
+| SDK config files (GoogleService-Info.plist) | Project directory, gitignored | Standard SDK pattern |
+| Server-side secrets (database passwords) | NEVER in client app | Set up on your backend |