react-native-live-widgets 1.2.0 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (87) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +129 -50
  3. package/android/src/main/AndroidManifest.xml +12 -0
  4. package/android/src/main/assets/fonts/MaterialIcons-Regular.ttf +0 -0
  5. package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityModule.kt +61 -1
  6. package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityNotifier.kt +153 -17
  7. package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityReceiver.kt +1 -1
  8. package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicWidgetCanvasRenderer.kt +529 -59
  9. package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetImageCache.kt +53 -0
  10. package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +684 -83
  11. package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +129 -57
  12. package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicQuickSettingsTileService.kt +120 -0
  13. package/android/src/main/res/layout/rn_live_widget_hit_zone.xml +16 -0
  14. package/android/src/main/res/layout/rn_live_widget_host.xml +16 -87
  15. package/app.plugin.js +36 -0
  16. package/assets/MaterialIcons.json +2236 -0
  17. package/cli/codegen.js +789 -0
  18. package/cli/setup.js +323 -63
  19. package/docs/EXPO-GUIDE-EN.md +21 -3
  20. package/docs/EXPO-GUIDE-VI.md +21 -3
  21. package/docs/GUIDE-EN.md +444 -21
  22. package/docs/GUIDE-VI.md +473 -22
  23. package/docs/index.html +2263 -265
  24. package/docs/llms-full.txt +41 -0
  25. package/docs/llms.txt +24 -7
  26. package/ios/Bridge/LiveActivityModule.swift +333 -44
  27. package/ios/Intents/DynamicWidgetActionIntent.swift +57 -2
  28. package/ios/Models/DynamicLayoutModels.swift +120 -5
  29. package/ios/Renderer/DynamicNodeView.swift +184 -20
  30. package/ios/Storage/DynamicWidgetStateStore.swift +649 -38
  31. package/ios/Widgets/DynamicControlWidget.swift +63 -0
  32. package/ios/Widgets/DynamicHomeScreenWidget.swift +104 -26
  33. package/ios/Widgets/DynamicLiveActivityWidget.swift +25 -4
  34. package/lib/builder.d.ts +50 -7
  35. package/lib/builder.d.ts.map +1 -1
  36. package/lib/builder.js +391 -29
  37. package/lib/builder.js.map +1 -1
  38. package/lib/dispatcher.js +16 -10
  39. package/lib/dispatcher.js.map +1 -1
  40. package/lib/hooks.d.ts +13 -9
  41. package/lib/hooks.d.ts.map +1 -1
  42. package/lib/hooks.js +105 -42
  43. package/lib/hooks.js.map +1 -1
  44. package/lib/index.d.ts +96 -8
  45. package/lib/index.d.ts.map +1 -1
  46. package/lib/index.js +415 -97
  47. package/lib/index.js.map +1 -1
  48. package/lib/ir.d.ts +15 -0
  49. package/lib/ir.d.ts.map +1 -0
  50. package/lib/ir.js +386 -0
  51. package/lib/ir.js.map +1 -0
  52. package/lib/jsx.d.ts +19 -7
  53. package/lib/jsx.d.ts.map +1 -1
  54. package/lib/jsx.js +179 -95
  55. package/lib/jsx.js.map +1 -1
  56. package/lib/material-icons.generated.d.ts +8 -0
  57. package/lib/material-icons.generated.d.ts.map +1 -0
  58. package/lib/material-icons.generated.js +9 -0
  59. package/lib/material-icons.generated.js.map +1 -0
  60. package/lib/preview.d.ts +11 -27
  61. package/lib/preview.d.ts.map +1 -1
  62. package/lib/preview.js +456 -119
  63. package/lib/preview.js.map +1 -1
  64. package/lib/sf-symbols.generated.d.ts +8 -0
  65. package/lib/sf-symbols.generated.d.ts.map +1 -0
  66. package/lib/sf-symbols.generated.js +9 -0
  67. package/lib/sf-symbols.generated.js.map +1 -0
  68. package/lib/types.d.ts +506 -30
  69. package/lib/types.d.ts.map +1 -1
  70. package/lib/types.js +2 -1
  71. package/lib/types.js.map +1 -1
  72. package/package.json +7 -2
  73. package/scripts/build.js +98 -0
  74. package/scripts/generate-material-icons.js +93 -0
  75. package/scripts/generate-sf-symbols.js +95 -0
  76. package/scripts/release.js +115 -0
  77. package/scripts/test-ir-semantic.js +314 -0
  78. package/src/builder.ts +439 -26
  79. package/src/hooks.ts +88 -12
  80. package/src/index.ts +385 -57
  81. package/src/ir.ts +436 -0
  82. package/src/jsx.tsx +99 -21
  83. package/src/material-icons.generated.ts +3844 -0
  84. package/src/preview.tsx +533 -55
  85. package/src/react-native-env.d.ts +1 -0
  86. package/src/sf-symbols.generated.ts +9533 -0
  87. package/src/types.ts +601 -31
@@ -1,6 +1,6 @@
1
1
  import Foundation
2
2
 
