@shaykec/app-agent 1.0.5 → 1.0.7

package/templates/shared/ios/WixMemberBackend/WixEventsService.swift

@@ -0,0 +1,109 @@
+import Foundation
+import Combine
+
+// MARK: - Wix Events Service
+/// Manages Wix Events, tickets, and RSVPs.
+@MainActor
+class WixEventsService: ObservableObject {
+    
+    // MARK: - Published Properties
+    
+    @Published var events: [WixEvent] = []
+    @Published var isLoading: Bool = false
+    
+    // MARK: - Private Properties
+    
+    private let apiClient: WixAPIClient
+    private let authService: WixAuthService
+    
+    // MARK: - Initialization
+    
+    init(apiClient: WixAPIClient, authService: WixAuthService) {
+        self.apiClient = apiClient
+        self.authService = authService
+    }
+    
+    // MARK: - Events
+    
+    func listEvents() async throws {
+        isLoading = true
+        defer { isLoading = false }
+        
+        let response: WixListResponse<WixEvent> = try await apiClient.get(
+            path: "/events/v1/events"
+        )
+        
+        events = response.items ?? []
+    }
+    
+    func getEvent(id: String) async throws -> WixEvent {
+        let response: WixEvent = try await apiClient.get(
+            path: "/events/v1/events/\(id)"
+        )
+        return response
+    }
+    
+    // MARK: - Tickets
+    
+    func getEventTickets(eventId: String) async throws -> [WixEventTicket] {
+        let response: WixListResponse<WixEventTicket> = try await apiClient.get(
+            path: "/events/v1/events/\(eventId)/tickets"
+        )
+        
+        return response.items ?? []
+    }
+    
+    // MARK: - RSVP
+    
+    func rsvpToEvent(
+        eventId: String,
+        contact: WixContactInfo
+    ) async throws -> WixRsvp {
+        return try await authService.requireLogin {
+            struct RSVPRequest: Codable {
+                let eventId: String
+                let contact: WixContactInfo
+                let guestCount: Int?
+            }
+            
+            let request = RSVPRequest(
+                eventId: eventId,
+                contact: contact,
+                guestCount: contact.notes.flatMap { Int($0) }
+            )
+            
+            let response: WixRsvp = try await self.apiClient.post(
+                path: "/events/v1/rsvps",
+                body: request
+            )
+            
+            return response
+        }
+    }
+    
+    // MARK: - Ticket Purchase
+    
+    func buyEventTickets(
+        eventId: String,
+        tickets: [WixTicketItem]
+    ) async throws -> String {
+        return try await authService.requireLogin {
+            struct TicketOrderRequest: Codable {
+                let eventId: String
+                let tickets: [WixTicketItem]
+            }
+            
+            let request = TicketOrderRequest(
+                eventId: eventId,
+                tickets: tickets
+            )
+            
+            let response: WixCheckoutResponse = try await self.apiClient.post(
+                path: "/events/v1/ticket-orders",
+                body: request
+            )
+            
+            return response.checkoutUrl
+        }
+    }
+}

package/templates/shared/ios/WixMemberBackend/WixModels.swift

