start fleshing out interactions between stubs and bdos

Author: stephenarosaj

e2e/data-connect/dataconnect-generated/js/default-connector/README.md

@@ -1,27 +1,25 @@
+# Generated TypeScript README
+This README will guide you through the process of using the generated JavaScript SDK package for the connector `default`. It will also provide examples on how to use your generated SDK to call your Data Connect queries and mutations.
+
+***NOTE:** This README is generated alongside the generated SDK. If you make changes to this file, they will be overwritten when the SDK is regenerated.*
+
 # Table of Contents
-- [**Overview**](#generated-typescript-readme)
+- [**Overview**](#generated-javascript-readme)
 - [**Accessing the connector**](#accessing-the-connector)
   - [*Connecting to the local Emulator*](#connecting-to-the-local-emulator)
 - [**Queries**](#queries)
   - [*ListMovies*](#listmovies)
 - [**Mutations**](#mutations)
   - [*CreateMovie*](#createmovie)
 
-# Generated TypeScript README
-This README will guide you through the process of using the generated TypeScript SDK package for the connector `default`. It will also provide examples on how to use your generated SDK to call your Data Connect queries and mutations.
-
-***NOTE:** This README is generated alongside the generated SDK. If you make changes to this file, they will be overwritten when the SDK is regenerated.*
+# Accessing the connector
+A connector is a collection of Queries and Mutations. One SDK is generated for each connector - this SDK is generated for the connector `default`. You can find more information about connectors in the [Data Connect documentation](https://firebase.google.com/docs/data-connect#how-does).
 
 You can use this generated SDK by importing from the package `@firebasegen/default-connector` as shown below. Both CommonJS and ESM imports are supported.
 
 You can also follow the instructions from the [Data Connect documentation](https://firebase.google.com/docs/data-connect/web-sdk#set-client).
 
-# Accessing the connector
-A connector is a collection of Queries and Mutations. One SDK is generated for each connector - this SDK is generated for the connector `default`.
-
-You can find more information about connectors in the [Data Connect documentation](https://firebase.google.com/docs/data-connect#how-does).
-
-```javascript
+```typescript
 import { getDataConnect } from 'firebase/data-connect';
 import { connectorConfig } from '@firebasegen/default-connector';
 
@@ -34,7 +32,7 @@ By default, the connector will connect to the production service.
 To connect to the emulator, you can use the following code.
 You can also follow the emulator instructions from the [Data Connect documentation](https://firebase.google.com/docs/data-connect/web-sdk#instrument-clients).
 
-```javascript
+```typescript
 import { connectDataConnectEmulator, getDataConnect } from 'firebase/data-connect';
 import { connectorConfig } from '@firebasegen/default-connector';
 
@@ -61,16 +59,31 @@ Below are examples of how to use the `default` connector's generated functions t
 
 ## ListMovies
 You can execute the `ListMovies` query using the following action shortcut function, or by calling `executeQuery()` after calling the following `QueryRef` function, both of which are defined in [default-connector/index.d.ts](./index.d.ts):
-```javascript
+```typescript
 listMovies(): QueryPromise<ListMoviesData, undefined>;
 
-listMoviesRef(): QueryRef<ListMoviesData, undefined>;
+interface ListMoviesRef {
+  ...
+  /* Allow users to create refs without passing in DataConnect */
+  (): QueryRef<ListMoviesData, undefined>;
+}
+export const listMoviesRef: ListMoviesRef;
 ```
 You can also pass in a `DataConnect` instance to the action shortcut function or `QueryRef` function.
-```javascript
+```typescript
 listMovies(dc: DataConnect): QueryPromise<ListMoviesData, undefined>;
 
-listMoviesRef(dc: DataConnect): QueryRef<ListMoviesData, undefined>;
+interface ListMoviesRef {
+  ...
+  (dc: DataConnect): QueryRef<ListMoviesData, undefined>;
+}
+export const listMoviesRef: ListMoviesRef;
+```
+
+If you need the name of the operation without creating a ref, you can retrieve the operation name by calling the `operationName` property on the listMoviesRef:
+```typescript
+const name = listMoviesRef.operationName;
+console.log(name);
 ```
 
 ### Variables
@@ -79,7 +92,7 @@ The `ListMovies` query has no variables.
 Recall that executing the `ListMovies` query returns a `QueryPromise` that resolves to an object with a `data` property.
 
 The `data` property is an object of type `ListMoviesData`, which is defined in [default-connector/index.d.ts](./index.d.ts). It has the following fields:
-```javascript
+```typescript
 export interface ListMoviesData {
   movies: ({
     id: UUIDString;
@@ -91,7 +104,7 @@ export interface ListMoviesData {
 ```
 ### Using `ListMovies`'s action shortcut function
 
-```javascript
+```typescript
 import { getDataConnect } from 'firebase/data-connect';
 import { connectorConfig, listMovies } from '@firebasegen/default-connector';
 
@@ -115,7 +128,7 @@ listMovies().then((response) => {
 
 ### Using `ListMovies`'s `QueryRef` function
 
-```javascript
+```typescript
 import { getDataConnect, executeQuery } from 'firebase/data-connect';
 import { connectorConfig, listMoviesRef } from '@firebasegen/default-connector';
 
@@ -157,22 +170,37 @@ Below are examples of how to use the `default` connector's generated functions t
 
 ## CreateMovie
 You can execute the `CreateMovie` mutation using the following action shortcut function, or by calling `executeMutation()` after calling the following `MutationRef` function, both of which are defined in [default-connector/index.d.ts](./index.d.ts):
-```javascript
+```typescript
 createMovie(vars: CreateMovieVariables): MutationPromise<CreateMovieData, CreateMovieVariables>;
 
-createMovieRef(vars: CreateMovieVariables): MutationRef<CreateMovieData, CreateMovieVariables>;
+interface CreateMovieRef {
+  ...
+  /* Allow users to create refs without passing in DataConnect */
+  (vars: CreateMovieVariables): MutationRef<CreateMovieData, CreateMovieVariables>;
+}
+export const createMovieRef: CreateMovieRef;
 ```
 You can also pass in a `DataConnect` instance to the action shortcut function or `MutationRef` function.
-```javascript
+```typescript
 createMovie(dc: DataConnect, vars: CreateMovieVariables): MutationPromise<CreateMovieData, CreateMovieVariables>;
 
-createMovieRef(dc: DataConnect, vars: CreateMovieVariables): MutationRef<CreateMovieData, CreateMovieVariables>;
+interface CreateMovieRef {
+  ...
+  (dc: DataConnect, vars: CreateMovieVariables): MutationRef<CreateMovieData, CreateMovieVariables>;
+}
+export const createMovieRef: CreateMovieRef;
+```
+
+If you need the name of the operation without creating a ref, you can retrieve the operation name by calling the `operationName` property on the createMovieRef:
+```typescript
+const name = createMovieRef.operationName;
+console.log(name);
 ```
 
 ### Variables
 The `CreateMovie` mutation requires an argument of type `CreateMovieVariables`, which is defined in [default-connector/index.d.ts](./index.d.ts). It has the following fields:
 
-```javascript
+```typescript
 export interface CreateMovieVariables {
   title: string;
   genre: string;
@@ -183,14 +211,14 @@ export interface CreateMovieVariables {
 Recall that executing the `CreateMovie` mutation returns a `MutationPromise` that resolves to an object with a `data` property.
 
 The `data` property is an object of type `CreateMovieData`, which is defined in [default-connector/index.d.ts](./index.d.ts). It has the following fields:
-```javascript
+```typescript
 export interface CreateMovieData {
   movie_insert: Movie_Key;
 }
 ```
 ### Using `CreateMovie`'s action shortcut function
 
-```javascript
+```typescript
 import { getDataConnect } from 'firebase/data-connect';
 import { connectorConfig, createMovie, CreateMovieVariables } from '@firebasegen/default-connector';
 
@@ -222,7 +250,7 @@ createMovie(createMovieVars).then((response) => {
 
 ### Using `CreateMovie`'s `MutationRef` function
 
-```javascript
+```typescript
 import { getDataConnect, executeMutation } from 'firebase/data-connect';
 import { connectorConfig, createMovieRef, CreateMovieVariables } from '@firebasegen/default-connector';
 

e2e/data-connect/dataconnect-generated/js/default-connector/esm/index.esm.js

@@ -1,55 +1,30 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import {
-  queryRef,
-  executeQuery,
-  mutationRef,
-  executeMutation,
-  validateArgs
-} from 'firebase/data-connect';
+import { queryRef, executeQuery, mutationRef, executeMutation, validateArgs } from 'firebase/data-connect';
 
 export const connectorConfig = {
   connector: 'default',
   service: 'fdc-test',
   location: 'us-central1'
 };
 
-export function createMovieRef(dcOrVars, vars) {
-  const { dc: dcInstance, vars: inputVars } = validateArgs(
-    connectorConfig,
-    dcOrVars,
-    vars,
-    true
-  );
+export const createMovieRef = (dcOrVars, vars) => {
+  const { dc: dcInstance, vars: inputVars} = validateArgs(connectorConfig, dcOrVars, vars, true);
   dcInstance._useGeneratedSdk();
   return mutationRef(dcInstance, 'CreateMovie', inputVars);
 }
+createMovieRef.operationName = 'CreateMovie';
 
 export function createMovie(dcOrVars, vars) {
   return executeMutation(createMovieRef(dcOrVars, vars));
 }
 
-export function listMoviesRef(dc) {
-  const { dc: dcInstance } = validateArgs(connectorConfig, dc, undefined);
+export const listMoviesRef = (dc) => {
+  const { dc: dcInstance} = validateArgs(connectorConfig, dc, undefined);
   dcInstance._useGeneratedSdk();
   return queryRef(dcInstance, 'ListMovies');
 }
+listMoviesRef.operationName = 'ListMovies';
 
 export function listMovies(dc) {
   return executeQuery(listMoviesRef(dc));
 }
+

e2e/data-connect/dataconnect-generated/js/default-connector/index.cjs.js

@@ -1,27 +1,4 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-const {
-  queryRef,
-  executeQuery,
-  mutationRef,
-  executeMutation,
-  validateArgs
-} = require('firebase/data-connect');
+const { queryRef, executeQuery, mutationRef, executeMutation, validateArgs } = require('firebase/data-connect');
 
 const connectorConfig = {
   connector: 'default',
@@ -30,26 +7,25 @@ const connectorConfig = {
 };
 exports.connectorConfig = connectorConfig;
 
-exports.createMovieRef = function createMovieRef(dcOrVars, vars) {
-  const { dc: dcInstance, vars: inputVars } = validateArgs(
-    connectorConfig,
-    dcOrVars,
-    vars,
-    true
-  );
+const createMovieRef = (dcOrVars, vars) => {
+  const { dc: dcInstance, vars: inputVars} = validateArgs(connectorConfig, dcOrVars, vars, true);
   dcInstance._useGeneratedSdk();
   return mutationRef(dcInstance, 'CreateMovie', inputVars);
-};
+}
+createMovieRef.operationName = 'CreateMovie';
+exports.createMovieRef = createMovieRef;
 
 exports.createMovie = function createMovie(dcOrVars, vars) {
   return executeMutation(createMovieRef(dcOrVars, vars));
 };
 
-exports.listMoviesRef = function listMoviesRef(dc) {
-  const { dc: dcInstance } = validateArgs(connectorConfig, dc, undefined);
+const listMoviesRef = (dc) => {
+  const { dc: dcInstance} = validateArgs(connectorConfig, dc, undefined);
   dcInstance._useGeneratedSdk();
   return queryRef(dcInstance, 'ListMovies');
-};
+}
+listMoviesRef.operationName = 'ListMovies';
+exports.listMoviesRef = listMoviesRef;
 
 exports.listMovies = function listMovies(dc) {
   return executeQuery(listMoviesRef(dc));