3
- // MARK: - Interactive Widget State Store & Background Remote Sync
3
+ // MARK: - Interactive Widget State Store & Background Data Engine 2.0
4
4
 
5
5
  public enum DynamicWidgetStateStore {
6
6
  private static let stateKey = "interactive_state"
@@ -56,10 +56,67 @@ public enum DynamicWidgetStateStore {
56
56
  }
57
57
  }
58
58
 
59
- public static func handleAction(_ actionId: String) {
59
+ private static let counterStorageKey = "widget_counter_value"
60
+
61
+ public static func isCounterAction(_ actionId: String) -> Bool {
62
+ return actionId == "action_counter_inc"
63
+ || actionId.hasPrefix("counter:inc")
64
+ || actionId == "action_counter_dec"
65
+ || actionId.hasPrefix("counter:dec")
66
+ || actionId == "action_counter_reset"
67
+ || actionId.hasPrefix("counter:reset")
68
+ }
69
+
70
+ public static func readCounterValue(appGroup: String = "", state: InteractiveWidgetState? = nil) -> Int? {
71
+ if let stored = DynamicWidgetProvider.readSharedString(forKey: counterStorageKey, appGroup: appGroup),
72
+ let parsed = Int(stored.trimmingCharacters(in: .whitespacesAndNewlines)) {
73
+ return parsed
74
+ }
75
+ let resolvedState = state ?? loadState()
76
+ if let remoteStr = resolvedState.remoteVariables?["counter"],
77
+ let parsed = Int(remoteStr.trimmingCharacters(in: .whitespacesAndNewlines)) {
78
+ return parsed
79
+ }
80
+ return nil
81
+ }
82
+
83
+ private static func updateCounterValue(delta: Int?, resetTo: Int? = nil, in state: inout InteractiveWidgetState) {
84
+ let current = readCounterValue(state: state) ?? 10
85
+ let nextValue = resetTo ?? (current + (delta ?? 0))
86
+ let nextStr = "\(nextValue)"
87
+ DynamicWidgetProvider.writeSharedString(nextStr, forKey: counterStorageKey, appGroup: "")
88
+ var vars = state.remoteVariables ?? [:]
89
+ vars["counter"] = nextStr
90
+ state.remoteVariables = vars
91
+ }
92
+
93
+ public static func applyCounterReplacement(in json: String, counterValue: String) -> String {
94
+ let escaped = NSRegularExpression.escapedTemplate(for: counterValue)
95
+ let rules: [(String, String)] = [
96
+ (##"("text"\s*:\s*)"-?\d+"(\s*,\s*(?:"style"\s*:\s*\{\s*)?"fontSize"\s*:\s*(?:26|32)\b)"##, "$1\"\(escaped)\"$2"),
97
+ (##"("text"\s*:\s*)"-?\d+"(\s*,\s*(?:"style"\s*:\s*\{\s*)?"color"\s*:\s*"#10B981"\s*,\s*"fontSize"\s*:\s*(?:11|12)\b)"##, "$1\"\(escaped)\"$2"),
98
+ (##"-?\d+(\s+lượt)"##, "\(escaped)$1"),
99
+ (##"Count:\s*-?\d+"##, "Count: \(escaped)"),
100
+ (##"Số đếm hiện tại:\s*-?\d+"##, "Số đếm hiện tại: \(escaped)"),
101
+ ]
102
+
103
+ var working = json
104
+ for (pattern, template) in rules {
105
+ if let regex = try? NSRegularExpression(pattern: pattern) {
106
+ let range = NSRange(location: 0, length: (working as NSString).length)
107
+ working = regex.stringByReplacingMatches(in: working, range: range, withTemplate: template)
108
+ }
109
+ }
110
+ return working
111
+ }
112
+
113
+ @discardableResult
114
+ public static func handleAction(_ actionId: String) -> InteractiveWidgetState {
60
115
  var state = loadState()
116
+ let now = Date().timeIntervalSince1970
61
117
  state.lastActionId = actionId
62
- state.updatedAt = Date().timeIntervalSince1970
118
+ state.actionUpdatedAt = now
119
+ state.updatedAt = now
63
120
 
64
121
  if actionId.hasPrefix("page:") {
65
122
  let target = String(actionId.dropFirst(5))
@@ -85,17 +142,444 @@ public enum DynamicWidgetStateStore {
85
142
  let key = String(actionId.dropFirst(7))
86
143
  let current = state.toggledItems[key] ?? false
87
144
  state.toggledItems[key] = !current
145
+ } else if actionId == "action_counter_inc" || actionId.hasPrefix("counter:inc") {
146
+ updateCounterValue(delta: 1, in: &state)
147
+ } else if actionId == "action_counter_dec" || actionId.hasPrefix("counter:dec") {
148
+ updateCounterValue(delta: -1, in: &state)
149
+ } else if actionId == "action_counter_reset" || actionId.hasPrefix("counter:reset") {
150
+ updateCounterValue(delta: nil, resetTo: 0, in: &state)
151
+ } else {
152
+ let formatter = DateFormatter()
153
+ formatter.dateFormat = "HH:mm:ss"
154
+ let timeStr = formatter.string(from: Date())
155
+ let jsxLabels: [String: String] = [
156
+ "action_jsx_checkin": "Đã điểm danh • \(timeStr)",
157
+ "action_jsx_checkout": "Đã Check-out • \(timeStr)",
158
+ "action_jsx_refresh": "Đồng bộ lúc \(timeStr)",
159
+ "action_jsx_leave": "Đã xin nghỉ phép • \(timeStr)",
160
+ "action_jsx_report": "Đã gửi báo cáo • \(timeStr)",
161
+ ]
162
+ if actionId == "action_demo_checkin" {
163
+ var vars = state.remoteVariables ?? [:]
164
+ vars["demo_ts_label"] = "✓ Đã chạy TS (\(timeStr))"
165
+ state.remoteVariables = vars
166
+ } else if let label = jsxLabels[actionId] {
167
+ var vars = state.remoteVariables ?? [:]
168
+ vars["jsx_status"] = label
169
+ state.remoteVariables = vars
170
+ }
88
171
  }
89
172
 
90
173
  saveState(state)
174
+ return state
91
175
  }
92
176
 
93
177
  public static func isToggled(_ key: String) -> Bool {
94
178
  return loadState().toggledItems[key] ?? false
95
179
  }
96
180
 
181
+ public static func setToggle(_ key: String, value: Bool) {
182
+ var state = loadState()
183
+ state.lastActionId = "toggle:\(key)"
184
+ state.updatedAt = Date().timeIntervalSince1970
185
+ state.toggledItems[key] = value
186
+ saveState(state)
187
+ }
188
+
189
+ // MARK: - JSON Flattener, Schema Validator & Pipe Template Evaluator
190
+
191
+ public static func flattenJsonObject(_ value: Any, prefix: String = "", into out: inout [String: String]) {
192
+ if let dict = value as? [String: Any] {
193
+ for (k, v) in dict {
194
+ let nextKey = prefix.isEmpty ? k : "\(prefix).\(k)"
195
+ flattenJsonObject(v, prefix: nextKey, into: &out)
196
+ }
197
+ } else if let arr = value as? [Any] {
198
+ for (idx, item) in arr.enumerated() {
199
+ let nextKey = prefix.isEmpty ? "\(idx)" : "\(prefix).\(idx)"
200
+ flattenJsonObject(item, prefix: nextKey, into: &out)
201
+ }
202
+ } else if !prefix.isEmpty {
203
+ if let s = value as? String {
204
+ out[prefix] = s
205
+ } else if let num = value as? NSNumber {
206
+ if CFGetTypeID(num) == CFBooleanGetTypeID() {
207
+ out[prefix] = num.boolValue ? "true" : "false"
208
+ } else {
209
+ out[prefix] = num.stringValue
210
+ }
211
+ }
212
+ }
213
+ }
214
+
215
+ private static func validateSchema(
216
+ flatVars: inout [String: String],
217
+ schema: WidgetDataSchemaDTO?
218
+ ) -> (ok: Bool, error: String?) {
219
+ guard let schema = schema else { return (true, nil) }
220
+
221
+ if let defaults = schema.defaults {
222
+ for (k, codable) in defaults {
223
+ let existing = flatVars[k]
224
+ if existing == nil || existing?.isEmpty == true {
225
+ if let s = codable.stringValue {
226
+ flatVars[k] = s
227
+ } else if let b = codable.boolValue {
228
+ flatVars[k] = b ? "true" : "false"
229
+ } else if let d = codable.doubleValue {
230
+ flatVars[k] = formatNumber(d)
231
+ }
232
+ }
233
+ }
234
+ }
235
+
236
+ if let required = schema.requiredKeys {
237
+ for reqKey in required {
238
+ if let val = flatVars[reqKey], !val.isEmpty {
239
+ continue
240
+ }
241
+ return (false, "Missing required key '\(reqKey)'")
242
+ }
243
+ }
244
+
245
+ if let types = schema.types {
246
+ for (key, expectedType) in types {
247
+ guard let val = flatVars[key] else { continue }
248
+ switch expectedType {
249
+ case "number":
250
+ if Double(val.trimmingCharacters(in: .whitespaces)) == nil {
251
+ return (false, "Key '\(key)' expected number")
252
+ }
253
+ case "boolean":
254
+ let lower = val.trimmingCharacters(in: .whitespaces).lowercased()
255
+ if lower != "true" && lower != "false" && lower != "1" && lower != "0" {
256
+ return (false, "Key '\(key)' expected boolean")
257
+ }
258
+ default:
259
+ break
260
+ }
261
+ }
262
+ }
263
+
264
+ return (true, nil)
265
+ }
266
+
267
+ private static func formatNumber(_ value: Double) -> String {
268
+ if value.isFinite && value.rounded() == value && abs(value) <= Double(Int64.max) {
269
+ return "\(Int64(value))"
270
+ }
271
+ return "\(value)"
272
+ }
273
+
274
+ private static func sanitizeVariableValue(_ raw: String?) -> String? {
275
+ guard let raw = raw else { return nil }
276
+ let trimmed = raw.trimmingCharacters(in: .whitespaces)
277
+ if trimmed.hasPrefix("{{"), trimmed.hasSuffix("}}") {
278
+ let inner = String(trimmed.dropFirst(2).dropLast(2))
279
+ if !inner.contains("{"), !inner.contains("}"), !inner.contains("|") {
280
+ return inner.trimmingCharacters(in: .whitespaces)
281
+ }
282
+ }
283
+ return raw
284
+ }
285
+
286
+ public static func evaluateTemplatePipe(_ rawValue: String?, pipes: [String]) -> String {
287
+ var current = sanitizeVariableValue(rawValue) ?? ""
288
+
289
+ for rawPipe in pipes {
290
+ let colonIdx = rawPipe.firstIndex(of: ":")
291
+ let op: String
292
+ let arg: String
293
+ if let idx = colonIdx {
294
+ op = String(rawPipe[..<idx]).trimmingCharacters(in: .whitespaces)
295
+ arg = String(rawPipe[rawPipe.index(after: idx)...])
296
+ } else {
297
+ op = rawPipe.trimmingCharacters(in: .whitespaces)
298
+ arg = ""
299
+ }
300
+
301
+ switch op {
302
+ case "default":
303
+ if current.isEmpty {
304
+ current = arg
305
+ }
306
+ case "divide":
307
+ if let num = Double(current.trimmingCharacters(in: .whitespaces)), let div = Double(arg), div != 0 {
308
+ current = formatNumber(num / div)
309
+ }
310
+ case "multiply":
311
+ if let num = Double(current.trimmingCharacters(in: .whitespaces)), let mul = Double(arg) {
312
+ current = formatNumber(num * mul)
313
+ }
314
+ case "add":
315
+ if let num = Double(current.trimmingCharacters(in: .whitespaces)), let offset = Double(arg) {
316
+ current = formatNumber(num + offset)
317
+ }
318
+ case "round":
319
+ if let num = Double(current.trimmingCharacters(in: .whitespaces)) {
320
+ let decimals = max(0, Int(arg) ?? 0)
321
+ current = decimals == 0 ? "\(Int64(num.rounded()))" : String(format: "%.\(decimals)f", num)
322
+ }
323
+ case "upper":
324
+ current = current.uppercased()
325
+ case "lower":
326
+ current = current.lowercased()
327
+ case "currency":
328
+ if let num = Double(current.trimmingCharacters(in: .whitespaces)) {
329
+ let symbol = arg.isEmpty ? "₫" : arg
330
+ let formatter = NumberFormatter()
331
+ formatter.numberStyle = .decimal
332
+ formatter.usesGroupingSeparator = true
333
+ formatter.locale = Locale(identifier: "en_US")
334
+ let formatted = formatter.string(from: NSNumber(value: Int64(num.rounded()))) ?? "\(Int64(num.rounded()))"
335
+ current = "\(formatted)\(symbol)"
336
+ }
337
+ case "percent":
338
+ if let num = Double(current.trimmingCharacters(in: .whitespaces)) {
339
+ let decimals = max(0, Int(arg) ?? 0)
340
+ let numStr = decimals == 0 ? "\(Int64(num.rounded()))" : String(format: "%.\(decimals)f", num)
341
+ current = "\(numStr)%"
342
+ }
343
+ case "if":
344
+ let parts = arg.split(separator: ":", maxSplits: 1, omittingEmptySubsequences: false)
345
+ let thenVal = parts.first.map(String.init) ?? arg
346
+ let elseVal = parts.count > 1 ? String(parts[1]) : ""
347
+ let trimmed = current.trimmingCharacters(in: .whitespaces).lowercased()
348
+ let isTruthy = !trimmed.isEmpty && trimmed != "false" && trimmed != "0" && trimmed != "null"
349
+ current = isTruthy ? thenVal : elseVal
350
+ default:
351
+ break
352
+ }
353
+ }
354
+
355
+ return current
356
+ }
357
+
358
+ public static func resolveTemplateString(
359
+ _ input: String,
360
+ with vars: [String: String],
361
+ escapeForJson: Bool = false
362
+ ) -> String {
363
+ guard input.contains("{{"),
364
+ let regex = try? NSRegularExpression(pattern: "\\{\\{([^}]+)\\}\\}") else {
365
+ return input
366
+ }
367
+
368
+ let nsInput = input as NSString
369
+ let matches = regex.matches(in: input, range: NSRange(location: 0, length: nsInput.length))
370
+ if matches.isEmpty { return input }
371
+
372
+ var result = input
373
+ for match in matches.reversed() {
374
+ guard match.numberOfRanges > 1,
375
+ let fullRange = Range(match.range, in: result),
376
+ let exprRange = Range(match.range(at: 1), in: result) else {
377
+ continue
378
+ }
379
+ let expr = String(result[exprRange])
380
+ let parts = expr.split(separator: "|", omittingEmptySubsequences: false).map(String.init)
381
+ let pathKey = parts[0].trimmingCharacters(in: .whitespaces)
382
+ let pipes = Array(parts.dropFirst())
383
+ let rawVal = vars[pathKey]
384
+ let hasFallbackPipe = pipes.contains { p in
385
+ let trimmed = p.trimmingCharacters(in: .whitespaces)
386
+ return trimmed.hasPrefix("default:") || trimmed.hasPrefix("if:")
387
+ }
388
+ if rawVal == nil && !hasFallbackPipe {
389
+ continue
390
+ }
391
+ var evaluated = evaluateTemplatePipe(rawVal, pipes: pipes)
392
+ if escapeForJson {
393
+ evaluated = evaluated
394
+ .replacingOccurrences(of: "\\", with: "\\\\")
395
+ .replacingOccurrences(of: "\"", with: "\\\"")
396
+ .replacingOccurrences(of: "\n", with: "\\n")
397
+ .replacingOccurrences(of: "\r", with: "\\r")
398
+ .replacingOccurrences(of: "\t", with: "\\t")
399
+ }
400
+ result.replaceSubrange(fullRange, with: evaluated)
401
+ }
402
+
403
+ return result
404
+ }
405
+
406
+ // MARK: - Background Data Engine 2.0 (REST, TTL, ETag/304, Retry/Backoff, Multi-Source, Auth Refresh)
407
+
408
+ private enum SourceFetchResult {
409
+ case updated(data: Data, etag: String?, lastModified: String?, statusCode: Int)
410
+ case notModified(statusCode: Int)
411
+ case failed(error: String, statusCode: Int?)
412
+ }
413
+
414
+ private static func buildRequestBody(_ body: AnyCodable?) -> (data: Data?, contentType: String?) {
415
+ guard let body = body else { return (nil, nil) }
416
+ if let str = body.stringValue {
417
+ return (str.data(using: .utf8), "application/json")
418
+ }
419
+ if let data = try? JSONEncoder().encode(body) {
420
+ return (data, "application/json")
421
+ }
422
+ return (nil, nil)
423
+ }
424
+
425
+ private static func performAuthRefresh(
426
+ auth: WidgetAuthRefreshConfigDTO,
427
+ timeoutSeconds: TimeInterval
428
+ ) async -> String? {
429
+ guard let url = URL(string: auth.url) else { return nil }
430
+ var req = URLRequest(url: url)
431
+ req.httpMethod = auth.method ?? "POST"
432
+ req.timeoutInterval = timeoutSeconds
433
+ if let headers = auth.headers {
434
+ for (k, v) in headers {
435
+ req.setValue(v, forHTTPHeaderField: k)
436
+ }
437
+ }
438
+ let (bodyData, contentType) = buildRequestBody(auth.body)
439
+ if let bodyData = bodyData {
440
+ req.httpBody = bodyData
441
+ if let ct = contentType, req.value(forHTTPHeaderField: "Content-Type") == nil {
442
+ req.setValue(ct, forHTTPHeaderField: "Content-Type")
443
+ }
444
+ }
445
+
446
+ do {
447
+ let (data, response) = try await URLSession.shared.data(for: req)
448
+ guard let http = response as? HTTPURLResponse, (200...299).contains(http.statusCode),
449
+ let jsonObj = try? JSONSerialization.jsonObject(with: data) else {
450
+ return nil
451
+ }
452
+ var flat: [String: String] = [:]
453
+ flattenJsonObject(jsonObj, into: &flat)
454
+ let tokenPath = auth.tokenPath ?? "accessToken"
455
+ return flat[tokenPath] ?? flat["token"] ?? flat["access_token"]
456
+ } catch {
457
+ return nil
458
+ }
459
+ }
460
+
461
+ private static func fetchWithRetryAndAuth(
462
+ cacheKey: String,
463
+ urlString: String,
464
+ method: String?,
465
+ headers: [String: String]?,
466
+ body: AnyCodable?,
467
+ timeoutMs: Int,
468
+ enableETag: Bool,
469
+ maxRetries: Int,
470
+ retryDelayMs: Int,
471
+ authRefresh: WidgetAuthRefreshConfigDTO?,
472
+ state: inout InteractiveWidgetState
473
+ ) async -> SourceFetchResult {
474
+ let resolvedUrlStr = urlString.replacingOccurrences(of: "{{_randomId}}", with: "\(Int.random(in: 1...20))")
475
+ guard let url = URL(string: resolvedUrlStr) else {
476
+ return .failed(error: "Invalid URL", statusCode: nil)
477
+ }
478
+
479
+ let timeoutSecs = max(1.0, Double(timeoutMs) / 1000.0)
480
+ var didRefreshAuth = false
481
+ var lastError = "Network error"
482
+ var lastStatus: Int? = nil
483
+
484
+ for attempt in 0...max(0, maxRetries) {
485
+ if attempt > 0 {
486
+ let backoffMs = Double(max(100, retryDelayMs)) * pow(2.0, Double(attempt - 1))
487
+ let nanos = UInt64(min(backoffMs, 10_000.0) * 1_000_000.0)
488
+ try? await Task.sleep(nanoseconds: nanos)
489
+ }
490
+
491
+ var req = URLRequest(url: url)
492
+ req.httpMethod = method ?? "GET"
493
+ req.timeoutInterval = timeoutSecs
494
+ if let headers = headers {
495
+ for (k, v) in headers {
496
+ req.setValue(v, forHTTPHeaderField: k)
497
+ }
498
+ }
499
+
500
+ if let refreshedToken = state.accessToken, !refreshedToken.isEmpty {
501
+ let hName = authRefresh?.headerName ?? "Authorization"
502
+ let hPrefix = authRefresh?.headerPrefix ?? "Bearer "
503
+ req.setValue("\(hPrefix)\(refreshedToken)", forHTTPHeaderField: hName)
504
+ }
505
+
506
+ if enableETag {
507
+ if let savedEtag = state.etags?[cacheKey], !savedEtag.isEmpty {
508
+ req.setValue(savedEtag, forHTTPHeaderField: "If-None-Match")
509
+ }
510
+ if let savedMod = state.lastModified?[cacheKey], !savedMod.isEmpty {
511
+ req.setValue(savedMod, forHTTPHeaderField: "If-Modified-Since")
512
+ }
513
+ }
514
+
515
+ let (bodyData, contentType) = buildRequestBody(body)
516
+ if let bodyData = bodyData {
517
+ req.httpBody = bodyData
518
+ if let ct = contentType, req.value(forHTTPHeaderField: "Content-Type") == nil {
519
+ req.setValue(ct, forHTTPHeaderField: "Content-Type")
520
+ }
521
+ }
522
+
523
+ do {
524
+ let (data, response) = try await URLSession.shared.data(for: req)
525
+ let http = response as? HTTPURLResponse
526
+ let status = http?.statusCode ?? 200
527
+ lastStatus = status
528
+
529
+ if status == 304 {
530
+ return .notModified(statusCode: 304)
531
+ }
532
+
533
+ if status == 401, let auth = authRefresh, !didRefreshAuth {
534
+ didRefreshAuth = true
535
+ if let newToken = await performAuthRefresh(auth: auth, timeoutSeconds: timeoutSecs) {
536
+ state.accessToken = newToken
537
+ // Thử gọi lại ngay với token mới mà không tiêu tốn lượt retry backoff
538
+ var retryReq = req
539
+ let hName = auth.headerName ?? "Authorization"
540
+ let hPrefix = auth.headerPrefix ?? "Bearer "
541
+ retryReq.setValue("\(hPrefix)\(newToken)", forHTTPHeaderField: hName)
542
+ let (retryData, retryResp) = try await URLSession.shared.data(for: retryReq)
543
+ let retryHttp = retryResp as? HTTPURLResponse
544
+ let retryStatus = retryHttp?.statusCode ?? 200
545
+ lastStatus = retryStatus
546
+ if retryStatus == 304 {
547
+ return .notModified(statusCode: 304)
548
+ }
549
+ if (200...299).contains(retryStatus) {
550
+ let etag = retryHttp?.value(forHTTPHeaderField: "ETag")
551
+ let lastMod = retryHttp?.value(forHTTPHeaderField: "Last-Modified")
552
+ return .updated(data: retryData, etag: etag, lastModified: lastMod, statusCode: retryStatus)
553
+ }
554
+ lastError = "HTTP \(retryStatus)"
555
+ if retryStatus < 500 && retryStatus != 429 {
556
+ return .failed(error: lastError, statusCode: retryStatus)
557
+ }
558
+ continue
559
+ }
560
+ return .failed(error: "HTTP 401 Unauthorized", statusCode: 401)
561
+ }
562
+
563
+ if (200...299).contains(status) {
564
+ let etag = http?.value(forHTTPHeaderField: "ETag")
565
+ let lastMod = http?.value(forHTTPHeaderField: "Last-Modified")
566
+ return .updated(data: data, etag: etag, lastModified: lastMod, statusCode: status)
567
+ }
568
+
569
+ lastError = "HTTP \(status)"
570
+ if status < 500 && status != 429 {
571
+ return .failed(error: lastError, statusCode: status)
572
+ }
573
+ } catch {
574
+ lastError = error.localizedDescription
575
+ }
576
+ }
577
+
578
+ return .failed(error: lastError, statusCode: lastStatus)
579
+ }
580
+
97
581
  /// Chạy ngầm độc lập bên trong Widget Extension (kể cả khi Main App đã bị kill hoàn toàn)
98
- public static func performRemoteSync(widgetKey: String = "main") async {
582
+ public static func performRemoteSync(widgetKey: String = "main", forceRefresh: Bool = false) async {
99
583
  let configKey = "widget_remote_config_\(widgetKey)"
100
584
  guard let configJson = DynamicWidgetProvider.readSharedString(forKey: configKey, appGroup: ""),
101
585
  let configData = configJson.data(using: .utf8),
@@ -104,50 +588,178 @@ public enum DynamicWidgetStateStore {
104
588
  return
105
589
  }
106
590
 
107
- let randomId = Int.random(in: 1...20)
108
- let resolvedUrlStr = config.url.replacingOccurrences(of: "{{_randomId}}", with: "\(randomId)")
109
- guard let url = URL(string: resolvedUrlStr) else {
110
- stampSyncTimeOnly()
111
- return
112
- }
113
-
114
- var request = URLRequest(url: url)
115
- request.httpMethod = config.method ?? "GET"
116
- request.timeoutInterval = 3.0
117
- if let headers = config.headers {
118
- for (k, v) in headers {
119
- request.setValue(v, forHTTPHeaderField: k)
591
+ var state = loadState()
592
+ let now = Date().timeIntervalSince1970
593
+ let ttlSeconds = config.cacheTtlSeconds ?? 0
594
+ if !forceRefresh && ttlSeconds > 0 && state.lastSyncTime != nil && state.syncStatus != "error" {
595
+ if (now - state.updatedAt) < Double(ttlSeconds) {
596
+ return
120
597
  }
121
598
  }
122
599
 
123
- do {
124
- let (data, _) = try await URLSession.shared.data(for: request)
125
- var state = loadState()
126
- let formatter = DateFormatter()
127
- formatter.dateFormat = "HH:mm:ss"
128
- state.lastSyncTime = formatter.string(from: Date())
129
- state.updatedAt = Date().timeIntervalSince1970
600
+ let timeoutMs = config.timeoutMs ?? 8000
601
+ let enableETag = config.enableETag ?? false
602
+ let maxRetries = config.maxRetries ?? 0
603
+ let retryDelayMs = config.retryDelayMs ?? 500
130
604
 
131
- if let jsonObj = try? JSONSerialization.jsonObject(with: data) as? [String: Any] {
132
- if jsonObj["small"] != nil || jsonObj["medium"] != nil || jsonObj["large"] != nil || jsonObj["pages"] != nil,
133
- let rawStr = String(data: data, encoding: .utf8) {
134
- DynamicWidgetProvider.writeSharedString(rawStr, forKey: "widget_layout_\(widgetKey)", appGroup: "")
605
+ var mergedVars = state.remoteVariables ?? [:]
606
+ var anyFailedError: String? = nil
607
+ var finalStatusCode: Int? = nil
608
+ var fetchedAnyData = false
609
+ var allNotModified = true
610
+
611
+ if let primaryUrl = config.url, !primaryUrl.isEmpty {
612
+ let result = await fetchWithRetryAndAuth(
613
+ cacheKey: "\(widgetKey):main",
614
+ urlString: primaryUrl,
615
+ method: config.method,
616
+ headers: config.headers,
617
+ body: config.body,
618
+ timeoutMs: timeoutMs,
619
+ enableETag: enableETag,
620
+ maxRetries: maxRetries,
621
+ retryDelayMs: retryDelayMs,
622
+ authRefresh: config.authRefresh,
623
+ state: &state
624
+ )
625
+ switch result {
626
+ case .updated(let data, let etag, let lastMod, let status):
627
+ fetchedAnyData = true
628
+ allNotModified = false
629
+ finalStatusCode = status
630
+ if let etag = etag {
631
+ var etags = state.etags ?? [:]
632
+ etags["\(widgetKey):main"] = etag
633
+ state.etags = etags
634
+ }
635
+ if let lastMod = lastMod {
636
+ var lms = state.lastModified ?? [:]
637
+ lms["\(widgetKey):main"] = lastMod
638
+ state.lastModified = lms
639
+ }
640
+ if let jsonObj = try? JSONSerialization.jsonObject(with: data) {
641
+ if let dict = jsonObj as? [String: Any],
642
+ (dict["small"] != nil || dict["medium"] != nil || dict["large"] != nil || dict["pages"] != nil),
643
+ let rawStr = String(data: data, encoding: .utf8) {
644
+ DynamicWidgetProvider.writeSharedString(rawStr, forKey: "widget_layout_\(widgetKey)", appGroup: "")
645
+ }
646
+ flattenJsonObject(jsonObj, into: &mergedVars)
135
647
  }
648
+ case .notModified(let status):
649
+ finalStatusCode = status
650
+ case .failed(let err, let status):
651
+ allNotModified = false
652
+ anyFailedError = err
653
+ finalStatusCode = status
654
+ }
655
+ }
136
656
 
137
- var vars = state.remoteVariables ?? [:]
138
- for (k, v) in jsonObj {
139
- if let s = v as? String {
140
- vars[k] = s
141
- } else if let n = v as? NSNumber {
142
- vars[k] = n.stringValue
657
+ if let sources = config.sources, !sources.isEmpty {
658
+ for (srcKey, srcCfg) in sources {
659
+ let result = await fetchWithRetryAndAuth(
660
+ cacheKey: "\(widgetKey):\(srcKey)",
661
+ urlString: srcCfg.url,
662
+ method: srcCfg.method ?? config.method,
663
+ headers: srcCfg.headers ?? config.headers,
664
+ body: srcCfg.body,
665
+ timeoutMs: srcCfg.timeoutMs ?? timeoutMs,
666
+ enableETag: srcCfg.enableETag ?? enableETag,
667
+ maxRetries: maxRetries,
668
+ retryDelayMs: retryDelayMs,
669
+ authRefresh: config.authRefresh,
670
+ state: &state
671
+ )
672
+ switch result {
673
+ case .updated(let data, let etag, let lastMod, let status):
674
+ fetchedAnyData = true
675
+ allNotModified = false
676
+ if finalStatusCode == nil { finalStatusCode = status }
677
+ if let etag = etag {
678
+ var etags = state.etags ?? [:]
679
+ etags["\(widgetKey):\(srcKey)"] = etag
680
+ state.etags = etags
681
+ }
682
+ if let lastMod = lastMod {
683
+ var lms = state.lastModified ?? [:]
684
+ lms["\(widgetKey):\(srcKey)"] = lastMod
685
+ state.lastModified = lms
686
+ }
687
+ if let jsonObj = try? JSONSerialization.jsonObject(with: data) {
688
+ flattenJsonObject(jsonObj, prefix: srcKey, into: &mergedVars)
143
689
  }
690
+ case .notModified(let status):
691
+ if finalStatusCode == nil { finalStatusCode = status }
692
+ case .failed(let err, let status):
693
+ allNotModified = false
694
+ if anyFailedError == nil { anyFailedError = "\(srcKey): \(err)" }
695
+ if finalStatusCode == nil { finalStatusCode = status }
144
696
  }
145
- state.remoteVariables = vars
146
697
  }
698
+ }
699
+
700
+ let formatter = DateFormatter()
701
+ formatter.dateFormat = "HH:mm:ss"
702
+ let nowStr = formatter.string(from: Date())
703
+ state.lastSyncTime = nowStr
704
+ state.updatedAt = Date().timeIntervalSince1970
705
+ state.lastHttpStatus = finalStatusCode
706
+
707
+ if let err = anyFailedError, !fetchedAnyData && !allNotModified {
708
+ state.syncStatus = "error"
709
+ state.lastSyncError = err
710
+ var vars = state.remoteVariables ?? [:]
711
+ vars["_syncStatus"] = "error"
712
+ vars["_syncError"] = err
713
+ if let code = finalStatusCode { vars["_httpStatus"] = "\(code)" }
714
+ state.remoteVariables = vars
147
715
  saveState(state)
148
- } catch {
149
- stampSyncTimeOnly()
716
+ return
717
+ }
718
+
719
+ let validation = validateSchema(flatVars: &mergedVars, schema: config.schema)
720
+ if !validation.ok {
721
+ let errMsg = validation.error ?? "Schema validation failed"
722
+ state.syncStatus = "error"
723
+ state.lastSyncError = errMsg
724
+ var vars = state.remoteVariables ?? [:]
725
+ vars["_syncStatus"] = "error"
726
+ vars["_syncError"] = errMsg
727
+ if let code = finalStatusCode { vars["_httpStatus"] = "\(code)" }
728
+ state.remoteVariables = vars
729
+ saveState(state)
730
+ return
150
731
  }
732
+
733
+ if let mapping = config.mapping {
734
+ for (targetKey, expr) in mapping {
735
+ if expr.contains("{{") {
736
+ mergedVars[targetKey] = resolveTemplateString(expr, with: mergedVars)
737
+ } else {
738
+ let parts = expr.split(separator: "|", omittingEmptySubsequences: false).map(String.init)
739
+ let pathKey = parts[0].trimmingCharacters(in: .whitespaces)
740
+ let pipes = Array(parts.dropFirst())
741
+ if let existing = mergedVars[pathKey] {
742
+ mergedVars[targetKey] = pipes.isEmpty
743
+ ? (sanitizeVariableValue(existing) ?? existing)
744
+ : evaluateTemplatePipe(existing, pipes: pipes)
745
+ } else if !pipes.isEmpty {
746
+ mergedVars[targetKey] = evaluateTemplatePipe(nil, pipes: pipes)
747
+ } else {
748
+ mergedVars[targetKey] = expr
749
+ }
750
+ }
751
+ }
752
+ }
753
+
754
+ state.syncStatus = anyFailedError != nil ? "partial" : "ok"
755
+ state.lastSyncError = anyFailedError
756
+ mergedVars["_syncStatus"] = state.syncStatus ?? "ok"
757
+ mergedVars["_syncError"] = anyFailedError ?? ""
758
+ if let code = finalStatusCode {
759
+ mergedVars["_httpStatus"] = "\(code)"
760
+ }
761
+ state.remoteVariables = mergedVars
762
+ saveState(state)
151
763
  }
152
764
 
153
765
  private static func stampSyncTimeOnly() {
@@ -159,4 +771,3 @@ public enum DynamicWidgetStateStore {
159
771
  saveState(state)
160
772
  }
161
773
  }
162
-