@@ -0,0 +1,188 @@
+import Foundation
+
+// MARK: - Wix Data Models
+
+struct WixProduct: Codable, Identifiable {
+    let id: String
+    let name: String
+    let description: String?
+    let price: WixPrice?
+    let media: [WixMedia]?
+    let stock: WixStock?
+    let slug: String?
+}
+
+struct WixPrice: Codable {
+    let amount: String?
+    let currency: String?
+    let formatted: String?
+}
+
+struct WixMedia: Codable {
+    let url: String?
+    let width: Int?
+    let height: Int?
+    let altText: String?
+}
+
+struct WixStock: Codable {
+    let inStock: Bool
+    let quantity: Int?
+}
+
+struct WixOrder: Codable, Identifiable {
+    let id: String
+    let number: String?
+    let status: String
+    let createdDate: String?
+    let buyerEmail: String?
+    let total: WixPrice?
+    let lineItems: [WixLineItem]?
+    let fulfillmentStatus: String?
+    let paymentStatus: String?
+}
+
+struct WixLineItem: Codable, Identifiable {
+    let id: String
+    let name: String?
+    let quantity: Int?
+    let price: WixPrice?
+    let productId: String?
+}
+
+struct WixService: Codable, Identifiable {
+    let id: String
+    let name: String
+    let description: String?
+    let price: WixPrice?
+    let duration: Int? // in minutes
+    let category: String?
+}
+
+struct WixBooking: Codable, Identifiable {
+    let id: String
+    let status: String
+    let serviceId: String?
+    let serviceName: String?
+    let startDate: String
+    let endDate: String?
+    let contactName: String?
+    let contactEmail: String?
+    let paymentStatus: String?
+}
+
+struct WixTimeSlot: Codable, Identifiable {
+    var id: String { slotId }
+    let slotId: String
+    let startTime: String
+    let endTime: String
+    let available: Bool
+    let resource: String?
+}
+
+struct WixEvent: Codable, Identifiable {
+    let id: String
+    let title: String
+    let description: String?
+    let location: String?
+    let startDate: String?
+    let endDate: String?
+    let status: String?
+    let registrationStatus: String?
+    let coverImage: WixMedia?
+}
+
+struct WixEventTicket: Codable, Identifiable {
+    let id: String
+    let name: String
+    let price: WixPrice?
+    let available: Int?
+    let limitPerOrder: Int?
+}
+
+struct WixBlogPost: Codable, Identifiable {
+    let id: String
+    let title: String
+    let excerpt: String?
+    let content: String?
+    let coverImage: WixMedia?
+    let publishedDate: String?
+    let slug: String?
+    let categoryIds: [String]?
+    let status: String?
+}
+
+struct WixBlogCategory: Codable, Identifiable {
+    let id: String
+    let name: String
+    let postCount: Int?
+}
+
+struct WixComment: Codable, Identifiable {
+    let id: String
+    let content: String
+    let authorName: String?
+    let createdDate: String?
+}
+
+struct WixRsvp: Codable, Identifiable {
+    let id: String
+    let eventId: String
+    let status: String
+    let contactName: String
+    let contactEmail: String
+    let createdDate: String?
+    let guestCount: Int?
+}
+
+struct WixTicketOrder: Codable, Identifiable {
+    let id: String
+    let eventId: String
+    let orderNumber: String?
+    let status: String
+    let buyerName: String?
+    let tickets: [WixTicketItem]?
+    let total: WixPrice?
+    let createdDate: String?
+}
+
+struct WixTicketItem: Codable, Identifiable {
+    let id: String
+    let ticketName: String?
+    let quantity: Int?
+}
+
+struct WixMember: Codable, Identifiable {
+    let id: String
+    let email: String?
+    let displayName: String?
+    let profilePhoto: String?
+}
+
+// MARK: - API Response Wrappers
+
+struct WixListResponse<T: Codable>: Codable {
+    let items: [T]?
+    let totalCount: Int?
+}
+
+struct WixCheckoutResponse: Codable {
+    let checkoutUrl: String
+}
+
+// MARK: - Contact Info (for bookings/RSVP)
+
+struct WixContactInfo: Codable {
+    let name: String
+    let email: String
+    let phone: String?
+    let notes: String?
+}
+
+// MARK: - Cart Item
+
+struct WixCartItem: Identifiable {
+    let id: String
+    let product: WixProduct
+    var quantity: Int
+}

package/templates/shared/ios/WixMemberBackend/WixStoresService.swift

