mirror of
https://github.com/firebase/firebase-ios-sdk
synced 2026-11-11 22:55:59 +05:45
Sebastian Schmidt
5bc4cc55a6
* Drop acknowledged mutations in schema migration (#1818) Drop acknowledged mutations in schema migration as part of removing held write acks. Port of firebase/firebase-js-sdk#1149 * Change removeMutationBatch to remove a single batch (#1955) * Update Firestore Generated Protos * Adding UnknownDocument and hasCommittedMutations (#1971) * Removing held write batch handling from LocalStore (#1997) * View changes for held write acks (#2004) * Held Write Acks Unit Test Fixes (#2008) * Held Write Ack Removal Spec Tests (#2018) * Fix integration test
86 lines
3.0 KiB
Objective-C
86 lines
3.0 KiB
Objective-C
/*
|
|
* Copyright 2017 Google
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#import <Foundation/Foundation.h>
|
|
|
|
#include "Firestore/core/src/firebase/firestore/model/document_key.h"
|
|
#include "Firestore/core/src/firebase/firestore/model/field_path.h"
|
|
#include "Firestore/core/src/firebase/firestore/model/snapshot_version.h"
|
|
|
|
@class FSTFieldValue;
|
|
@class FSTObjectValue;
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/** Describes the `hasPendingWrites` state of a document. */
|
|
typedef NS_ENUM(NSInteger, FSTDocumentState) {
|
|
/** Local mutations applied via the mutation queue. Document is potentially inconsistent. */
|
|
FSTDocumentStateLocalMutations,
|
|
/** Mutations applied based on a write acknowledgment. Document is potentially inconsistent. */
|
|
FSTDocumentStateCommittedMutations,
|
|
/** No mutations applied. Document was sent to us by Watch. */
|
|
FSTDocumentStateSynced
|
|
};
|
|
|
|
/**
|
|
* The result of a lookup for a given path may be an existing document or a tombstone that marks
|
|
* the path deleted.
|
|
*/
|
|
@interface FSTMaybeDocument : NSObject <NSCopying>
|
|
- (id)init __attribute__((unavailable("Abstract base class")));
|
|
- (const firebase::firestore::model::DocumentKey &)key;
|
|
- (const firebase::firestore::model::SnapshotVersion &)version;
|
|
|
|
/**
|
|
* Whether this document has a local mutation applied that has not yet been acknowledged by Watch.
|
|
*/
|
|
- (BOOL)hasPendingWrites;
|
|
|
|
@end
|
|
|
|
@interface FSTDocument : FSTMaybeDocument
|
|
+ (instancetype)documentWithData:(FSTObjectValue *)data
|
|
key:(firebase::firestore::model::DocumentKey)key
|
|
version:(firebase::firestore::model::SnapshotVersion)version
|
|
state:(FSTDocumentState)state;
|
|
|
|
- (nullable FSTFieldValue *)fieldForPath:(const firebase::firestore::model::FieldPath &)path;
|
|
- (BOOL)hasLocalMutations;
|
|
- (BOOL)hasCommittedMutations;
|
|
|
|
@property(nonatomic, strong, readonly) FSTObjectValue *data;
|
|
|
|
@end
|
|
|
|
@interface FSTDeletedDocument : FSTMaybeDocument
|
|
+ (instancetype)documentWithKey:(firebase::firestore::model::DocumentKey)key
|
|
version:(firebase::firestore::model::SnapshotVersion)version
|
|
hasCommittedMutations:(BOOL)committedMutations;
|
|
|
|
- (BOOL)hasCommittedMutations;
|
|
|
|
@end
|
|
|
|
@interface FSTUnknownDocument : FSTMaybeDocument
|
|
+ (instancetype)documentWithKey:(firebase::firestore::model::DocumentKey)key
|
|
version:(firebase::firestore::model::SnapshotVersion)version;
|
|
@end
|
|
|
|
/** An NSComparator suitable for comparing docs using only their keys. */
|
|
extern const NSComparator FSTDocumentComparatorByKey;
|
|
|
|
NS_ASSUME_NONNULL_END
|