Repository navigation
Closed
Labels
Milestone
Description
Before we tag v1.0.0 we should remove the deprecated public API surface so we ship a clean 1.0 without carrying deprecation cruft. A major release is the right (and only clean) time to make these breaking removals.
Deprecated declarations to remove
queryRecords overloads — CloudKitService+Operations+Deprecated.swift
The entire file exists only to house deprecated overloads (it was split out in #383/#384/#385 to stay under the file_length lint limit — see commit 1e41177). Delete the whole file:
queryRecords(recordType:filters:sortBy:limit:desiredKeys:database:) -> [RecordInfo]- Replacement:
queryRecords -> QueryResult(pagination) orqueryAllRecords(auto-paginate)
- Replacement:
queryRecords(recordType:filters:sortBy:limit:desiredKeys:continuationMarker:database:) -> QueryResult- Replacement:
queryRecords(_:limit:desiredKeys:continuationMarker:database:)— pass aQueryvalue
- Replacement:
RecordManaging protocol — RecordManagement/RecordManaging.swift
queryRecords(recordType:) async throws -> [RecordInfo](protocol requirement)- Replacement:
queryAllRecordsorqueryRecords -> QueryResult
- Replacement:
queryAllRecords(recordType:)default implementation (extension) — deprecated because it silently returns one page
CloudKitService: RecordManaging conformance — CloudKitService/CloudKitService+RecordManaging.swift
queryRecords(recordType:) async throws -> [RecordInfo](conformance impl)
Note: removing the protocol requirement may mean reworking or removing
RecordManagingitself, since its remaining surface is thin. Decide whether the protocol survives 1.0.
User operations — CloudKitService/CloudKitService+UserOperations.swift
fetchCurrentUser() -> UserInfo- Replacement:
fetchCaller()(Apple deprecatedusers/current)
- Replacement:
Follow-up cleanup
- Remove tests that exercise the deprecated overloads (e.g. the deprecated-query-overload coverage added in
d65ae28). - Grep the
Examples/test beds andMistDemofor any remaining call sites. - Update
CLAUDE.mdreferences (e.g. thefetchCurrentUser()row in the operations table).
Acceptance criteria
- No
@available(*, deprecated)public declarations remain inSources/MistKit -
swift buildandswift testpass -
./Scripts/lint.shpasses
Reacted by Paweł Majcher
Activity
Remove deprecated public API before v1.0.0 (#421)
Merge #421: remove deprecated public API before v1.0.0
Migrate #358's new tests off the query overload removed by #421
Remove deprecated public API before v1.0.0 (#421)
Migrate #358's new tests off the query overload removed by #421
Remove deprecated public API before v1.0.0 (#421)
Migrate #358's new tests off the query overload removed by #421
Remove deprecated public API before v1.0.0 (#421)
Migrate #358's new tests off the query overload removed by #421
Remove deprecated API, model server error codes, refactor FieldValue …
leogdion commentedon Aug 28, 2026
Resolved on
v1.0.0-beta.4via #424 (commit 1411227). All four deprecated declarations removed; no@available(*, deprecated)remains inSources/MistKit.Remove deprecated API, model server error codes, refactor FieldValue …
v1.0.0 beta.4 (#439)