Shortcuts Storage, Notification Automation & Use Model Improvements

import AppIntents

// MARK: - Stable, cross-device entity identifier backed by a server DB row ID

struct SoupEntity: AppEntity {
    static var typeDisplayRepresentation: TypeDisplayRepresentation = "Soup"
    static var defaultQuery = SoupQuery()

    /// Use the server-side database row ID so the same soup is recognised
    /// on every device — never use a locally-generated UUID here.
    var id: Int  // e.g. 42

    @Property(title: "Name")
    var name: String

    @Property(title: "Available Today")
    var availableToday: Bool

    /// Added so Use Model can reason about spice level.
    /// Format: "jalapeño – 15 g per serving"
    @Property(title: "Ingredients")
    var ingredients: [String]

    var displayRepresentation: DisplayRepresentation {
        DisplayRepresentation(title: "\(name)",
                              subtitle: availableToday ? "Available" : "Unavailable")
    }
}

// MARK: - Query used by Find Soups action and Shortcuts Storage resolution

struct SoupQuery: EntityQuery {
    func entities(for identifiers: [Int]) async throws -> [SoupEntity] {
        // Fetch soups from the shared online database by stable row ID
        return try await SoupDatabase.shared.fetchSoups(ids: identifiers)
    }

    func suggestedEntities() async throws -> [SoupEntity] {
        return try await SoupDatabase.shared.fetchAllSoups()
    }
}

// MARK: - Find Soups action exposed to Shortcuts

struct FindSoupsIntent: AppIntent {
    static var title: LocalizedStringResource = "Find Soups"
    static var description = IntentDescription("Returns soups available from Soup Chef.")

    @Parameter(title: "Only Today's Soups", default: true)
    var onlyToday: Bool

    func perform() async throws -> some ReturnsValue<[SoupEntity]> {
        let soups = try await SoupDatabase.shared.fetchAllSoups()
        let filtered = onlyToday ? soups.filter(\.availableToday) : soups
        return .result(value: filtered)
    }
}

// MARK: - Order Soup action

struct OrderSoupIntent: AppIntent {
    static var title: LocalizedStringResource = "Order Soup"

    @Parameter(title: "Soup")
    var soup: SoupEntity

    func perform() async throws -> some ProvidesDialog {
        try await SoupDatabase.shared.placeOrder(soupId: soup.id)
        return .result(dialog: "Order placed for \(soup.name)!")
    }
}

// MARK: - Minimal stand-in for the database layer

final class SoupDatabase {
    static let shared = SoupDatabase()
    func fetchAllSoups() async throws -> [SoupEntity] { [] }
    func fetchSoups(ids: [Int]) async throws -> [SoupEntity] { [] }
    func placeOrder(soupId: Int) async throws {}
}