1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
|
import AppIntents
import Foundation
/// App Intent that runs a point-in-time domain inspection through the same
/// headless pipeline used by the CLI (`DomainInspectionService` ->
/// `DomainReportBuilder`) and returns a concise summary. Usable from
/// Shortcuts, Spotlight, the Action button, and Siri.
struct InspectDomainIntent: AppIntent {
static let title: LocalizedStringResource = "Inspect Domain"
static let description = IntentDescription(
"Run a DomainDig inspection and return a summary of availability, risk, TLS, email security, and certificate health."
)
// Read-only inspection; no need to foreground the app.
static let openAppWhenRun = false
@Parameter(
title: "Domain",
description: "The domain to inspect, e.g. example.com",
inputOptions: String.IntentInputOptions(
keyboardType: .URL,
capitalizationType: .none
)
)
var domain: String
static var parameterSummary: some ParameterSummary {
Summary("Inspect \(\.$domain)")
}
@MainActor
func perform() async throws -> some IntentResult & ReturnsValue<String> & ProvidesDialog {
let requested = domain.trimmingCharacters(in: .whitespacesAndNewlines)
guard !requested.isEmpty else {
throw InspectDomainError.emptyDomain
}
let snapshot = await DomainInspectionService().inspectSnapshot(domain: requested)
let report = DomainReportBuilder().build(from: snapshot)
let summary = Self.summaryText(for: report)
let dialog = IntentDialog(stringLiteral: Self.spokenSummary(for: report))
return .result(value: summary, dialog: dialog)
}
/// Multi-line summary suitable for a returned Shortcuts text value.
@MainActor
static func summaryText(for report: DomainReport) -> String {
let dnssec: String
switch report.dns.dnssecSigned {
case true?: dnssec = "Yes"
case false?: dnssec = "No"
case nil: dnssec = "Unknown"
}
var lines = [
"\(report.domain) — \(report.availability.rawValue.capitalized)",
"Risk: \(report.riskAssessment.level.title) (score \(report.riskAssessment.score))",
"Health: \(report.health.title)",
"TLS: \(report.web.tlsGrade.rawValue) · Email: \(report.email.grade?.rawValue ?? "—") · Cert: \(report.certificateExpiryState.title)",
"IP: \(report.dns.primaryIP ?? "unknown") · DNSSEC: \(dnssec)"
]
if let insight = report.insights.first {
lines.append(insight)
}
return lines.joined(separator: "\n")
}
/// Short spoken/dialog line for Siri and the Shortcuts result banner.
@MainActor
static func spokenSummary(for report: DomainReport) -> String {
"\(report.domain) is \(report.availability.rawValue). Risk \(report.riskAssessment.level.title.lowercased()), health \(report.health.title.lowercased())."
}
}
enum InspectDomainError: Error, CustomLocalizedStringResourceConvertible {
case emptyDomain
var localizedStringResource: LocalizedStringResource {
switch self {
case .emptyDomain:
return "Enter a domain to inspect."
}
}
}
/// App Intent that opens DomainDig and adds a domain to the watchlist. It opens
/// the app via the `domaindig://watch` deep link so tracking goes through the
/// existing view-model path (premium limits, monitoring, history linking,
/// cloud-sync recording, and the paywall when over the free limit).
struct AddToWatchlistIntent: AppIntent {
static let title: LocalizedStringResource = "Add Domain to Watchlist"
static let description = IntentDescription(
"Open DomainDig and add a domain to your watchlist."
)
static let openAppWhenRun = true
@Parameter(
title: "Domain",
description: "The domain to add, e.g. example.com",
inputOptions: String.IntentInputOptions(
keyboardType: .URL,
capitalizationType: .none
)
)
var domain: String
static var parameterSummary: some ParameterSummary {
Summary("Add \(\.$domain) to the watchlist")
}
@MainActor
func perform() async throws -> some IntentResult {
let requested = domain.trimmingCharacters(in: .whitespacesAndNewlines)
guard !requested.isEmpty else {
throw InspectDomainError.emptyDomain
}
// `openAppWhenRun` runs this in the app process, so the router hands the
// action off to the running UI, which tracks through the existing path.
DomainDigIntentRouter.shared.pendingAction = .watch(requested)
return .result()
}
}
/// App Intent that opens DomainDig and re-inspects every tracked domain. It runs
/// through the existing view-model batch path (`refreshAllTrackedDomains`), which
/// enforces the batch feature gate and surfaces the paywall when needed.
struct RunSweepIntent: AppIntent {
static let title: LocalizedStringResource = "Run Watchlist Sweep"
static let description = IntentDescription(
"Open DomainDig and re-inspect every domain on your watchlist."
)
static let openAppWhenRun = true
@MainActor
func perform() async throws -> some IntentResult {
DomainDigIntentRouter.shared.pendingAction = .sweep
return .result()
}
}
/// In-process hand-off from an `openAppWhenRun` intent to the running SwiftUI
/// layer. `RootTabView` observes `pendingAction` and performs it.
@MainActor
@Observable
final class DomainDigIntentRouter {
static let shared = DomainDigIntentRouter()
var pendingAction: DomainDigDeepLink.Action?
private init() { /* Singleton; use the shared instance. */ }
}
/// Exposes DomainDig intents to Spotlight and Siri with invocation phrases.
struct DomainDigShortcuts: AppShortcutsProvider {
static var appShortcuts: [AppShortcut] {
AppShortcut(
intent: InspectDomainIntent(),
phrases: [
"Inspect a domain with \(.applicationName)",
"Dig a domain with \(.applicationName)"
],
shortTitle: "Inspect Domain",
systemImageName: "magnifyingglass"
)
AppShortcut(
intent: AddToWatchlistIntent(),
phrases: [
"Add a domain to \(.applicationName)",
"Watch a domain with \(.applicationName)"
],
shortTitle: "Add to Watchlist",
systemImageName: "plus.circle"
)
AppShortcut(
intent: RunSweepIntent(),
phrases: [
"Run a sweep with \(.applicationName)",
"Sweep my \(.applicationName) watchlist"
],
shortTitle: "Run Sweep",
systemImageName: "arrow.trianglehead.2.clockwise"
)
}
}
|
