@firebase/data-connect 0.0.2-dataconnect-preview.877f8b7d0 → 0.0.2-dataconnect-preview.388b61c7e

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.
@@ -17,28 +17,78 @@
17
17
  import { DataConnectError } from '../core/error';
18
18
  import { DataConnect } from './DataConnect';
19
19
  import { OperationRef, QUERY_STR, DataConnectResult, SerializedRef } from './Reference';
20
+ /**
21
+ * Signature for `OnResultSubscription` for `subscribe`
22
+ */
20
23
  export declare type OnResultSubscription<Data, Variables> = (res: QueryResult<Data, Variables>) => void;
24
+ /**
25
+ * Signature for `OnErrorSubscription` for `subscribe`
26
+ */
21
27
  export declare type OnErrorSubscription = (err?: DataConnectError) => void;
28
+ /**
29
+ * Signature for unsubscribe from `subscribe`
30
+ */
22
31
  export declare type QueryUnsubscribe = () => void;
32
+ /**
33
+ * Representation of user provided subscription options.
34
+ */
23
35
  export interface DataConnectSubscription<Data, Variables> {
24
36
  userCallback: OnResultSubscription<Data, Variables>;
25
37
  errCallback?: (e?: DataConnectError) => void;
26
38
  unsubscribe: () => void;
27
39
  }
40
+ /**
41
+ * QueryRef object
42
+ */
28
43
  export interface QueryRef<Data, Variables> extends OperationRef<Data, Variables> {
29
44
  refType: typeof QUERY_STR;
30
45
  }
46
+ /**
47
+ * Result of `executeQuery`
48
+ */
31
49
  export interface QueryResult<Data, Variables> extends DataConnectResult<Data, Variables> {
32
50
  ref: QueryRef<Data, Variables>;
33
51
  toJSON: () => SerializedRef<Data, Variables>;
34
52
  }
53
+ /**
54
+ * Promise returned from `executeQuery`
55
+ */
35
56
  export interface QueryPromise<Data, Variables> extends PromiseLike<QueryResult<Data, Variables>> {
36
57
  }
58
+ /**
59
+ * Execute Query
60
+ * @param queryRef query to execute.
61
+ * @returns `QueryPromise`
62
+ */
37
63
  export declare function executeQuery<Data, Variables>(queryRef: QueryRef<Data, Variables>): QueryPromise<Data, Variables>;
64
+ /**
65
+ * Execute Query
66
+ * @param dcInstance Data Connect instance to use.
67
+ * @param queryName Query to execute
68
+ * @returns `QueryRef`
69
+ */
38
70
  export declare function queryRef<Data>(dcInstance: DataConnect, queryName: string): QueryRef<Data, undefined>;
71
+ /**
72
+ * Execute Query
73
+ * @param dcInstance Data Connect instance to use.
74
+ * @param queryName Query to execute
75
+ * @param variables Variables to execute with
76
+ * @returns `QueryRef`
77
+ */
39
78
  export declare function queryRef<Data, Variables>(dcInstance: DataConnect, queryName: string, variables: Variables): QueryRef<Data, Variables>;
79
+ /**
80
+ * Converts serialized ref to query ref
81
+ * @param serializedRef ref to convert to `QueryRef`
82
+ * @returns `QueryRef`
83
+ */
40
84
  export declare function toQueryRef<Data, Variables>(serializedRef: SerializedRef<Data, Variables>): QueryRef<unknown, Variables>;
85
+ /**
86
+ * `OnCompleteSubscription`
87
+ */
41
88
  export declare type OnCompleteSubscription = () => void;
