@firebase/firestore-compat 0.4.0-20230301000120 → 0.4.0-20250716004940

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 (85) hide show
  1. package/dist/index.cjs.js +980 -972
  2. package/dist/index.cjs.js.map +1 -1
  3. package/dist/{index.esm2017.js → index.esm.js} +981 -973
  4. package/dist/index.esm.js.map +1 -0
  5. package/dist/index.node.cjs.js +980 -972
  6. package/dist/index.node.cjs.js.map +1 -1
  7. package/dist/index.rn.js +980 -972
  8. package/dist/index.rn.js.map +1 -1
  9. package/dist/node-esm/index.node.esm.js +980 -972
  10. package/dist/node-esm/index.node.esm.js.map +1 -1
  11. package/dist/node-esm/src/api/blob.d.ts +29 -29
  12. package/dist/node-esm/src/api/database.d.ts +228 -228
  13. package/dist/node-esm/src/api/field_path.d.ts +36 -36
  14. package/dist/node-esm/src/api/field_value.d.ts +29 -29
  15. package/dist/node-esm/src/api/geo_point.d.ts +17 -17
  16. package/dist/node-esm/src/api/observer.d.ts +29 -29
  17. package/dist/node-esm/src/api/timestamp.d.ts +17 -17
  18. package/dist/node-esm/src/config.d.ts +28 -28
  19. package/dist/node-esm/src/index.console.d.ts +48 -48
  20. package/dist/node-esm/src/index.d.ts +49 -49
  21. package/dist/node-esm/src/index.node.d.ts +22 -22
  22. package/dist/node-esm/src/index.rn.d.ts +22 -22
  23. package/dist/node-esm/src/register-module.d.ts +42 -42
  24. package/dist/node-esm/src/util/input_validation.d.ts +18 -18
  25. package/dist/node-esm/test/array_transforms.test.d.ts +17 -17
  26. package/dist/node-esm/test/batch_writes.test.d.ts +17 -17
  27. package/dist/node-esm/test/bootstrap.d.ts +17 -17
  28. package/dist/node-esm/test/bundle.test.d.ts +17 -17
  29. package/dist/node-esm/test/cursor.test.d.ts +17 -17
  30. package/dist/node-esm/test/database.test.d.ts +17 -17
  31. package/dist/node-esm/test/fields.test.d.ts +17 -17
  32. package/dist/node-esm/test/get_options.test.d.ts +17 -17
  33. package/dist/node-esm/test/numeric_transforms.test.d.ts +17 -17
  34. package/dist/node-esm/test/query.test.d.ts +17 -17
  35. package/dist/node-esm/test/server_timestamp.test.d.ts +17 -17
  36. package/dist/node-esm/test/smoke.test.d.ts +17 -17
  37. package/dist/node-esm/test/transactions.test.d.ts +17 -17
  38. package/dist/node-esm/test/type.test.d.ts +17 -17
  39. package/dist/node-esm/test/util/equality_matcher.d.ts +33 -33
  40. package/dist/node-esm/test/util/events_accumulator.d.ts +39 -39
  41. package/dist/node-esm/test/util/firebase_export.d.ts +29 -29
  42. package/dist/node-esm/test/util/helpers.d.ts +49 -49
  43. package/dist/node-esm/test/util/promise.d.ts +28 -28
  44. package/dist/node-esm/test/util/settings.d.ts +23 -23
  45. package/dist/node-esm/test/validation.test.d.ts +17 -17
  46. package/dist/src/api/blob.d.ts +29 -29
  47. package/dist/src/api/database.d.ts +228 -228
  48. package/dist/src/api/field_path.d.ts +36 -36
  49. package/dist/src/api/field_value.d.ts +29 -29
  50. package/dist/src/api/geo_point.d.ts +17 -17
  51. package/dist/src/api/observer.d.ts +29 -29
  52. package/dist/src/api/timestamp.d.ts +17 -17
  53. package/dist/src/config.d.ts +28 -28
  54. package/dist/src/index.console.d.ts +48 -48
  55. package/dist/src/index.d.ts +117 -85
  56. package/dist/src/index.node.d.ts +22 -22
  57. package/dist/src/index.rn.d.ts +22 -22
  58. package/dist/src/register-module.d.ts +42 -42
  59. package/dist/src/util/input_validation.d.ts +18 -18
  60. package/dist/test/array_transforms.test.d.ts +17 -17
  61. package/dist/test/batch_writes.test.d.ts +17 -17
  62. package/dist/test/bootstrap.d.ts +17 -17
  63. package/dist/test/bundle.test.d.ts +17 -17
  64. package/dist/test/cursor.test.d.ts +17 -17
  65. package/dist/test/database.test.d.ts +17 -17
  66. package/dist/test/fields.test.d.ts +17 -17
  67. package/dist/test/get_options.test.d.ts +17 -17
  68. package/dist/test/numeric_transforms.test.d.ts +17 -17
  69. package/dist/test/query.test.d.ts +17 -17
  70. package/dist/test/server_timestamp.test.d.ts +17 -17
  71. package/dist/test/smoke.test.d.ts +17 -17
  72. package/dist/test/transactions.test.d.ts +17 -17
  73. package/dist/test/type.test.d.ts +17 -17
  74. package/dist/test/util/equality_matcher.d.ts +33 -33
  75. package/dist/test/util/events_accumulator.d.ts +39 -39
  76. package/dist/test/util/firebase_export.d.ts +29 -29
  77. package/dist/test/util/helpers.d.ts +49 -49
  78. package/dist/test/util/promise.d.ts +28 -28
  79. package/dist/test/util/settings.d.ts +23 -23
  80. package/dist/test/validation.test.d.ts +17 -17
  81. package/package.json +25 -23
  82. package/CHANGELOG.md +0 -330
  83. package/dist/index.esm2017.js.map +0 -1
  84. package/dist/index.esm5.js +0 -1196
  85. package/dist/index.esm5.js.map +0 -1
