@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.
- package/dist/index.cjs.js +59 -3
- package/dist/index.cjs.js.map +1 -1
- package/dist/index.esm2017.js +59 -3
- package/dist/index.esm2017.js.map +1 -1
- package/dist/index.esm5.js +59 -3
- package/dist/index.esm5.js.map +1 -1
- package/dist/index.node.cjs.js +59 -3
- package/dist/index.node.cjs.js.map +1 -1
- package/dist/internal.d.ts +127 -8
- package/dist/node-esm/index.node.esm.js +59 -3
- package/dist/node-esm/index.node.esm.js.map +1 -1
- package/dist/node-esm/src/api/DataConnect.d.ts +33 -0
- package/dist/node-esm/src/api/Mutation.d.ts +26 -1
- package/dist/node-esm/src/api/Reference.d.ts +6 -0
- package/dist/node-esm/src/api/query.d.ts +50 -0
- package/dist/node-esm/src/api.browser.d.ts +12 -7
- package/dist/private.d.ts +125 -14
- package/dist/public.d.ts +125 -12
- package/dist/src/api/DataConnect.d.ts +33 -0
- package/dist/src/api/Mutation.d.ts +26 -1
- package/dist/src/api/Reference.d.ts +6 -0
- package/dist/src/api/query.d.ts +50 -0
- package/dist/src/api.browser.d.ts +12 -7
- package/package.json +6 -6
|
@@ -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
|
-
* @
|
|
22
|
-
* @param
|
|
23
|
-
* @
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
* @
|
|
238
|
-
* @param
|
|
239
|
-
* @
|
|
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
|
-
|
|
77
|
-
|
|
78
|
-
|
|
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
|
-
|
|
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
|
-
* @
|
|
141
|
-
* @param
|
|
142
|
-
* @
|
|
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>;
|