89
+ /**
90
+ * Representation of full observer options in `subscribe`
91
+ */
42
92
  export interface SubscriptionOptions<Data, Variables> {
43
93
  onNext?: OnResultSubscription<Data, Variables>;
44
94
  onErr?: OnErrorSubscription;
@@ -17,13 +17,18 @@
17
17
  import { OnCompleteSubscription, OnErrorSubscription, OnResultSubscription, QueryRef, QueryUnsubscribe, SubscriptionOptions } from './api/query';
18
18
  import { SerializedRef } from './api/Reference';
19
19
  /**
20
- *
21
- * @public
22
- * @param queryRef
23
- * @param onResult
24
- * @param onErr
25
- * @param initialCache
26
- * @returns
20
+ * Subscribe to a `QueryRef`
21
+ * @param queryRefOrSerializedResult query ref or serialized result.
22
+ * @param observer observer object to use for subscribing.
23
+ * @returns `SubscriptionOptions`
27
24
  */
28
25
  export declare function subscribe<Data, Variables>(queryRefOrSerializedResult: QueryRef<Data, Variables> | SerializedRef<Data, Variables>, observer: SubscriptionOptions<Data, Variables>): QueryUnsubscribe;
26
+ /**
27
+ * Subscribe to a `QueryRef`
28
+ * @param queryRefOrSerializedResult query ref or serialized result.
29
+ * @param onNext Callback to call when result comes back.
30
+ * @param onError Callback to call when error gets thrown.
31
+ * @param onComplete Called when subscription completes.
32
+ * @returns `SubscriptionOptions`
33
+ */
29
34
  export declare function subscribe<Data, Variables>(queryRefOrSerializedResult: QueryRef<Data, Variables> | SerializedRef<Data, Variables>, onNext: OnResultSubscription<Data, Variables>, onError?: OnErrorSubscription, onComplete?: OnCompleteSubscription): QueryUnsubscribe;
package/dist/private.d.ts CHANGED
@@ -25,14 +25,27 @@ export declare interface CancellableOperation<T> extends PromiseLike<{
25
25
  cancel: () => void;
26
26
  }
27
27
 
28
+ /**
29
+ * Connect to the DataConnect Emulator
30
+ * @param dc Data Connect instance
31
+ * @param host host of emulator server
32
+ * @param port port of emulator server
33
+ * @param sslEnabled use https
34
+ */
28
35
  export declare function connectDataConnectEmulator(dc: DataConnect, host: string, port?: number, sslEnabled?: boolean): void;
29
36
 
37
+ /**
38
+ * Connector Config for calling Data Connect backend.
39
+ */
30
40
  export declare interface ConnectorConfig {
31
41
  location: string;
32
42
  connector: string;
33
43
  service: string;
34
44
  }
35
45
 
46
+ /**
47
+ * Class representing Firebase Data Connect
48
+ */
36
49
  export declare class DataConnect {
37
50
  readonly app: FirebaseApp;
38
51
  private readonly dataConnectOptions;
@@ -78,6 +91,9 @@ declare class DataConnectError extends FirebaseError {
78
91
 
79
92
  declare type DataConnectErrorCode = 'other' | 'already-initialized' | 'not-initialized' | 'not-supported' | 'invalid-argument' | 'partial-error';
80
93
 
94
+ /**
95
+ * DataConnectOptions including project id
96
+ */
81
97
  export declare interface DataConnectOptions extends ConnectorConfig {
82
98
  projectId: string;
83
99
  }
@@ -86,6 +102,9 @@ export declare interface DataConnectResult<Data, Variables> extends OpResult<Dat
86
102
  ref: OperationRef<Data, Variables>;
87
103
  }
88
104
 
105
+ /**
106
+ * Representation of user provided subscription options.
107
+ */
89
108
  export declare interface DataConnectSubscription<Data, Variables> {
90
109
  userCallback: OnResultSubscription<Data, Variables>;
91
110
  errCallback?: (e?: DataConnectError) => void;
@@ -107,8 +126,18 @@ export declare interface DataConnectTransport {
107
126
 
108
127
  export declare type DataSource = typeof SOURCE_CACHE | typeof SOURCE_SERVER;
109
128
 
129
+ /**
130
+ * Execute Mutation
131
+ * @param mutationRef mutation to execute
132
+ * @returns `MutationRef`
133
+ */
110
134
  export declare function executeMutation<Data, Variables>(mutationRef: MutationRef<Data, Variables>): MutationPromise<Data, Variables>;
111
135
 
136
+ /**
137
+ * Execute Query
138
+ * @param queryRef query to execute.
139
+ * @returns `QueryPromise`
140
+ */
112
141
  export declare function executeQuery<Data, Variables>(queryRef: QueryRef<Data, Variables>): QueryPromise<Data, Variables>;
113
142
 
114
143
  export declare const FIREBASE_DATA_CONNECT_EMULATOR_HOST_VAR = "FIREBASE_DATA_CONNECT_EMULATOR_HOST";
@@ -124,19 +153,26 @@ export declare class FirebaseAuthProvider implements AuthTokenProvider {
124
153
  removeTokenChangeListener(listener: (token: string | null) => void): void;
125
154
  }
126
155
 
156
+ /**
157
+ * Initialize DataConnect instance
158
+ * @param options ConnectorConfig
159
+ */
127
160
  export declare function getDataConnect(options: ConnectorConfig): DataConnect;
128
161
 
162
+ /**
163
+ * Initialize DataConnect instance
164
+ * @param app FirebaseApp to initialize to.
165
+ * @param options ConnectorConfig
166
+ */
129
167
  export declare function getDataConnect(app: FirebaseApp, options: ConnectorConfig): DataConnect;
130
168
 
131
169
  export declare const MUTATION_STR = "mutation";
132
170
 
133
- export declare class MutationManager {
134
- private _transport;
135
- private _inflight;
136
- constructor(_transport: DataConnectTransport);
137
- executeMutation<Data, Variables>(mutationRef: MutationRef<Data, Variables>): MutationPromise<Data, Variables>;
138
- }
171
+ /* Excluded from this release type: MutationManager */
139
172
 
173
+ /**
174
+ * Mutation return value from `executeMutation`
175
+ */
140
176
  export declare interface MutationPromise<Data, Variables> extends PromiseLike<MutationResult<Data, Variables>> {
141
177
  }
142
178
 
@@ -144,21 +180,44 @@ export declare interface MutationRef<Data, Variables> extends OperationRef<Data,
144
180
  refType: typeof MUTATION_STR;
145
181
  }
146
182
 
147
- export declare function mutationRef<Data>(dcInstance: DataConnect, queryName: string): MutationRef<Data, undefined>;
183
+ /**
184
+ * Creates a `MutationRef`
185
+ * @param dcInstance Data Connect instance
186
+ * @param mutationName name of mutation
187
+ */
188
+ export declare function mutationRef<Data>(dcInstance: DataConnect, mutationName: string): MutationRef<Data, undefined>;
148
189
 
190
+ /**
191
+ *
192
+ * @param dcInstance Data Connect instance
193
+ * @param mutationName name of mutation
194
+ * @param variables variables to send with mutation
195
+ */
149
196
  export declare function mutationRef<Data, Variables>(dcInstance: DataConnect, mutationName: string, variables: Variables): MutationRef<Data, Variables>;
150
197
 
151
198
  export declare interface MutationResponse<T> extends CancellableOperation<T> {
152
199
  }
153
200
 
201
+ /**
202
+ * Mutation Result from `executeMutation`
203
+ */
154
204
  export declare interface MutationResult<Data, Variables> extends DataConnectResult<Data, Variables> {
155
205
  ref: MutationRef<Data, Variables>;
156
206
  }
157
207
 
208
+ /**
209
+ * `OnCompleteSubscription`
210
+ */
158
211
  export declare type OnCompleteSubscription = () => void;
159
212
 
213
+ /**
214
+ * Signature for `OnErrorSubscription` for `subscribe`
215
+ */
160
216
  export declare type OnErrorSubscription = (err?: DataConnectError) => void;
161
217
 
218
+ /**
219
+ * Signature for `OnResultSubscription` for `subscribe`
220
+ */
162
221
  export declare type OnResultSubscription<Data, Variables> = (res: QueryResult<Data, Variables>) => void;
163
222
 
164
223
  export declare interface OperationRef<_Data, Variables> {
@@ -188,29 +247,57 @@ declare class QueryManager {
188
247
  enableEmulator(host: string, port: number): void;
189
248
  }
190
249
 
250
+ /**
251
+ * Promise returned from `executeQuery`
252
+ */
191
253
  export declare interface QueryPromise<Data, Variables> extends PromiseLike<QueryResult<Data, Variables>> {
192
254
  }
193
255
 
256
+ /**
257
+ * QueryRef object
258
+ */
194
259
  export declare interface QueryRef<Data, Variables> extends OperationRef<Data, Variables> {
195
260
  refType: typeof QUERY_STR;
196
261
  }
197
262
 
263
+ /**
264
+ * Execute Query
265
+ * @param dcInstance Data Connect instance to use.
266
+ * @param queryName Query to execute
267
+ * @returns `QueryRef`
268
+ */
198
269
  export declare function queryRef<Data>(dcInstance: DataConnect, queryName: string): QueryRef<Data, undefined>;
199
270
 
271
+ /**
272
+ * Execute Query
273
+ * @param dcInstance Data Connect instance to use.
274
+ * @param queryName Query to execute
275
+ * @param variables Variables to execute with
276
+ * @returns `QueryRef`
277
+ */
200
278
  export declare function queryRef<Data, Variables>(dcInstance: DataConnect, queryName: string, variables: Variables): QueryRef<Data, Variables>;
201
279
 
202
280
  export declare interface QueryResponse<T> extends CancellableOperation<T> {
203
281
  }
204
282
 
283
+ /**
284
+ * Result of `executeQuery`
285
+ */
205
286
  export declare interface QueryResult<Data, Variables> extends DataConnectResult<Data, Variables> {
206
287
  ref: QueryRef<Data, Variables>;
207
288
  toJSON: () => SerializedRef<Data, Variables>;
208
289
  }
209
290
 
291
+ /**
292
+ * Signature for unsubscribe from `subscribe`
293
+ */
210
294
  export declare type QueryUnsubscribe = () => void;
211
295
 
212
296
  export declare type ReferenceType = typeof QUERY_STR | typeof MUTATION_STR;
213
297
 
298
+ /**
299
+ * Serialized RefInfo as a result of `QueryResult.toJSON().refInfo`
300
+ */
214
301
  export declare interface RefInfo<Variables> {
215
302
  name: string;
216
303
  variables: Variables;
@@ -222,6 +309,9 @@ export declare interface Sender<T> {
222
309
  send: () => Promise<T>;
223
310
  }
224
311
 
312
+ /**
313
+ * Serialized Ref as a result of `QueryResult.toJSON()`
314
+ */
225
315
  export declare interface SerializedRef<Data, Variables> extends OpResult<Data> {
226
316
  refInfo: RefInfo<Variables>;
227
317
  }
@@ -233,26 +323,44 @@ export declare const SOURCE_CACHE = "CACHE";
233
323
  export declare const SOURCE_SERVER = "SERVER";
234
324
 
235
325
  /**
236
- *
237
- * @public
238
- * @param queryRef
239
- * @param onResult
240
- * @param onErr
241
- * @param initialCache
242
- * @returns
326
+ * Subscribe to a `QueryRef`
327
+ * @param queryRefOrSerializedResult query ref or serialized result.
328
+ * @param observer observer object to use for subscribing.
329
+ * @returns `SubscriptionOptions`
243
330
  */
244
331
  export declare function subscribe<Data, Variables>(queryRefOrSerializedResult: QueryRef<Data, Variables> | SerializedRef<Data, Variables>, observer: SubscriptionOptions<Data, Variables>): QueryUnsubscribe;
245
332
 
333
+ /**
334
+ * Subscribe to a `QueryRef`
335
+ * @param queryRefOrSerializedResult query ref or serialized result.
336
+ * @param onNext Callback to call when result comes back.
337
+ * @param onError Callback to call when error gets thrown.
338
+ * @param onComplete Called when subscription completes.
339
+ * @returns `SubscriptionOptions`
340
+ */
246
341
  export declare function subscribe<Data, Variables>(queryRefOrSerializedResult: QueryRef<Data, Variables> | SerializedRef<Data, Variables>, onNext: OnResultSubscription<Data, Variables>, onError?: OnErrorSubscription, onComplete?: OnCompleteSubscription): QueryUnsubscribe;
247
342
 
343
+ /**
344
+ * Representation of full observer options in `subscribe`
345
+ */
248
346
  export declare interface SubscriptionOptions<Data, Variables> {
249
347
  onNext?: OnResultSubscription<Data, Variables>;
250
348
  onErr?: OnErrorSubscription;
251
349
  onComplete?: OnCompleteSubscription;
252
350
  }
253
351
 
352
+ /**
353
+ * Delete DataConnect instance
354
+ * @param dataConnect DataConnect instance
355
+ * @returns
356
+ */
254
357
  export declare function terminate(dataConnect: DataConnect): Promise<void>;
255
358
 
359
+ /**
360
+ * Converts serialized ref to query ref
361
+ * @param serializedRef ref to convert to `QueryRef`
362
+ * @returns `QueryRef`
363
+ */
256
364
  export declare function toQueryRef<Data, Variables>(serializedRef: SerializedRef<Data, Variables>): QueryRef<unknown, Variables>;
257
365
 
258
366
  declare interface TrackedQuery<Data, Variables> {
@@ -264,6 +372,9 @@ declare interface TrackedQuery<Data, Variables> {
264
372
 
265
373
  export declare type TransportClass = new (options: DataConnectOptions, apiKey?: string, authProvider?: AuthTokenProvider, transportOptions?: TransportOptions) => DataConnectTransport;
266
374
 
375
+ /**
376
+ * Options to connect to emulator
377
+ */
267
378
  export declare interface TransportOptions {
268
379
  host: string;
269
380
  sslEnabled?: boolean;
package/dist/public.d.ts CHANGED
@@ -21,12 +21,25 @@ export declare interface CancellableOperation<T> extends PromiseLike<{
21
21
  }> {
22
22
  cancel: () => void;
23
23
  }
24
+ /**
25
+ * Connect to the DataConnect Emulator
26
+ * @param dc Data Connect instance
27
+ * @param host host of emulator server
28
+ * @param port port of emulator server
29
+ * @param sslEnabled use https
30
+ */
24
31
  export declare function connectDataConnectEmulator(dc: DataConnect, host: string, port?: number, sslEnabled?: boolean): void;
32
+ /**
33
+ * Connector Config for calling Data Connect backend.
34
+ */
25
35
  export declare interface ConnectorConfig {
26
36
  location: string;
27
37
  connector: string;
28
38
  service: string;
29
39
  }
40
+ /**
41
+ * Class representing Firebase Data Connect
42
+ */
30
43
  export declare class DataConnect {
31
44
  readonly app: FirebaseApp;
32
45
  private readonly dataConnectOptions;
@@ -37,12 +50,18 @@ export declare class DataConnect {
37
50
  setInitialized(): void;
38
51
  enableEmulator(transportOptions: TransportOptions): void;
39
52
  }
53
+ /**
54
+ * DataConnectOptions including project id
55
+ */
40
56
  export declare interface DataConnectOptions extends ConnectorConfig {
41
57
  projectId: string;
42
58
  }
43
59
  export declare interface DataConnectResult<Data, Variables> extends OpResult<Data> {
44
60
  ref: OperationRef<Data, Variables>;
45
61
  }
62
+ /**
63
+ * Representation of user provided subscription options.
64
+ */
46
65
  export declare interface DataConnectSubscription<Data, Variables> {
47
66
  userCallback: OnResultSubscription<Data, Variables>;
48
67
  errCallback?: (e?: FirebaseError) => void;
@@ -61,7 +80,17 @@ export declare interface DataConnectTransport {
61
80
  onTokenChanged: (token: string | null) => void;
62
81
  }
63
82
  export declare type DataSource = typeof SOURCE_CACHE | typeof SOURCE_SERVER;
83
+ /**
84
+ * Execute Mutation
85
+ * @param mutationRef mutation to execute
86
+ * @returns `MutationRef`
87
+ */
64
88
  export declare function executeMutation<Data, Variables>(mutationRef: MutationRef<Data, Variables>): MutationPromise<Data, Variables>;
89
+ /**
90
+ * Execute Query
91
+ * @param queryRef query to execute.
92
+ * @returns `QueryPromise`
93
+ */
65
94
  export declare function executeQuery<Data, Variables>(queryRef: QueryRef<Data, Variables>): QueryPromise<Data, Variables>;
66
95
  export declare const FIREBASE_DATA_CONNECT_EMULATOR_HOST_VAR = "FIREBASE_DATA_CONNECT_EMULATOR_HOST";
67
96
  export declare class FirebaseAuthProvider implements AuthTokenProvider {
@@ -70,27 +99,59 @@ export declare class FirebaseAuthProvider implements AuthTokenProvider {
70
99
  addTokenChangeListener(listener: AuthTokenListener): void;
71
100
  removeTokenChangeListener(listener: (token: string | null) => void): void;
72
101
  }
102
+ /**
103
+ * Initialize DataConnect instance
104
+ * @param options ConnectorConfig
105
+ */
73
106
  export declare function getDataConnect(options: ConnectorConfig): DataConnect;
107
+ /**
108
+ * Initialize DataConnect instance
109
+ * @param app FirebaseApp to initialize to.
110
+ * @param options ConnectorConfig
111
+ */
74
112
  export declare function getDataConnect(app: FirebaseApp, options: ConnectorConfig): DataConnect;
75
113
  export declare const MUTATION_STR = "mutation";
76
- export declare class MutationManager {
77
- constructor(_transport: DataConnectTransport);
78
- executeMutation<Data, Variables>(mutationRef: MutationRef<Data, Variables>): MutationPromise<Data, Variables>;
79
- }
114
+ /* Excluded from this release type: MutationManager */
115
+ /**
116
+ * Mutation return value from `executeMutation`
117
+ */
80
118
  export declare interface MutationPromise<Data, Variables> extends PromiseLike<MutationResult<Data, Variables>> {
81
119
  }
82
120
  export declare interface MutationRef<Data, Variables> extends OperationRef<Data, Variables> {
83
121
  refType: typeof MUTATION_STR;
84
122
  }
85
- export declare function mutationRef<Data>(dcInstance: DataConnect, queryName: string): MutationRef<Data, undefined>;
123
+ /**
124
+ * Creates a `MutationRef`
125
+ * @param dcInstance Data Connect instance
126
+ * @param mutationName name of mutation
127
+ */
128
+ export declare function mutationRef<Data>(dcInstance: DataConnect, mutationName: string): MutationRef<Data, undefined>;
129
+ /**
130
+ *
131
+ * @param dcInstance Data Connect instance
132
+ * @param mutationName name of mutation
133
+ * @param variables variables to send with mutation
134
+ */
86
135
  export declare function mutationRef<Data, Variables>(dcInstance: DataConnect, mutationName: string, variables: Variables): MutationRef<Data, Variables>;
87
136
  export declare interface MutationResponse<T> extends CancellableOperation<T> {
88
137
  }
138
+ /**
139
+ * Mutation Result from `executeMutation`
140
+ */
89
141
  export declare interface MutationResult<Data, Variables> extends DataConnectResult<Data, Variables> {
90
142
  ref: MutationRef<Data, Variables>;
91
143
  }
144
+ /**
145
+ * `OnCompleteSubscription`
146
+ */
92
147
  export declare type OnCompleteSubscription = () => void;
148
+ /**
149
+ * Signature for `OnErrorSubscription` for `subscribe`
150
+ */
93
151
  export declare type OnErrorSubscription = (err?: FirebaseError) => void;
152
+ /**
153
+ * Signature for `OnResultSubscription` for `subscribe`
154
+ */
94
155
  export declare type OnResultSubscription<Data, Variables> = (res: QueryResult<Data, Variables>) => void;
95
156
  export declare interface OperationRef<_Data, Variables> {
96
157
  name: string;
@@ -105,21 +166,49 @@ export declare interface OpResult<Data> {
105
166
  }
106
167
  /* Excluded from this release type: parseOptions */
107
168
  export declare const QUERY_STR = "query";
169
+ /**
170
+ * Promise returned from `executeQuery`
171
+ */
108
172
  export declare interface QueryPromise<Data, Variables> extends PromiseLike<QueryResult<Data, Variables>> {
109
173
  }
174
+ /**
175
+ * QueryRef object
176
+ */
110
177
  export declare interface QueryRef<Data, Variables> extends OperationRef<Data, Variables> {
111
178
  refType: typeof QUERY_STR;
112
179
  }
180
+ /**
181
+ * Execute Query
182
+ * @param dcInstance Data Connect instance to use.
183
+ * @param queryName Query to execute
184
+ * @returns `QueryRef`
185
+ */
113
186
  export declare function queryRef<Data>(dcInstance: DataConnect, queryName: string): QueryRef<Data, undefined>;
187
+ /**
188
+ * Execute Query
189
+ * @param dcInstance Data Connect instance to use.
190
+ * @param queryName Query to execute
191
+ * @param variables Variables to execute with
192
+ * @returns `QueryRef`
193
+ */
114
194
  export declare function queryRef<Data, Variables>(dcInstance: DataConnect, queryName: string, variables: Variables): QueryRef<Data, Variables>;
115
195
  export declare interface QueryResponse<T> extends CancellableOperation<T> {
116
196
  }
197
+ /**
198
+ * Result of `executeQuery`
199
+ */
117
200
  export declare interface QueryResult<Data, Variables> extends DataConnectResult<Data, Variables> {
118
201
  ref: QueryRef<Data, Variables>;
119
202
  toJSON: () => SerializedRef<Data, Variables>;
120
203
  }
204
+ /**
205
+ * Signature for unsubscribe from `subscribe`
206
+ */
121
207
  export declare type QueryUnsubscribe = () => void;
122
208
  export declare type ReferenceType = typeof QUERY_STR | typeof MUTATION_STR;
209
+ /**
210
+ * Serialized RefInfo as a result of `QueryResult.toJSON().refInfo`
211
+ */
123
212
  export declare interface RefInfo<Variables> {
124
213
  name: string;
125
214
  variables: Variables;
@@ -129,6 +218,9 @@ export declare interface Sender<T> {
129
218
  abort: () => void;
130
219
  send: () => Promise<T>;
131
220
  }
221
+ /**
222
+ * Serialized Ref as a result of `QueryResult.toJSON()`
223
+ */
132
224
  export declare interface SerializedRef<Data, Variables> extends OpResult<Data> {
133
225
  refInfo: RefInfo<Variables>;
134
226
  }
@@ -136,24 +228,45 @@ export declare function setLogLevel(logLevel: LogLevelString): void;
136
228
  export declare const SOURCE_CACHE = "CACHE";
137
229
  export declare const SOURCE_SERVER = "SERVER";
138
230
  /**
139
- *
140
- * @public
141
- * @param queryRef
142
- * @param onResult
143
- * @param onErr
144
- * @param initialCache
145
- * @returns
231
+ * Subscribe to a `QueryRef`
232
+ * @param queryRefOrSerializedResult query ref or serialized result.
233
+ * @param observer observer object to use for subscribing.
234
+ * @returns `SubscriptionOptions`
146
235
  */
147
236
  export declare function subscribe<Data, Variables>(queryRefOrSerializedResult: QueryRef<Data, Variables> | SerializedRef<Data, Variables>, observer: SubscriptionOptions<Data, Variables>): QueryUnsubscribe;
237
+ /**
238
+ * Subscribe to a `QueryRef`
239
+ * @param queryRefOrSerializedResult query ref or serialized result.
240
+ * @param onNext Callback to call when result comes back.
241
+ * @param onError Callback to call when error gets thrown.
242
+ * @param onComplete Called when subscription completes.
243
+ * @returns `SubscriptionOptions`
244
+ */
148
245
  export declare function subscribe<Data, Variables>(queryRefOrSerializedResult: QueryRef<Data, Variables> | SerializedRef<Data, Variables>, onNext: OnResultSubscription<Data, Variables>, onError?: OnErrorSubscription, onComplete?: OnCompleteSubscription): QueryUnsubscribe;
246
+ /**
247
+ * Representation of full observer options in `subscribe`
248
+ */
149
249
  export declare interface SubscriptionOptions<Data, Variables> {
150
250
  onNext?: OnResultSubscription<Data, Variables>;
151
251
  onErr?: OnErrorSubscription;
152
252
  onComplete?: OnCompleteSubscription;
153
253
  }
254
+ /**
255
+ * Delete DataConnect instance
256
+ * @param dataConnect DataConnect instance
257
+ * @returns
258
+ */
154
259
  export declare function terminate(dataConnect: DataConnect): Promise<void>;
260
+ /**
261
+ * Converts serialized ref to query ref
262
+ * @param serializedRef ref to convert to `QueryRef`
263
+ * @returns `QueryRef`
264
+ */
155
265
  export declare function toQueryRef<Data, Variables>(serializedRef: SerializedRef<Data, Variables>): QueryRef<unknown, Variables>;
156
266
  export declare type TransportClass = new (options: DataConnectOptions, apiKey?: string, authProvider?: AuthTokenProvider, transportOptions?: TransportOptions) => DataConnectTransport;
267
+ /**
268
+ * Options to connect to emulator
269
+ */
157
270
  export declare interface TransportOptions {
158
271
  host: string;
159
272
  sslEnabled?: boolean;
@@ -19,11 +19,17 @@ import { FirebaseAuthInternalName } from '@firebase/auth-interop-types';
19
19
  import { Provider } from '@firebase/component';
20
20
  import { QueryManager } from '../core/QueryManager';
21
21
  import { MutationManager } from './Mutation';
22
+ /**
23
+ * Connector Config for calling Data Connect backend.
24
+ */
22
25
  export interface ConnectorConfig {
23
26
  location: string;
24
27
  connector: string;
25
28
  service: string;
26
29
  }
30
+ /**
31
+ * Options to connect to emulator
32
+ */
27
33
  export interface TransportOptions {
28
34
  host: string;
29
35
  sslEnabled?: boolean;
@@ -37,9 +43,15 @@ export declare const FIREBASE_DATA_CONNECT_EMULATOR_HOST_VAR = "FIREBASE_DATA_CO
37
43
  * @internal
38
44
  */
39
45
  export declare function parseOptions(fullHost: string): TransportOptions;
46
+ /**
47
+ * DataConnectOptions including project id
48
+ */
40
49
  export interface DataConnectOptions extends ConnectorConfig {
41
50
  projectId: string;
42
51
  }
52
+ /**
53
+ * Class representing Firebase Data Connect
54
+ */
43
55
  export declare class DataConnect {
44
56
  readonly app: FirebaseApp;
45
57
  private readonly dataConnectOptions;
@@ -58,7 +70,28 @@ export declare class DataConnect {
58
70
  setInitialized(): void;
59
71
  enableEmulator(transportOptions: TransportOptions): void;
60
72
  }
73
+ /**
74
+ * Connect to the DataConnect Emulator
75
+ * @param dc Data Connect instance
76
+ * @param host host of emulator server
77
+ * @param port port of emulator server
78
+ * @param sslEnabled use https
79
+ */
61
80
  export declare function connectDataConnectEmulator(dc: DataConnect, host: string, port?: number, sslEnabled?: boolean): void;
81
+ /**
82
+ * Initialize DataConnect instance
83
+ * @param options ConnectorConfig
84
+ */
62
85
  export declare function getDataConnect(options: ConnectorConfig): DataConnect;
86
+ /**
87
+ * Initialize DataConnect instance
88
+ * @param app FirebaseApp to initialize to.
89
+ * @param options ConnectorConfig
90
+ */
63
91
  export declare function getDataConnect(app: FirebaseApp, options: ConnectorConfig): DataConnect;
92
+ /**
93
+ * Delete DataConnect instance
94
+ * @param dataConnect DataConnect instance
95
+ * @returns
96
+ */
64
97
  export declare function terminate(dataConnect: DataConnect): Promise<void>;