@@ -1,228 +1,228 @@
1
- /**
2
- * @license
3
- * Copyright 2017 Google LLC
4
- *
5
- * Licensed under the Apache License, Version 2.0 (the "License");
6
- * you may not use this file except in compliance with the License.
7
- * You may obtain a copy of the License at
8
- *
9
- * http://www.apache.org/licenses/LICENSE-2.0
10
- *
11
- * Unless required by applicable law or agreed to in writing, software
12
- * distributed under the License is distributed on an "AS IS" BASIS,
13
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- * See the License for the specific language governing permissions and
15
- * limitations under the License.
16
- */
17
- import { FirebaseApp } from '@firebase/app-types';
18
- import { FirebaseService } from '@firebase/app-types/private';
19
- import { LoadBundleTask, Firestore as ExpFirestore, Query as ExpQuery, CollectionReference as ExpCollectionReference, DocumentReference as ExpDocumentReference, Unsubscribe, DocumentChange as ExpDocumentChange, DocumentSnapshot as ExpDocumentSnapshot, QuerySnapshot as ExpQuerySnapshot, SnapshotMetadata, Transaction as ExpTransaction, WriteBatch as ExpWriteBatch, AbstractUserDataWriter, FirestoreDataConverter as ModularFirestoreDataConverter, _DatabaseId, _DocumentKey, _FieldPath, _ResourcePath, _ByteString } from '@firebase/firestore';
20
- import { CollectionReference as PublicCollectionReference, DocumentChange as PublicDocumentChange, DocumentChangeType as PublicDocumentChangeType, DocumentData, DocumentData as PublicDocumentData, DocumentReference as PublicDocumentReference, DocumentSnapshot as PublicDocumentSnapshot, FieldPath as PublicFieldPath, FirebaseFirestore as PublicFirestore, FirestoreDataConverter as PublicFirestoreDataConverter, GetOptions as PublicGetOptions, LogLevel as PublicLogLevel, OrderByDirection as PublicOrderByDirection, PersistenceSettings as PublicPersistenceSettings, Query as PublicQuery, QueryDocumentSnapshot as PublicQueryDocumentSnapshot, QuerySnapshot as PublicQuerySnapshot, SetOptions as PublicSetOptions, Settings as PublicSettings, SnapshotListenOptions as PublicSnapshotListenOptions, SnapshotOptions as PublicSnapshotOptions, Transaction as PublicTransaction, UpdateData as PublicUpdateData, WhereFilterOp as PublicWhereFilterOp, WriteBatch as PublicWriteBatch } from '@firebase/firestore-types';
21
- import { Compat, EmulatorMockTokenOptions } from '@firebase/util';
22
- import { Blob } from './blob';
23
- import { CompleteFn, ErrorFn, NextFn, PartialObserver } from './observer';
24
- /**
25
- * A persistence provider for either memory-only or IndexedDB persistence.
26
- * Mainly used to allow optional inclusion of IndexedDB code.
27
- */
28
- export interface PersistenceProvider {
29
- enableIndexedDbPersistence(firestore: Firestore, forceOwnership: boolean): Promise<void>;
30
- enableMultiTabIndexedDbPersistence(firestore: Firestore): Promise<void>;
31
- clearIndexedDbPersistence(firestore: Firestore): Promise<void>;
32
- }
33
- /**
34
- * The persistence provider included with the full Firestore SDK.
35
- */
36
- export declare class IndexedDbPersistenceProvider implements PersistenceProvider {
37
- enableIndexedDbPersistence(firestore: Firestore, forceOwnership: boolean): Promise<void>;
38
- enableMultiTabIndexedDbPersistence(firestore: Firestore): Promise<void>;
39
- clearIndexedDbPersistence(firestore: Firestore): Promise<void>;
40
- }
41
- /**
42
- * Compat class for Firestore. Exposes Firestore Legacy API, but delegates
43
- * to the functional API of firestore-exp.
44
- */
45
- export declare class Firestore implements PublicFirestore, FirebaseService, Compat<ExpFirestore> {
46
- readonly _delegate: ExpFirestore;
47
- private _persistenceProvider;
48
- _appCompat?: FirebaseApp;
49
- constructor(databaseIdOrApp: _DatabaseId | FirebaseApp, _delegate: ExpFirestore, _persistenceProvider: PersistenceProvider);
50
- get _databaseId(): _DatabaseId;
51
- settings(settingsLiteral: PublicSettings): void;
52
- useEmulator(host: string, port: number, options?: {
53
- mockUserToken?: EmulatorMockTokenOptions | string;
54
- }): void;
55
- enableNetwork(): Promise<void>;
56
- disableNetwork(): Promise<void>;
57
- enablePersistence(settings?: PublicPersistenceSettings): Promise<void>;
58
- clearPersistence(): Promise<void>;
59
- terminate(): Promise<void>;
60
- waitForPendingWrites(): Promise<void>;
61
- onSnapshotsInSync(observer: PartialObserver<void>): Unsubscribe;
62
- onSnapshotsInSync(onSync: () => void): Unsubscribe;
63
- get app(): FirebaseApp;
64
- INTERNAL: {
65
- delete: () => Promise<void>;
66
- };
67
- collection(pathString: string): PublicCollectionReference;
68
- doc(pathString: string): PublicDocumentReference;
69
- collectionGroup(collectionId: string): PublicQuery;
70
- runTransaction<T>(updateFunction: (transaction: PublicTransaction) => Promise<T>): Promise<T>;
71
- batch(): PublicWriteBatch;
72
- loadBundle(bundleData: ArrayBuffer | ReadableStream<Uint8Array> | string): LoadBundleTask;
73
- namedQuery(name: string): Promise<PublicQuery<DocumentData> | null>;
74
- }
75
- export declare class UserDataWriter extends AbstractUserDataWriter {
76
- protected firestore: Firestore;
77
- constructor(firestore: Firestore);
78
- protected convertBytes(bytes: _ByteString): Blob;
79
- protected convertReference(name: string): DocumentReference;
80
- }
81
- export declare function setLogLevel(level: PublicLogLevel): void;
82
- /**
83
- * A reference to a transaction.
84
- */
85
- export declare class Transaction implements PublicTransaction, Compat<ExpTransaction> {
86
- private readonly _firestore;
87
- readonly _delegate: ExpTransaction;
88
- private _userDataWriter;
89
- constructor(_firestore: Firestore, _delegate: ExpTransaction);
90
- get<T>(documentRef: PublicDocumentReference<T>): Promise<PublicDocumentSnapshot<T>>;
91
- set<T>(documentRef: DocumentReference<T>, data: Partial<T>, options: PublicSetOptions): Transaction;
92
- set<T>(documentRef: DocumentReference<T>, data: T): Transaction;
93
- update(documentRef: PublicDocumentReference<unknown>, data: PublicUpdateData): Transaction;
94
- update(documentRef: PublicDocumentReference<unknown>, field: string | PublicFieldPath, value: unknown, ...moreFieldsAndValues: unknown[]): Transaction;
95
- delete(documentRef: PublicDocumentReference<unknown>): Transaction;
96
- }
97
- export declare class WriteBatch implements PublicWriteBatch, Compat<ExpWriteBatch> {
98
- readonly _delegate: ExpWriteBatch;
99
- constructor(_delegate: ExpWriteBatch);
100
- set<T>(documentRef: DocumentReference<T>, data: Partial<T>, options: PublicSetOptions): WriteBatch;
101
- set<T>(documentRef: DocumentReference<T>, data: T): WriteBatch;
102
- update(documentRef: PublicDocumentReference<unknown>, data: PublicUpdateData): WriteBatch;
103
- update(documentRef: PublicDocumentReference<unknown>, field: string | PublicFieldPath, value: unknown, ...moreFieldsAndValues: unknown[]): WriteBatch;
104
- delete(documentRef: PublicDocumentReference<unknown>): WriteBatch;
105
- commit(): Promise<void>;
106
- }
107
- /**
108
- * A reference to a particular document in a collection in the database.
109
- */
110
- export declare class DocumentReference<T = PublicDocumentData> implements PublicDocumentReference<T>, Compat<ExpDocumentReference<T>> {
111
- readonly firestore: Firestore;
112
- readonly _delegate: ExpDocumentReference<T>;
113
- private _userDataWriter;
114
- constructor(firestore: Firestore, _delegate: ExpDocumentReference<T>);
115
- static forPath<U>(path: _ResourcePath, firestore: Firestore, converter: ModularFirestoreDataConverter<U> | null): DocumentReference<U>;
116
- static forKey<U>(key: _DocumentKey, firestore: Firestore, converter: ModularFirestoreDataConverter<U> | null): DocumentReference<U>;
117
- get id(): string;
118
- get parent(): PublicCollectionReference<T>;
119
- get path(): string;
120
- collection(pathString: string): PublicCollectionReference<PublicDocumentData>;
121
- isEqual(other: PublicDocumentReference<T>): boolean;
122
- set(value: Partial<T>, options: PublicSetOptions): Promise<void>;
123
- set(value: T): Promise<void>;
124
- update(value: PublicUpdateData): Promise<void>;
125
- update(field: string | PublicFieldPath, value: unknown, ...moreFieldsAndValues: unknown[]): Promise<void>;
126
- delete(): Promise<void>;
127
- onSnapshot(observer: PartialObserver<PublicDocumentSnapshot<T>>): Unsubscribe;
128
- onSnapshot(options: PublicSnapshotListenOptions, observer: PartialObserver<PublicDocumentSnapshot<T>>): Unsubscribe;
129
- onSnapshot(onNext: NextFn<PublicDocumentSnapshot<T>>, onError?: ErrorFn, onCompletion?: CompleteFn): Unsubscribe;
130
- onSnapshot(options: PublicSnapshotListenOptions, onNext: NextFn<PublicDocumentSnapshot<T>>, onError?: ErrorFn, onCompletion?: CompleteFn): Unsubscribe;
131
- get(options?: PublicGetOptions): Promise<PublicDocumentSnapshot<T>>;
132
- withConverter(converter: null): PublicDocumentReference<PublicDocumentData>;
133
- withConverter<U>(converter: PublicFirestoreDataConverter<U>): PublicDocumentReference<U>;
134
- }
135
- /**
136
- * Iterates the list of arguments from an `onSnapshot` call and returns the
137
- * first argument that may be an `SnapshotListenOptions` object. Returns an
138
- * empty object if none is found.
139
- */
140
- export declare function extractSnapshotOptions(args: unknown[]): PublicSnapshotListenOptions;
141
- /**
142
- * Creates an observer that can be passed to the firestore-exp SDK. The
143
- * observer converts all observed values into the format expected by the classic
144
- * SDK.
145
- *
146
- * @param args - The list of arguments from an `onSnapshot` call.
147
- * @param wrapper - The function that converts the firestore-exp type into the
148
- * type used by this shim.
149
- */
150
- export declare function wrapObserver<CompatType, ExpType>(args: unknown[], wrapper: (val: ExpType) => CompatType): PartialObserver<ExpType>;
151
- /**
152
- * Options interface that can be provided to configure the deserialization of
153
- * DocumentSnapshots.
154
- */
155
- export interface SnapshotOptions extends PublicSnapshotOptions {
156
- }
157
- export declare class DocumentSnapshot<T = PublicDocumentData> implements PublicDocumentSnapshot<T>, Compat<ExpDocumentSnapshot<T>> {
158
- private readonly _firestore;
159
- readonly _delegate: ExpDocumentSnapshot<T>;
160
- constructor(_firestore: Firestore, _delegate: ExpDocumentSnapshot<T>);
161
- get ref(): DocumentReference<T>;
162
- get id(): string;
163
- get metadata(): SnapshotMetadata;
164
- get exists(): boolean;
165
- data(options?: PublicSnapshotOptions): T | undefined;
166
- get(fieldPath: string | PublicFieldPath, options?: PublicSnapshotOptions): any;
167
- isEqual(other: DocumentSnapshot<T>): boolean;
168
- }
169
- export declare class QueryDocumentSnapshot<T = PublicDocumentData> extends DocumentSnapshot<T> implements PublicQueryDocumentSnapshot<T> {
170
- data(options?: PublicSnapshotOptions): T;
171
- }
172
- export declare class Query<T = PublicDocumentData> implements PublicQuery<T>, Compat<ExpQuery<T>> {
173
- readonly firestore: Firestore;
174
- readonly _delegate: ExpQuery<T>;
175
- private readonly _userDataWriter;
176
- constructor(firestore: Firestore, _delegate: ExpQuery<T>);
177
- where(fieldPath: string | _FieldPath, opStr: PublicWhereFilterOp, value: unknown): Query<T>;
178
- orderBy(fieldPath: string | _FieldPath, directionStr?: PublicOrderByDirection): Query<T>;
179
- limit(n: number): Query<T>;
180
- limitToLast(n: number): Query<T>;
181
- startAt(...args: any[]): Query<T>;
182
- startAfter(...args: any[]): Query<T>;
183
- endBefore(...args: any[]): Query<T>;
184
- endAt(...args: any[]): Query<T>;
185
- isEqual(other: PublicQuery<T>): boolean;
186
- get(options?: PublicGetOptions): Promise<QuerySnapshot<T>>;
187
- onSnapshot(observer: PartialObserver<PublicQuerySnapshot<T>>): Unsubscribe;
188
- onSnapshot(options: PublicSnapshotListenOptions, observer: PartialObserver<PublicQuerySnapshot<T>>): Unsubscribe;
189
- onSnapshot(onNext: NextFn<PublicQuerySnapshot<T>>, onError?: ErrorFn, onCompletion?: CompleteFn): Unsubscribe;
190
- onSnapshot(options: PublicSnapshotListenOptions, onNext: NextFn<PublicQuerySnapshot<T>>, onError?: ErrorFn, onCompletion?: CompleteFn): Unsubscribe;
191
- withConverter(converter: null): Query<PublicDocumentData>;
192
- withConverter<U>(converter: PublicFirestoreDataConverter<U>): Query<U>;
193
- }
194
- export declare class DocumentChange<T = PublicDocumentData> implements PublicDocumentChange<T>, Compat<ExpDocumentChange<T>> {
195
- private readonly _firestore;
196
- readonly _delegate: ExpDocumentChange<T>;
197
- constructor(_firestore: Firestore, _delegate: ExpDocumentChange<T>);
198
- get type(): PublicDocumentChangeType;
199
- get doc(): QueryDocumentSnapshot<T>;
200
- get oldIndex(): number;
201
- get newIndex(): number;
202
- }
203
- export declare class QuerySnapshot<T = PublicDocumentData> implements PublicQuerySnapshot<T>, Compat<ExpQuerySnapshot<T>> {
204
- readonly _firestore: Firestore;
205
- readonly _delegate: ExpQuerySnapshot<T>;
206
- constructor(_firestore: Firestore, _delegate: ExpQuerySnapshot<T>);
207
- get query(): Query<T>;
208
- get metadata(): SnapshotMetadata;
209
- get size(): number;
210
- get empty(): boolean;
211
- get docs(): Array<QueryDocumentSnapshot<T>>;
212
- docChanges(options?: PublicSnapshotListenOptions): Array<PublicDocumentChange<T>>;
213
- forEach(callback: (result: QueryDocumentSnapshot<T>) => void, thisArg?: unknown): void;
214
- isEqual(other: QuerySnapshot<T>): boolean;
215
- }
216
- export declare class CollectionReference<T = PublicDocumentData> extends Query<T> implements PublicCollectionReference<T> {
217
- readonly firestore: Firestore;
218
- readonly _delegate: ExpCollectionReference<T>;
219
- constructor(firestore: Firestore, _delegate: ExpCollectionReference<T>);
220
- get id(): string;
221
- get path(): string;
222
- get parent(): DocumentReference<PublicDocumentData> | null;
223
- doc(documentPath?: string): DocumentReference<T>;
224
- add(data: T): Promise<DocumentReference<T>>;
225
- isEqual(other: CollectionReference<T>): boolean;
226
- withConverter(converter: null): CollectionReference<PublicDocumentData>;
227
- withConverter<U>(converter: PublicFirestoreDataConverter<U>): CollectionReference<U>;
228
- }
1
+ /**
2
+ * @license
3
+ * Copyright 2017 Google LLC
4
+ *
5
+ * Licensed under the Apache License, Version 2.0 (the "License");
6
+ * you may not use this file except in compliance with the License.
7
+ * You may obtain a copy of the License at
8
+ *
9
+ * http://www.apache.org/licenses/LICENSE-2.0
10
+ *
11
+ * Unless required by applicable law or agreed to in writing, software
12
+ * distributed under the License is distributed on an "AS IS" BASIS,
13
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ * See the License for the specific language governing permissions and
15
+ * limitations under the License.
16
+ */
17
+ import { FirebaseApp } from '@firebase/app-types';
18
+ import { FirebaseService } from '@firebase/app-types/private';
19
+ import { LoadBundleTask, Firestore as ExpFirestore, Query as ExpQuery, CollectionReference as ExpCollectionReference, DocumentReference as ExpDocumentReference, Unsubscribe, DocumentChange as ExpDocumentChange, DocumentSnapshot as ExpDocumentSnapshot, QuerySnapshot as ExpQuerySnapshot, SnapshotMetadata, Transaction as ExpTransaction, WriteBatch as ExpWriteBatch, AbstractUserDataWriter, FirestoreDataConverter as ModularFirestoreDataConverter, _DatabaseId, _DocumentKey, _FieldPath, _ResourcePath, _ByteString } from '@firebase/firestore';
20
+ import { CollectionReference as PublicCollectionReference, DocumentChange as PublicDocumentChange, DocumentChangeType as PublicDocumentChangeType, DocumentData, DocumentData as PublicDocumentData, DocumentReference as PublicDocumentReference, DocumentSnapshot as PublicDocumentSnapshot, FieldPath as PublicFieldPath, FirebaseFirestore as PublicFirestore, FirestoreDataConverter as PublicFirestoreDataConverter, GetOptions as PublicGetOptions, LogLevel as PublicLogLevel, OrderByDirection as PublicOrderByDirection, PersistenceSettings as PublicPersistenceSettings, Query as PublicQuery, QueryDocumentSnapshot as PublicQueryDocumentSnapshot, QuerySnapshot as PublicQuerySnapshot, SetOptions as PublicSetOptions, Settings as PublicSettings, SnapshotListenOptions as PublicSnapshotListenOptions, SnapshotOptions as PublicSnapshotOptions, Transaction as PublicTransaction, UpdateData as PublicUpdateData, WhereFilterOp as PublicWhereFilterOp, WriteBatch as PublicWriteBatch } from '@firebase/firestore-types';
21
+ import { Compat, EmulatorMockTokenOptions } from '@firebase/util';
22
+ import { Blob } from './blob';
23
+ import { CompleteFn, ErrorFn, NextFn, PartialObserver } from './observer';
24
+ /**
25
+ * A persistence provider for either memory-only or IndexedDB persistence.
26
+ * Mainly used to allow optional inclusion of IndexedDB code.
27
+ */
28
+ export interface PersistenceProvider {
29
+ enableIndexedDbPersistence(firestore: Firestore, forceOwnership: boolean): Promise<void>;
30
+ enableMultiTabIndexedDbPersistence(firestore: Firestore): Promise<void>;
31
+ clearIndexedDbPersistence(firestore: Firestore): Promise<void>;
32
+ }
33
+ /**
34
+ * The persistence provider included with the full Firestore SDK.
35
+ */
36
+ export declare class IndexedDbPersistenceProvider implements PersistenceProvider {
37
+ enableIndexedDbPersistence(firestore: Firestore, forceOwnership: boolean): Promise<void>;
38
+ enableMultiTabIndexedDbPersistence(firestore: Firestore): Promise<void>;
39
+ clearIndexedDbPersistence(firestore: Firestore): Promise<void>;
40
+ }
41
+ /**
42
+ * Compat class for Firestore. Exposes Firestore Legacy API, but delegates
43
+ * to the functional API of firestore-exp.
44
+ */
45
+ export declare class Firestore implements PublicFirestore, FirebaseService, Compat<ExpFirestore> {
46
+ readonly _delegate: ExpFirestore;
47
+ private _persistenceProvider;
48
+ _appCompat?: FirebaseApp;
49
+ constructor(databaseIdOrApp: _DatabaseId | FirebaseApp, _delegate: ExpFirestore, _persistenceProvider: PersistenceProvider);
50
+ get _databaseId(): _DatabaseId;
51
+ settings(settingsLiteral: PublicSettings): void;
52
+ useEmulator(host: string, port: number, options?: {
53
+ mockUserToken?: EmulatorMockTokenOptions | string;
54
+ }): void;
55
+ enableNetwork(): Promise<void>;
56
+ disableNetwork(): Promise<void>;
57
+ enablePersistence(settings?: PublicPersistenceSettings): Promise<void>;
58
+ clearPersistence(): Promise<void>;
59
+ terminate(): Promise<void>;
60
+ waitForPendingWrites(): Promise<void>;
61
+ onSnapshotsInSync(observer: PartialObserver<void>): Unsubscribe;
62
+ onSnapshotsInSync(onSync: () => void): Unsubscribe;
63
+ get app(): FirebaseApp;
64
+ INTERNAL: {
65
+ delete: () => Promise<void>;
66
+ };
67
+ collection(pathString: string): PublicCollectionReference;
68
+ doc(pathString: string): PublicDocumentReference;
69
+ collectionGroup(collectionId: string): PublicQuery;
70
+ runTransaction<T>(updateFunction: (transaction: PublicTransaction) => Promise<T>): Promise<T>;
71
+ batch(): PublicWriteBatch;
72
+ loadBundle(bundleData: ArrayBuffer | ReadableStream<Uint8Array> | string): LoadBundleTask;
73
+ namedQuery(name: string): Promise<PublicQuery<DocumentData> | null>;
74
+ }
75
+ export declare class UserDataWriter extends AbstractUserDataWriter {
76
+ protected firestore: Firestore;
77
+ constructor(firestore: Firestore);
78
+ protected convertBytes(bytes: _ByteString): Blob;
79
+ protected convertReference(name: string): DocumentReference;
80
+ }
81
+ export declare function setLogLevel(level: PublicLogLevel): void;
82
+ /**
83
+ * A reference to a transaction.
84
+ */
85
+ export declare class Transaction implements PublicTransaction, Compat<ExpTransaction> {
86
+ private readonly _firestore;
87
+ readonly _delegate: ExpTransaction;
88
+ private _userDataWriter;
89
+ constructor(_firestore: Firestore, _delegate: ExpTransaction);
90
+ get<T>(documentRef: PublicDocumentReference<T>): Promise<PublicDocumentSnapshot<T>>;
91
+ set<T>(documentRef: DocumentReference<T>, data: Partial<T>, options: PublicSetOptions): Transaction;
92
+ set<T>(documentRef: DocumentReference<T>, data: T): Transaction;
93
+ update(documentRef: PublicDocumentReference<unknown>, data: PublicUpdateData): Transaction;
94
+ update(documentRef: PublicDocumentReference<unknown>, field: string | PublicFieldPath, value: unknown, ...moreFieldsAndValues: unknown[]): Transaction;
95
+ delete(documentRef: PublicDocumentReference<unknown>): Transaction;
96
+ }
97
+ export declare class WriteBatch implements PublicWriteBatch, Compat<ExpWriteBatch> {
98
+ readonly _delegate: ExpWriteBatch;
99
+ constructor(_delegate: ExpWriteBatch);
100
+ set<T>(documentRef: DocumentReference<T>, data: Partial<T>, options: PublicSetOptions): WriteBatch;
101
+ set<T>(documentRef: DocumentReference<T>, data: T): WriteBatch;
102
+ update(documentRef: PublicDocumentReference<unknown>, data: PublicUpdateData): WriteBatch;
103
+ update(documentRef: PublicDocumentReference<unknown>, field: string | PublicFieldPath, value: unknown, ...moreFieldsAndValues: unknown[]): WriteBatch;
104
+ delete(documentRef: PublicDocumentReference<unknown>): WriteBatch;
105
+ commit(): Promise<void>;
106
+ }
107
+ /**
108
+ * A reference to a particular document in a collection in the database.
109
+ */
110
+ export declare class DocumentReference<T = PublicDocumentData> implements PublicDocumentReference<T>, Compat<ExpDocumentReference<T>> {
111
+ readonly firestore: Firestore;
112
+ readonly _delegate: ExpDocumentReference<T>;
113
+ private _userDataWriter;
114
+ constructor(firestore: Firestore, _delegate: ExpDocumentReference<T>);
115
+ static forPath<U>(path: _ResourcePath, firestore: Firestore, converter: ModularFirestoreDataConverter<U> | null): DocumentReference<U>;
116
+ static forKey<U>(key: _DocumentKey, firestore: Firestore, converter: ModularFirestoreDataConverter<U> | null): DocumentReference<U>;
117
+ get id(): string;
118
+ get parent(): PublicCollectionReference<T>;
119
+ get path(): string;
120
+ collection(pathString: string): PublicCollectionReference<PublicDocumentData>;
121
+ isEqual(other: PublicDocumentReference<T>): boolean;
122
+ set(value: Partial<T>, options: PublicSetOptions): Promise<void>;
123
+ set(value: T): Promise<void>;
124
+ update(value: PublicUpdateData): Promise<void>;
125
+ update(field: string | PublicFieldPath, value: unknown, ...moreFieldsAndValues: unknown[]): Promise<void>;
126
+ delete(): Promise<void>;
127
+ onSnapshot(observer: PartialObserver<PublicDocumentSnapshot<T>>): Unsubscribe;
128
+ onSnapshot(options: PublicSnapshotListenOptions, observer: PartialObserver<PublicDocumentSnapshot<T>>): Unsubscribe;
129
+ onSnapshot(onNext: NextFn<PublicDocumentSnapshot<T>>, onError?: ErrorFn, onCompletion?: CompleteFn): Unsubscribe;
130
+ onSnapshot(options: PublicSnapshotListenOptions, onNext: NextFn<PublicDocumentSnapshot<T>>, onError?: ErrorFn, onCompletion?: CompleteFn): Unsubscribe;
131
+ get(options?: PublicGetOptions): Promise<PublicDocumentSnapshot<T>>;
132
+ withConverter(converter: null): PublicDocumentReference<PublicDocumentData>;
133
+ withConverter<U>(converter: PublicFirestoreDataConverter<U>): PublicDocumentReference<U>;
134
+ }
135
+ /**
136
+ * Iterates the list of arguments from an `onSnapshot` call and returns the
137
+ * first argument that may be an `SnapshotListenOptions` object. Returns an
138
+ * empty object if none is found.
139
+ */
140
+ export declare function extractSnapshotOptions(args: unknown[]): PublicSnapshotListenOptions;
141
+ /**
142
+ * Creates an observer that can be passed to the firestore-exp SDK. The
143
+ * observer converts all observed values into the format expected by the classic
144
+ * SDK.
145
+ *
146
+ * @param args - The list of arguments from an `onSnapshot` call.
147
+ * @param wrapper - The function that converts the firestore-exp type into the
148
+ * type used by this shim.
149
+ */
150
+ export declare function wrapObserver<CompatType, ExpType>(args: unknown[], wrapper: (val: ExpType) => CompatType): PartialObserver<ExpType>;
151
+ /**
152
+ * Options interface that can be provided to configure the deserialization of
153
+ * DocumentSnapshots.
154
+ */
155
+ export interface SnapshotOptions extends PublicSnapshotOptions {
156
+ }
157
+ export declare class DocumentSnapshot<T = PublicDocumentData> implements PublicDocumentSnapshot<T>, Compat<ExpDocumentSnapshot<T>> {
158
+ private readonly _firestore;
159
+ readonly _delegate: ExpDocumentSnapshot<T>;
160
+ constructor(_firestore: Firestore, _delegate: ExpDocumentSnapshot<T>);
161
+ get ref(): DocumentReference<T>;
162
+ get id(): string;
163
+ get metadata(): SnapshotMetadata;
164
+ get exists(): boolean;
165
+ data(options?: PublicSnapshotOptions): T | undefined;
166
+ get(fieldPath: string | PublicFieldPath, options?: PublicSnapshotOptions): any;
167
+ isEqual(other: DocumentSnapshot<T>): boolean;
168
+ }
169
+ export declare class QueryDocumentSnapshot<T = PublicDocumentData> extends DocumentSnapshot<T> implements PublicQueryDocumentSnapshot<T> {
170
+ data(options?: PublicSnapshotOptions): T;
171
+ }
172
+ export declare class Query<T = PublicDocumentData> implements PublicQuery<T>, Compat<ExpQuery<T>> {
173
+ readonly firestore: Firestore;
174
+ readonly _delegate: ExpQuery<T>;
175
+ private readonly _userDataWriter;
176
+ constructor(firestore: Firestore, _delegate: ExpQuery<T>);
177
+ where(fieldPath: string | _FieldPath, opStr: PublicWhereFilterOp, value: unknown): Query<T>;
178
+ orderBy(fieldPath: string | _FieldPath, directionStr?: PublicOrderByDirection): Query<T>;
179
+ limit(n: number): Query<T>;
180
+ limitToLast(n: number): Query<T>;
181
+ startAt(...args: any[]): Query<T>;
182
+ startAfter(...args: any[]): Query<T>;
183
+ endBefore(...args: any[]): Query<T>;
184
+ endAt(...args: any[]): Query<T>;
185
+ isEqual(other: PublicQuery<T>): boolean;
186
+ get(options?: PublicGetOptions): Promise<QuerySnapshot<T>>;
187
+ onSnapshot(observer: PartialObserver<PublicQuerySnapshot<T>>): Unsubscribe;
188
+ onSnapshot(options: PublicSnapshotListenOptions, observer: PartialObserver<PublicQuerySnapshot<T>>): Unsubscribe;
189
+ onSnapshot(onNext: NextFn<PublicQuerySnapshot<T>>, onError?: ErrorFn, onCompletion?: CompleteFn): Unsubscribe;
190
+ onSnapshot(options: PublicSnapshotListenOptions, onNext: NextFn<PublicQuerySnapshot<T>>, onError?: ErrorFn, onCompletion?: CompleteFn): Unsubscribe;
191
+ withConverter(converter: null): Query<PublicDocumentData>;
192
+ withConverter<U>(converter: PublicFirestoreDataConverter<U>): Query<U>;
193
+ }
194
+ export declare class DocumentChange<T = PublicDocumentData> implements PublicDocumentChange<T>, Compat<ExpDocumentChange<T>> {
195
+ private readonly _firestore;
196
+ readonly _delegate: ExpDocumentChange<T>;
197
+ constructor(_firestore: Firestore, _delegate: ExpDocumentChange<T>);
198
+ get type(): PublicDocumentChangeType;
199
+ get doc(): QueryDocumentSnapshot<T>;
200
+ get oldIndex(): number;
201
+ get newIndex(): number;
202
+ }
203
+ export declare class QuerySnapshot<T = PublicDocumentData> implements PublicQuerySnapshot<T>, Compat<ExpQuerySnapshot<T>> {
204
+ readonly _firestore: Firestore;
205
+ readonly _delegate: ExpQuerySnapshot<T>;
206
+ constructor(_firestore: Firestore, _delegate: ExpQuerySnapshot<T>);
207
+ get query(): Query<T>;
208
+ get metadata(): SnapshotMetadata;
209
+ get size(): number;
210
+ get empty(): boolean;
211
+ get docs(): Array<QueryDocumentSnapshot<T>>;
212
+ docChanges(options?: PublicSnapshotListenOptions): Array<PublicDocumentChange<T>>;
213
+ forEach(callback: (result: QueryDocumentSnapshot<T>) => void, thisArg?: unknown): void;
214
+ isEqual(other: QuerySnapshot<T>): boolean;
215
+ }
216
+ export declare class CollectionReference<T = PublicDocumentData> extends Query<T> implements PublicCollectionReference<T> {
217
+ readonly firestore: Firestore;
218
+ readonly _delegate: ExpCollectionReference<T>;
219
+ constructor(firestore: Firestore, _delegate: ExpCollectionReference<T>);
220
+ get id(): string;
221
+ get path(): string;
222
+ get parent(): DocumentReference<PublicDocumentData> | null;
223
+ doc(documentPath?: string): DocumentReference<T>;
224
+ add(data: T): Promise<DocumentReference<T>>;
225
+ isEqual(other: CollectionReference<T>): boolean;
226
+ withConverter(converter: null): CollectionReference<PublicDocumentData>;
227
+ withConverter<U>(converter: PublicFirestoreDataConverter<U>): CollectionReference<U>;
228
+ }
@@ -1,36 +1,36 @@
1
- /**
2
- * @license
3
- * Copyright 2017 Google LLC
4
- *
5
- * Licensed under the Apache License, Version 2.0 (the "License");
6
- * you may not use this file except in compliance with the License.
7
- * You may obtain a copy of the License at
8
- *
9
- * http://www.apache.org/licenses/LICENSE-2.0
10
- *
11
- * Unless required by applicable law or agreed to in writing, software
12
- * distributed under the License is distributed on an "AS IS" BASIS,
13
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- * See the License for the specific language governing permissions and
15
- * limitations under the License.
16
- */
17
- import { FieldPath as ExpFieldPath } from '@firebase/firestore';
18
- import { FieldPath as PublicFieldPath } from '@firebase/firestore-types';
19
- import { Compat } from '@firebase/util';
20
- /**
21
- * A `FieldPath` refers to a field in a document. The path may consist of a
22
- * single field name (referring to a top-level field in the document), or a list
23
- * of field names (referring to a nested field in the document).
24
- */
25
- export declare class FieldPath implements PublicFieldPath, Compat<ExpFieldPath> {
26
- readonly _delegate: ExpFieldPath;
27
- /**
28
- * Creates a FieldPath from the provided field names. If more than one field
29
- * name is provided, the path will point to a nested field in a document.
30
- *
31
- * @param fieldNames - A list of field names.
32
- */
33
- constructor(...fieldNames: string[]);
34
- static documentId(): FieldPath;
35
- isEqual(other: PublicFieldPath): boolean;
36
- }
1
+ /**
2
+ * @license
3
+ * Copyright 2017 Google LLC
4
+ *
5
+ * Licensed under the Apache License, Version 2.0 (the "License");
6
+ * you may not use this file except in compliance with the License.
7
+ * You may obtain a copy of the License at
8
+ *
9
+ * http://www.apache.org/licenses/LICENSE-2.0
10
+ *
11
+ * Unless required by applicable law or agreed to in writing, software
12
+ * distributed under the License is distributed on an "AS IS" BASIS,
13
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ * See the License for the specific language governing permissions and
15
+ * limitations under the License.
16
+ */
17
+ import { FieldPath as ExpFieldPath } from '@firebase/firestore';
18
+ import { FieldPath as PublicFieldPath } from '@firebase/firestore-types';
19
+ import { Compat } from '@firebase/util';
20
+ /**
21
+ * A `FieldPath` refers to a field in a document. The path may consist of a
22
+ * single field name (referring to a top-level field in the document), or a list
23
+ * of field names (referring to a nested field in the document).
24
+ */
25
+ export declare class FieldPath implements PublicFieldPath, Compat<ExpFieldPath> {
26
+ readonly _delegate: ExpFieldPath;
27
+ /**
28
+ * Creates a FieldPath from the provided field names. If more than one field
29
+ * name is provided, the path will point to a nested field in a document.
30
+ *
31
+ * @param fieldNames - A list of field names.
32
+ */
33
+ constructor(...fieldNames: string[]);
34
+ static documentId(): FieldPath;
35
+ isEqual(other: PublicFieldPath): boolean;
36
+ }
@@ -1,29 +1,29 @@
1
- /**
2
- * @license
3
- * Copyright 2017 Google LLC
4
- *
5
- * Licensed under the Apache License, Version 2.0 (the "License");
6
- * you may not use this file except in compliance with the License.
7
- * You may obtain a copy of the License at
8
- *
9
- * http://www.apache.org/licenses/LICENSE-2.0
10
- *
11
- * Unless required by applicable law or agreed to in writing, software
12
- * distributed under the License is distributed on an "AS IS" BASIS,
13
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- * See the License for the specific language governing permissions and
15
- * limitations under the License.
16
- */
17
- import { FieldValue as FieldValue1 } from '@firebase/firestore';
18
- import { FieldValue as PublicFieldValue } from '@firebase/firestore-types';
19
- import { Compat } from '@firebase/util';
20
- export declare class FieldValue implements PublicFieldValue, Compat<FieldValue1> {
21
- readonly _delegate: FieldValue1;
22
- static serverTimestamp(): FieldValue;
23
- static delete(): FieldValue;
24
- static arrayUnion(...elements: unknown[]): FieldValue;
25
- static arrayRemove(...elements: unknown[]): FieldValue;
26
- static increment(n: number): FieldValue;
27
- constructor(_delegate: FieldValue1);
28
- isEqual(other: FieldValue): boolean;
29
- }
1
+ /**
2
+ * @license
3
+ * Copyright 2017 Google LLC
4
+ *
5
+ * Licensed under the Apache License, Version 2.0 (the "License");
6
+ * you may not use this file except in compliance with the License.
7
+ * You may obtain a copy of the License at
8
+ *
9
+ * http://www.apache.org/licenses/LICENSE-2.0
10
+ *
11
+ * Unless required by applicable law or agreed to in writing, software
12
+ * distributed under the License is distributed on an "AS IS" BASIS,
13
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ * See the License for the specific language governing permissions and
15
+ * limitations under the License.
16
+ */
17
+ import { FieldValue as FieldValue1 } from '@firebase/firestore';
18
+ import { FieldValue as PublicFieldValue } from '@firebase/firestore-types';
19
+ import { Compat } from '@firebase/util';
20
+ export declare class FieldValue implements PublicFieldValue, Compat<FieldValue1> {
21
+ readonly _delegate: FieldValue1;
22
+ static serverTimestamp(): FieldValue;
23
+ static delete(): FieldValue;
24
+ static arrayUnion(...elements: unknown[]): FieldValue;
25
+ static arrayRemove(...elements: unknown[]): FieldValue;
26
+ static increment(n: number): FieldValue;
27
+ constructor(_delegate: FieldValue1);
28
+ isEqual(other: FieldValue): boolean;
29
+ }
@@ -1,17 +1,17 @@
1
- /**
2
- * @license
3
- * Copyright 2017 Google LLC
4
- *
5
- * Licensed under the Apache License, Version 2.0 (the "License");
6
- * you may not use this file except in compliance with the License.
7
- * You may obtain a copy of the License at
8
- *
9
- * http://www.apache.org/licenses/LICENSE-2.0
10
- *
11
- * Unless required by applicable law or agreed to in writing, software
12
- * distributed under the License is distributed on an "AS IS" BASIS,
13
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- * See the License for the specific language governing permissions and
15
- * limitations under the License.
16
- */
17
- export { GeoPoint } from '@firebase/firestore';
1
+ /**
2
+ * @license
3
+ * Copyright 2017 Google LLC
4
+ *
5
+ * Licensed under the Apache License, Version 2.0 (the "License");
6
+ * you may not use this file except in compliance with the License.
7
+ * You may obtain a copy of the License at
8
+ *
9
+ * http://www.apache.org/licenses/LICENSE-2.0
10
+ *
11
+ * Unless required by applicable law or agreed to in writing, software
12
+ * distributed under the License is distributed on an "AS IS" BASIS,
13
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ * See the License for the specific language governing permissions and
15
+ * limitations under the License.
16
+ */
17
+ export { GeoPoint } from '@firebase/firestore';