@@ -0,0 +1,157 @@
+import Foundation
+import Combine
+
+// MARK: - Wix Stores Service
+/// Manages Wix Stores products, cart, and checkout.
+@MainActor
+class WixStoresService: ObservableObject {
+    
+    // MARK: - Published Properties
+    
+    @Published var products: [WixProduct] = []
+    @Published var isLoading: Bool = false
+    @Published var cart: [WixCartItem] = []
+    
+    // MARK: - Private Properties
+    
+    private let apiClient: WixAPIClient
+    private let authService: WixAuthService
+    
+    // MARK: - Initialization
+    
+    init(apiClient: WixAPIClient, authService: WixAuthService) {
+        self.apiClient = apiClient
+        self.authService = authService
+    }
+    
+    // MARK: - Products
+    
+    func listProducts(limit: Int = 50) async throws {
+        isLoading = true
+        defer { isLoading = false }
+        
+        let queryItems = [
+            URLQueryItem(name: "limit", value: String(limit))
+        ]
+        
+        let response: WixListResponse<WixProduct> = try await apiClient.get(
+            path: "/stores/v1/products",
+            queryItems: queryItems
+        )
+        
+        products = response.items ?? []
+    }
+    
+    func getProduct(id: String) async throws -> WixProduct {
+        let response: WixProduct = try await apiClient.get(
+            path: "/stores/v1/products/\(id)"
+        )
+        return response
+    }
+    
+    func searchProducts(query: String) async throws -> [WixProduct] {
+        let queryItems = [
+            URLQueryItem(name: "query", value: query)
+        ]
+        
+        let response: WixListResponse<WixProduct> = try await apiClient.get(
+            path: "/stores/v1/products/search",
+            queryItems: queryItems
+        )
+        
+        return response.items ?? []
+    }
+    
+    // MARK: - Cart
+    
+    func addToCart(product: WixProduct, quantity: Int = 1) {
+        if let index = cart.firstIndex(where: { $0.product.id == product.id }) {
+            cart[index].quantity += quantity
+        } else {
+            let cartItem = WixCartItem(
+                id: UUID().uuidString,
+                product: product,
+                quantity: quantity
+            )
+            cart.append(cartItem)
+        }
+    }
+    
+    func removeFromCart(productId: String) {
+        cart.removeAll { $0.product.id == productId }
+    }
+    
+    func updateCartQuantity(productId: String, quantity: Int) {
+        if let index = cart.firstIndex(where: { $0.product.id == productId }) {
+            if quantity <= 0 {
+                cart.remove(at: index)
+            } else {
+                cart[index].quantity = quantity
+            }
+        }
+    }
+    
+    func clearCart() {
+        cart.removeAll()
+    }
+    
+    // MARK: - Checkout
+    
+    func buyProduct(id: String, quantity: Int = 1) async throws -> String {
+        return try await authService.requireLogin {
+            struct CheckoutRequest: Codable {
+                let lineItems: [LineItem]
+                
+                struct LineItem: Codable {
+                    let productId: String
+                    let quantity: Int
+                }
+            }
+            
+            let request = CheckoutRequest(
+                lineItems: [
+                    CheckoutRequest.LineItem(productId: id, quantity: quantity)
+                ]
+            )
+            
+            let response: WixCheckoutResponse = try await self.apiClient.post(
+                path: "/stores/v1/checkouts",
+                body: request
+            )
+            
+            return response.checkoutUrl
+        }
+    }
+    
+    func buyProducts(items: [WixCartItem]) async throws -> String {
+        return try await authService.requireLogin {
+            struct CheckoutRequest: Codable {
+                let lineItems: [LineItem]
+                
+                struct LineItem: Codable {
+                    let productId: String
+                    let quantity: Int
+                }
+            }
+            
+            let lineItems = items.map { item in
+                CheckoutRequest.LineItem(
+                    productId: item.product.id,
+                    quantity: item.quantity
+                )
+            }
+            
+            let request = CheckoutRequest(lineItems: lineItems)
+            
+            let response: WixCheckoutResponse = try await self.apiClient.post(
+                path: "/stores/v1/checkouts",
+                body: request
+            )
+            
+            // Clear cart after successful checkout
+            self.clearCart()
+            
+            return response.checkoutUrl
+        }
+    }
+}

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

