feat(dc): Add executeQuery and executeMutation APIs to Data Connect

etc/firebase-admin.data-connect.api.md

@@ -13,6 +13,7 @@ export type AuthClaims = Partial<DecodedIdToken>;
 
 // @public
 export interface ConnectorConfig {
+    connector?: string;
     location: string;
     serviceId: string;
 }
@@ -29,6 +30,10 @@ export class DataConnect {
     executeGraphqlRead<GraphqlResponse, Variables>(query: string, options?: GraphqlOptions<Variables>): Promise<ExecuteGraphqlResponse<GraphqlResponse>>;
     insert<GraphQlResponse, Variables extends object>(tableName: string, variables: Variables): Promise<ExecuteGraphqlResponse<GraphQlResponse>>;
     insertMany<GraphQlResponse, Variables extends Array<unknown>>(tableName: string, variables: Variables): Promise<ExecuteGraphqlResponse<GraphQlResponse>>;
+    mutationRef<Data>(name: string, options?: RefOptions): MutationRef<Data, undefined>;
+    mutationRef<Data, Variables>(name: string, variables: Variables, options?: RefOptions): MutationRef<Data, Variables>;
+    queryRef<Data>(name: string, options?: RefOptions): QueryRef<Data, undefined>;
+    queryRef<Data, Variables>(name: string, variables: Variables, options?: RefOptions): QueryRef<Data, Variables>;
     upsert<GraphQlResponse, Variables extends object>(tableName: string, variables: Variables): Promise<ExecuteGraphqlResponse<GraphQlResponse>>;
     upsertMany<GraphQlResponse, Variables extends Array<unknown>>(tableName: string, variables: Variables): Promise<ExecuteGraphqlResponse<GraphQlResponse>>;
 }
@@ -60,4 +65,60 @@ export interface ImpersonateUnauthenticated {
     unauthenticated: true;
 }
 
+// @public (undocumented)
+export class MutationRef<Data, Variables> extends OperationRef<Data, Variables> {
+    // (undocumented)
+    execute(): Promise<MutationResult<Data, Variables>>;
+}
+
+// @public
+export interface MutationResult<Data, Variables> extends OperationResult<Data, Variables> {
+    // (undocumented)
+    ref: MutationRef<Data, Variables>;
+}
+
+// @public (undocumented)
+export abstract class OperationRef<Data, Variables> {
+    constructor(dataConnect: DataConnect, name: string, variables: Variables, options?: RefOptions | undefined);
+    // (undocumented)
+    readonly dataConnect: DataConnect;
+    // (undocumented)
+    abstract execute(): Promise<OperationResult<Data, Variables>>;
+    // (undocumented)
+    readonly name: string;
+    // (undocumented)
+    readonly options?: RefOptions | undefined;
+    // (undocumented)
+    readonly variables: Variables;
+}
+
+// @public (undocumented)
+export interface OperationResult<Data, Variables> {
+    // (undocumented)
+    data: Data;
+    // (undocumented)
+    dataConnect: DataConnect;
+    // (undocumented)
+    ref: OperationRef<Data, Variables>;
+    // (undocumented)
+    variables: Variables;
+}
+
+// @public (undocumented)
+export class QueryRef<Data, Variables> extends OperationRef<Data, Variables> {
+    // (undocumented)
+    execute(): Promise<QueryResult<Data, Variables>>;
+}
+
+// @public
+export interface QueryResult<Data, Variables> extends OperationResult<Data, Variables> {
+    // (undocumented)
+    ref: QueryRef<Data, Variables>;
+}
+
+// @public
+export interface RefOptions {
+    impersonate?: ImpersonateAuthenticated | ImpersonateUnauthenticated;
+}
+
 ```