機能追加: スナップショットリスナーに差分更新機能を追加

[fummicc1]

概要

Firestoreのスナップショットリスナーで、コレクション全体ではなく変更されたドキュメントのみを受け取れる新しいAPIを追加しました。

背景

現在のlisten()メソッドはsnapshots.documentsを使用して全ドキュメントを返却しており、1件の変更でもコレクション全体の処理が走る非効率な実装になっていました。

Firebase SDKのdocumentChangesAPIを活用することで、差分のみを返却できるようになります。

主な変更内容

追加した型

• FirestoreDocumentChangeType: 変更タイプを表すenum (added/modified/removed)
• FirestoreDocumentChange<Model>: 変更情報を格納するstruct

追加したメソッド

メソッド	用途
listenChanges(filter:includeCache:order:limit:)	Collection用差分リスナー
listenChanges(parent:superParent:filter:includeCache:order:limit:)	SubCollection用差分リスナー
listenCollectionGroupChanges(collectionName:filter:includeCache:order:limit:)	CollectionGroup用差分リスナー

使用例

for try await changes in client.listenChanges() as AsyncThrowingStream<[FirestoreDocumentChange<MyModel>], Error> {
    for change in changes {
        switch change.type {
        case .added:
            print("追加: \(change.document)")
        case .modified:
            print("変更: \(change.document)")
        case .removed:
            print("削除: \(change.document)")
        }
    }
}

後方互換性

既存のlisten()メソッドは変更なく、後方互換性を維持しています。

テスト

• xcrun swift build でビルド成功を確認

レビューポイント

• 型定義（FirestoreDocumentChangeType, FirestoreDocumentChange）の設計
• mapDocumentChangesヘルパーメソッドの実装
• 各リスナーメソッドの実装パターンの一貫性