1.0.0-beta.5

[leogdion]

What's Changed

• Represent FieldValue.bytes as Data instead of a base64 String (Change FieldValue.bytes from String to Data #467)
• Add Asset.download(using:), which fetches an asset's downloadURL from the CDN and returns the bytes, plus CloudKitError.missingAssetDownloadURL. fileChecksum turned out to be a server-minted identity token rather than a digest of the file, so no client-side checksum verification is offered — check Asset.size to guard against truncation (Verify downloaded asset bytes against Asset.fileChecksum #466, Verify asset downloads against fileChecksum #473)
• Add VALIDATE to Reference.Action for CloudKit Web Services reference dictionaries (Add VALIDATE to Reference.Action enum based on CloudKit Web Services Documentation #464)
• Consume rotated web auth tokens from the X-Apple-CloudKit-Web-Auth-Token response header via a new TokenManager.didReceiveRotatedWebAuthToken(_:) requirement, defaulted to a no-op so existing conformances keep compiling (Web auth token rotation (X-Apple-CloudKit-Web-Auth-Token) is never consumed #462, Consume CloudKit web auth token rotation from response headers (#462) #463)
• Model the zone payload fields confirmed live in Zone payloads: deleted, zoneType unmodeled and ownerRecordName never decodes (confirmed live) #444: ZoneInfo.zoneType (a closed ZoneType enum that throws ConversionError.unrecognizedZoneType on unknown wire values) and ZoneInfo.deleted, so change feeds surface tombstones (Zone payloads: deleted, zoneType unmodeled and ownerRecordName never decodes (confirmed live) #444)
• Fix ownerRecordName never decoding on zone payloads — ZoneID read the wire key as ownerName, so shared-zone owners were always nil (Zone payloads: deleted, zoneType unmodeled and ownerRecordName never decodes (confirmed live) #444)
• Add an optional zoneID: parameter to createRecord, updateRecord, deleteRecord, and uploadAssets, so writes and asset uploads can target custom and shared zones (MistDemo: zone-aware writes (CRUD + assets) #454)
• Round [Date] list elements and nested Location.timestamp values to whole milliseconds on the way out, matching the scalar path, and make the list conversion an exhaustive default-free switch so a new FieldValue case fails the build instead of writing an empty list
• Extract the shared CloudKit credential configuration glue into a separate MistKitConfiguration package and converge the examples on typed configuration keys (Create MistKitConfiguration package for shared CloudKit config glue #407, Extract MistKitConfiguration; converge all three examples on typed config keys #455)
• MistDemo: expose zoneName/zoneOwner on the web query panel and add zone-aware writes plus a live shared-zone round-trip phase (MistDemo web UI: add zoneName/zoneOwner inputs to query panel #438, MistDemo web: zoneName/zoneOwner on query panel (#438) #453, MistDemo: zone-aware writes (CRUD + assets) #454)
• Documentation: add the "CloudKit as Your Backend" talk as a DocC article with its screenshots, plus new guides for request signing, field type polymorphism, deploying MistKit, and the two retrospectives (What CloudKit Got Wrong, What the AI Got Wrong); re-verify every existing catalog article against current source; link the guides and talk resources from the README; remove the top-level docs/ directory (Complete iOSDevUK Talk Material #447)
• Add a repeatable release runbook, address code review fixes, coverage, and lint tooling, and fix the MistDemo Integration static build for Swift 6.4 (Address beta.5 code review: fixes, coverage, and lint tooling #460, Add a repeatable release runbook #461, Fix MistDemo Integration static build for Swift 6.4 #475)

Full Changelog: 1.0.0-beta.4...1.0.0-beta.5

---

This discussion was created from the release 1.0.0-beta.5.