@@ -0,0 +1,220 @@
+# WixOwnerBackend Module — Integration Guide (iOS)
+
+## Prerequisites
+
+### SecretsConfig
+
+This module requires the `SecretsConfig` module. Ensure `Secrets.xcconfig` is configured with:
+
+```ini
+WIX_API_KEY = your-wix-api-key
+WIX_SITE_ID = your-wix-site-id    # Optional if using WixSiteSelector
+```
+
+**Important:** This module uses **API key authentication** (not OAuth). The API key provides site owner/admin access, allowing full CRUD operations on products, orders, bookings, events, and blog posts.
+
+**Note:** `WIX_SITE_ID` is optional when the **WixSiteSelector** module is integrated. If omitted, the app shows a site selector on first launch. If provided, it serves as the default.
+
+### WixSiteSelector (recommended for multi-site)
+
+The `WixSiteSelector` module enables runtime site switching. Pass a shared `WixSiteManager` to `WixAdminAuthService` and the API client. Owner apps automatically fetch their sites from the Wix API.
+
+### No URL Scheme Required
+
+Unlike `WixMemberBackend`, this module does not require OAuth redirect handling. API key authentication happens server-side via headers.
+
+## AppConfig Additions
+
+Add to `AppConfig.Features`:
+```swift
+// CUSTOMIZE:FEATURES
+static let enableWixOwnerStore = true
+static let enableWixOwnerBookings = true
+static let enableWixOwnerEvents = true
+static let enableWixOwnerBlog = true
+```
+
+Add to `AppConfig.API`:
+```swift
+// CUSTOMIZE:API — Wix owner credentials loaded from SecretsConfig
+static let wixApiKey = SecretsConfig.wixApiKey
+static let wixSiteId = SecretsConfig.wixSiteId
+```
+
+## Service Initialization
+
+```swift
+// Option 1: With WixSiteManager (recommended — enables runtime site switching)
+let siteManager = WixSiteManager()  // shared instance
+let authService = WixAdminAuthService(siteManager: siteManager)
+let apiClient = WixAPIClient(siteManager: siteManager, authService: WixAuthService(
+    siteId: siteManager.currentSiteId,
+    clientId: ""
+))
+
+// Option 2: With static site ID (legacy, single-site apps)
+let authService = WixAdminAuthService()
+let apiClient = WixAPIClient(
+    siteId: AppConfig.API.wixSiteId,
+    authService: WixAuthService(
+        siteId: AppConfig.API.wixSiteId,
+        clientId: ""
+    )
+)
+
+// Initialize domain services (same for both options)
+let siteService = WixSiteManagerService(apiClient: apiClient)
+let storeManager = WixStoreManagerService(apiClient: apiClient)
+let bookingManager = WixBookingManagerService(apiClient: apiClient)
+let eventManager = WixEventManagerService(apiClient: apiClient)
+let blogManager = WixBlogManagerService(apiClient: apiClient)
+```
+
+## Navigation Wiring
+
+### Tab-based (recommended)
+
+```swift
+TabView {
+    WixDashboardScreen(apiClient: apiClient)
+        .tabItem { Label("Dashboard", systemImage: "chart.bar") }
+    
+    WixProductManagementScreen(apiClient: apiClient)
+        .tabItem { Label("Products", systemImage: "bag") }
+    
+    WixOrdersScreen(apiClient: apiClient)
+        .tabItem { Label("Orders", systemImage: "cart") }
+    
+    WixBookingManagementScreen(apiClient: apiClient)
+        .tabItem { Label("Bookings", systemImage: "calendar") }
+    
+    WixEventManagementScreen(apiClient: apiClient)
+        .tabItem { Label("Events", systemImage: "ticket") }
+    
+    WixBlogEditorScreen(apiClient: apiClient)
+        .tabItem { Label("Blog", systemImage: "doc.text") }
+}
+```
+
+### Site Selector Flow
+
+If your app supports multiple sites, use `WixSiteSelectorScreen` from the `WixSiteSelector` module:
+
+```swift
+WixSiteSelectorScreen(
+    siteManager: siteManager,
+    mode: .owner,
+    onSiteSelected: { site in
+        // Navigate to dashboard
+    }
+)
+```
+
+Alternatively, use the legacy `WixConnectSiteScreen` (wraps site listing and URL connection):
+
+```swift
+WixConnectSiteScreen(apiClient: apiClient, authService: authService)
+```
+
+## String Merge
+
+Add `Strings.WixOwner` enum to the app's `Strings.swift` file. All strings are defined in the module's `Strings.swift`.
+
+## Test IDs
+
+| Test ID | Element |
+|---------|---------|
+| `wix_owner_connect_url_field` | Site URL input field |
+| `wix_owner_connect_button` | Connect button |
+| `wix_owner_site_*` | Site row (per site ID) |
+| `wix_owner_dashboard_orders` | Orders stat card |
+| `wix_owner_dashboard_bookings` | Bookings stat card |
+| `wix_owner_dashboard_rsvps` | RSVPs stat card |
+| `wix_owner_dashboard_posts` | Posts stat card |
+| `wix_owner_dashboard_products` | Manage Products button |
+| `wix_owner_dashboard_bookings_action` | Manage Bookings button |
+| `wix_owner_dashboard_events` | Manage Events button |
+| `wix_owner_dashboard_blog` | Manage Blog button |
+| `wix_owner_product_*` | Product row (per product ID) |
+| `wix_owner_product_create_fab` | Create product FAB |
+| `wix_owner_product_edit_*` | Edit product button |
+| `wix_owner_product_form_*` | Product form fields |
+| `wix_owner_product_form_save` | Save product button |
+| `wix_owner_order_*` | Order row (per order ID) |
+| `wix_owner_order_fulfill` | Fulfill order button |
+| `wix_owner_order_ship` | Ship order button |
+| `wix_owner_booking_*` | Booking row (per booking ID) |
+| `wix_owner_booking_confirm` | Confirm booking button |
+| `wix_owner_booking_cancel` | Cancel booking button |
+| `wix_owner_booking_decline` | Decline booking button |
+| `wix_owner_event_*` | Event row (per event ID) |
+| `wix_owner_event_create_fab` | Create event FAB |
+| `wix_owner_event_edit_*` | Edit event button |
+| `wix_owner_event_form_*` | Event form fields |
+| `wix_owner_event_form_save` | Save event button |
+| `wix_owner_blog_post_*` | Blog post row (per post ID) |
+| `wix_owner_blog_create_fab` | Create post FAB |
+| `wix_owner_blog_edit_*` | Edit post button |
+| `wix_owner_blog_form_*` | Post form fields |
+| `wix_owner_blog_form_save` | Save post button |
+| `wix_owner_blog_publish` | Publish post button |
+
+## Module Dependencies
+
+- **SecretsConfig** — for API key management
+- **WixSiteSelector** (optional) — for runtime site switching
+- **Foundation** — for URLSession and JSON encoding/decoding
+
+No third-party dependencies required. All HTTP calls use built-in `URLSession`.
+
+## Usage Notes
+
+### API Key Authentication
+
+The module uses API key authentication via HTTP headers:
+- `Authorization: {apiKey}` (not Bearer token)
+- `wix-site-id: {siteId}`
+
+No token refresh is needed — API keys are long-lived credentials.
+
+### Owner vs Member Access
+
+- **WixMemberBackend**: Visitor-first auth, OAuth for transactions, read-only browsing
+- **WixOwnerBackend**: API key auth, full CRUD operations, admin/owner access
+
+These modules can coexist in the same app if you need both member-facing and admin features.
+
+### Error Handling
+
+All services throw `WixAPIError` on failure. Handle errors in your UI:
+
+```swift
+do {
+    try await storeManager.createProduct(input: input)
+} catch let error as WixAPIError {
+    // Show error.localizedDescription
+} catch {
+    // Handle other errors
+}
+```
+
+### Customization Points
+
+1. **Enable/disable domains**: Toggle `AppConfig.Features.enableWixOwnerStore/Bookings/Events/Blog`
+2. **Styling**: All screens use `AppConfig.Theme.*` tokens — update the theme to match your brand
+3. **Navigation**: Screens can be used in tabs, navigation stack, or modal sheets
+4. **Strings**: Override any string in `Strings.WixOwner` for custom copy
+
+## API Endpoints Used
+
+- `/sites/v1/sites` — Site management
+- `/stores/v1/products` — Product CRUD
+- `/stores/v1/orders` — Order management
+- `/bookings/v1/services` — Service CRUD
+- `/bookings/v1/bookings` — Booking management
+- `/events/v1/events` — Event CRUD
+- `/events/v1/rsvps` — RSVP listing
+- `/events/v1/ticket-orders` — Ticket order listing
+- `/blog/v1/posts` — Post CRUD
+
+All endpoints require API key authentication and site ID header.