firebase-admin 13.4.0 → 13.6.0

package/lib/data-connect/data-connect-api-client-internal.js

@@ -1,8 +1,8 @@
-/*! firebase-admin v13.4.0 */
+/*! firebase-admin v13.6.0 */
 "use strict";
 /*!
  * @license
- * Copyright 2024 Google Inc.
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -23,16 +23,41 @@ const api_request_1 = require("../utils/api-request");
 const error_1 = require("../utils/error");
 const utils = require("../utils/index");
 const validator = require("../utils/validator");
-const API_VERSION = 'v1alpha';
-/** The Firebase Data Connect backend base URL format. */
-const FIREBASE_DATA_CONNECT_BASE_URL_FORMAT = 'https://firebasedataconnect.googleapis.com/{version}/projects/{projectId}/locations/{locationId}/services/{serviceId}:{endpointId}';
-/** Firebase Data Connect base URl format when using the Data Connect emultor. */
-const FIREBASE_DATA_CONNECT_EMULATOR_BASE_URL_FORMAT = 'http://{host}/{version}/projects/{projectId}/locations/{locationId}/services/{serviceId}:{endpointId}';
+const API_VERSION = 'v1';
+const FIREBASE_DATA_CONNECT_PROD_URL = 'https://firebasedataconnect.googleapis.com';
+/** The Firebase Data Connect backend service URL format. */
+const FIREBASE_DATA_CONNECT_SERVICES_URL_FORMAT = FIREBASE_DATA_CONNECT_PROD_URL +
+    '/{version}' +
+    '/projects/{projectId}' +
+    '/locations/{locationId}' +
+    '/services/{serviceId}' +
+    ':{endpointId}';
+/** The Firebase Data Connect backend connector URL format. */
+const FIREBASE_DATA_CONNECT_CONNECTORS_URL_FORMAT = FIREBASE_DATA_CONNECT_PROD_URL +
+    '/{version}' +
+    '/projects/{projectId}' +
+    '/locations/{locationId}' +
+    '/services/{serviceId}' +
+    '/connectors/{connectorId}' +
+    ':{endpointId}';
+/** Firebase Data Connect service URL format when using the Data Connect emulator. */
+const FIREBASE_DATA_CONNECT_EMULATOR_SERVICES_URL_FORMAT = 'http://{host}/{version}/projects/{projectId}/locations/{locationId}/services/{serviceId}:{endpointId}';
+/** Firebase Data Connect connector URL format when using the Data Connect emulator. */
+const FIREBASE_DATA_CONNECT_EMULATOR_CONNECTORS_URL_FORMAT = 'http://{host}/{version}/projects/{projectId}/locations/{locationId}/services/{serviceId}/connectors/{connectorId}:{endpointId}';
 const EXECUTE_GRAPH_QL_ENDPOINT = 'executeGraphql';
 const EXECUTE_GRAPH_QL_READ_ENDPOINT = 'executeGraphqlRead';
-const DATA_CONNECT_CONFIG_HEADERS = {
-    'X-Firebase-Client': `fire-admin-node/${utils.getSdkVersion()}`
-};
+const IMPERSONATE_QUERY_ENDPOINT = 'impersonateQuery';
+const IMPERSONATE_MUTATION_ENDPOINT = 'impersonateMutation';
+function getHeaders(isUsingGen) {
+    const headerValue = {
+        'X-Firebase-Client': `fire-admin-node/${utils.getSdkVersion()}`,
+        'X-Goog-Api-Client': utils.getMetricsHeader(),
+    };
+    if (isUsingGen) {
+        headerValue['X-Goog-Api-Client'] += ' admin-js/gen';
+    }
+    return headerValue;
+}
 /**
  * Class that facilitates sending requests to the Firebase Data Connect backend API.
  *
@@ -42,11 +67,19 @@ class DataConnectApiClient {
     constructor(connectorConfig, app) {
         this.connectorConfig = connectorConfig;
         this.app = app;
+        this.isUsingGen = false;
         if (!validator.isNonNullObject(app) || !('options' in app)) {
             throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, 'First argument passed to getDataConnect() must be a valid Firebase app instance.');
         }
         this.httpClient = new DataConnectHttpClient(app);
     }
+    /**
+     * Update whether the SDK is using a generated one or not.
+     * @param isUsingGen
+     */
+    setIsUsingGen(isUsingGen) {
+        this.isUsingGen = isUsingGen;
+    }
     /**
      * Execute arbitrary GraphQL, including both read and write queries
      *
@@ -68,6 +101,14 @@ class DataConnectApiClient {
     async executeGraphqlRead(query, options) {
         return this.executeGraphqlHelper(query, EXECUTE_GRAPH_QL_READ_ENDPOINT, options);
     }
+    /**
+     * A helper function to execute GraphQL queries.
+     *
+     * @param query - The arbitrary GraphQL query to execute.
+     * @param endpoint - The endpoint to call.
+     * @param options - The GraphQL options.
+     * @returns A promise that fulfills with the GraphQL response, or throws an error.
+     */
     async executeGraphqlHelper(query, endpoint, options) {
         if (!validator.isNonEmptyString(query)) {
             throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`query` must be a non-empty string.');
@@ -83,51 +124,116 @@ class DataConnectApiClient {
             ...(options?.operationName && { operationName: options?.operationName }),
             ...(options?.impersonate && { extensions: { impersonate: options?.impersonate } }),
         };
-        return this.getUrl(API_VERSION, this.connectorConfig.location, this.connectorConfig.serviceId, endpoint)
-            .then(async (url) => {
-            const request = {
-                method: 'POST',
-                url,
-                headers: DATA_CONNECT_CONFIG_HEADERS,
-                data,
-            };
-            const resp = await this.httpClient.send(request);
-            if (resp.data.errors && validator.isNonEmptyArray(resp.data.errors)) {
-                const allMessages = resp.data.errors.map((error) => error.message).join(' ');
-                throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.QUERY_ERROR, allMessages);
-            }
-            return Promise.resolve({
-                data: resp.data.data,
-            });
-        })
-            .then((resp) => {
+        const url = await this.getServicesUrl(API_VERSION, this.connectorConfig.location, this.connectorConfig.serviceId, endpoint);
+        try {
+            const resp = await this.makeGqlRequest(url, data);
             return resp;
-        })
-            .catch((err) => {
+        }
+        catch (err) {
             throw this.toFirebaseError(err);
-        });
+        }
     }
-    async getUrl(version, locationId, serviceId, endpointId) {
-        return this.getProjectId()
-            .then((projectId) => {
-            const urlParams = {
-                version,
-                projectId,
-                locationId,
-                serviceId,
-                endpointId
-            };
-            let urlFormat;
-            if (useEmulator()) {
-                urlFormat = utils.formatString(FIREBASE_DATA_CONNECT_EMULATOR_BASE_URL_FORMAT, {
-                    host: emulatorHost()
-                });
-            }
-            else {
-                urlFormat = FIREBASE_DATA_CONNECT_BASE_URL_FORMAT;
-            }
-            return utils.formatString(urlFormat, urlParams);
-        });
+    /**
+     * Executes a GraphQL query with impersonation.
+     *
+     * @param options - The GraphQL options. Must include impersonation details.
+     * @returns A promise that fulfills with the GraphQL response.
+     */
+    async executeQuery(name, variables, options) {
+        return this.executeOperationHelper(IMPERSONATE_QUERY_ENDPOINT, name, variables, options);
+    }
+    /**
+     * Executes a GraphQL mutation with impersonation.
+     *
+     * @param options - The GraphQL options. Must include impersonation details.
+     * @returns A promise that fulfills with the GraphQL response.
+     */
+    async executeMutation(name, variables, options) {
+        return this.executeOperationHelper(IMPERSONATE_MUTATION_ENDPOINT, name, variables, options);
+    }
+    /**
+     * A helper function to execute operations by making requests to FDC's impersonate
+     * operations endpoints.
+     *
+     * @param endpoint - The endpoint to call.
+     * @param options - The GraphQL options, including impersonation details.
+     * @returns A promise that fulfills with the GraphQL response.
+     */
+    async executeOperationHelper(endpoint, name, variables, options) {
+        if (typeof name === 'undefined' ||
+            !validator.isNonEmptyString(name)) {
+            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`name` must be a non-empty string.');
+        }
+        if (this.connectorConfig.connector === undefined || this.connectorConfig.connector === '') {
+            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, `The 'connectorConfig.connector' field used to instantiate your Data Connect
+        instance must be a non-empty string (the connectorId) when calling executeQuery or executeMutation.`);
+        }
+        const data = {
+            ...(variables && { variables: variables }),
+            operationName: name,
+            extensions: { impersonate: options?.impersonate },
+        };
+        const url = await this.getConnectorsUrl(API_VERSION, this.connectorConfig.location, this.connectorConfig.serviceId, this.connectorConfig.connector, endpoint);
+        try {
+            const resp = await this.makeGqlRequest(url, data);
+            return resp;
+        }
+        catch (err) {
+            throw this.toFirebaseError(err);
+        }
+    }
+    /**
+     * Constructs the URL for a Data Connect request to a service endpoint.
+     *
+     * @param version - The API version.
+     * @param locationId - The location of the Data Connect service.
+     * @param serviceId - The ID of the Data Connect service.
+     * @param endpointId - The endpoint to call.
+     * @returns A promise which resolves to the formatted URL string.
+     */
+    async getServicesUrl(version, locationId, serviceId, endpointId) {
+        const projectId = await this.getProjectId();
+        const params = {
+            version,
+            projectId,
+            locationId,
+            serviceId,
+            endpointId,
+        };
+        let urlFormat = FIREBASE_DATA_CONNECT_SERVICES_URL_FORMAT;
+        if (useEmulator()) {
+            urlFormat = FIREBASE_DATA_CONNECT_EMULATOR_SERVICES_URL_FORMAT;
+            params.host = emulatorHost();
+        }
+        return utils.formatString(urlFormat, params);
+    }
+    /**
+     * Constructs the URL for a Data Connect request to a connector endpoint.
+     *
+     * @param version - The API version.
+     * @param locationId - The location of the Data Connect service.
+     * @param serviceId - The ID of the Data Connect service.
+     * @param connectorId - The ID of the Connector.
+     * @param endpointId - The endpoint to call.
+     * @returns A promise which resolves to the formatted URL string.
+  
+     */
+    async getConnectorsUrl(version, locationId, serviceId, connectorId, endpointId) {
+        const projectId = await this.getProjectId();
+        const params = {
+            version,
+            projectId,
+            locationId,
+            serviceId,
+            connectorId,
+            endpointId,
+        };
+        let urlFormat = FIREBASE_DATA_CONNECT_CONNECTORS_URL_FORMAT;
+        if (useEmulator()) {
+            urlFormat = FIREBASE_DATA_CONNECT_EMULATOR_CONNECTORS_URL_FORMAT;
+            params.host = emulatorHost();
+        }
+        return utils.formatString(urlFormat, params);
     }
     getProjectId() {
         if (this.projectId) {
@@ -144,6 +250,29 @@ class DataConnectApiClient {
             return projectId;
         });
     }
+    /**
+     * Makes a GraphQL request to the specified url.
+     *
+     * @param url - The URL to send the request to.
+     * @param data - The GraphQL request payload.
+     * @returns A promise that fulfills with the GraphQL response, or throws an error.
+     */
+    async makeGqlRequest(url, data) {
+        const request = {
+            method: 'POST',
+            url,
+            headers: getHeaders(this.isUsingGen),
+            data,
+        };
+        const resp = await this.httpClient.send(request);
+        if (resp.data.errors && validator.isNonEmptyArray(resp.data.errors)) {
+            const allMessages = resp.data.errors.map((error) => error.message).join(' ');
+            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.QUERY_ERROR, allMessages);
+        }
+        return Promise.resolve({
+            data: resp.data.data,
+        });
+    }
     toFirebaseError(err) {
         if (err instanceof error_1.PrefixedFirebaseError) {
             return err;

package/lib/data-connect/data-connect-api.d.ts

@@ -1,7 +1,7 @@
-/*! firebase-admin v13.4.0 */
+/*! firebase-admin v13.6.0 */
 /*!
  * @license
- * Copyright 2024 Google Inc.
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -28,9 +28,13 @@ export interface ConnectorConfig {
      * Service ID of the Data Connect service.
      */
     serviceId: string;
+    /**
+     * Name of the Data Connect connector.
+     */
+    connector?: string;
 }
 /**
- * Interface representing GraphQL response.
+ * Interface representing ExecuteGraphQL response.
  */
 export interface ExecuteGraphqlResponse<GraphqlResponse> {
     /**
@@ -39,7 +43,16 @@ export interface ExecuteGraphqlResponse<GraphqlResponse> {
     data: GraphqlResponse;
 }
 /**
- * Interface representing GraphQL options.
+ * Interface representing ExecuteOperation response.
+ */
+export interface ExecuteOperationResponse<GraphqlResponse> {
+    /**
+     * Data payload of the GraphQL response.
+     */
+    data: GraphqlResponse;
+}
+/**
+ * Interface representing GraphQL options for executing arbitrary GraphQL operations.
  */
 export interface GraphqlOptions<Variables> {
     /**
@@ -47,7 +60,9 @@ export interface GraphqlOptions<Variables> {
      */
     variables?: Variables;
     /**
-     * The name of the GraphQL operation. Required only if `query` contains multiple operations.
+     * The name of the GraphQL operation.
+     * Required for operations that interact with services, such as executeGraphql, if
+     * `query` contains multiple operations.
      */
     operationName?: string;
     /**
@@ -56,6 +71,16 @@ export interface GraphqlOptions<Variables> {
      */
     impersonate?: ImpersonateAuthenticated | ImpersonateUnauthenticated;
 }
+/**
+ * Interface representing options for executing defined operations.
+ */
+export interface OperationOptions {
+    /**
+     * If set, impersonate a request with given Firebase Auth context and evaluate the auth
+     * policies on the operation. If omitted, bypass any defined auth policies.
+     */
+    impersonate?: ImpersonateAuthenticated | ImpersonateUnauthenticated;
+}
 /**
  * Type representing the partial claims of a Firebase Auth token used to evaluate the
  * Data Connect auth policy.

package/lib/data-connect/data-connect-api.js

@@ -1,8 +1,8 @@
-/*! firebase-admin v13.4.0 */
+/*! firebase-admin v13.6.0 */
 "use strict";
 /*!
  * @license
- * Copyright 2024 Google Inc.
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/lib/data-connect/data-connect.d.ts

@@ -1,7 +1,7 @@
-/*! firebase-admin v13.4.0 */
+/*! firebase-admin v13.6.0 */
 /*!
  * @license
- * Copyright 2024 Google Inc.
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,7 +16,7 @@
  * limitations under the License.
  */
 import { App } from '../app';
-import { ConnectorConfig, ExecuteGraphqlResponse, GraphqlOptions } from './data-connect-api';
+import { ConnectorConfig, ExecuteGraphqlResponse, ExecuteOperationResponse, GraphqlOptions, OperationOptions } from './data-connect-api';
 export declare class DataConnectService {
     private readonly appInternal;
     private dataConnectInstances;
@@ -46,13 +46,13 @@ export declare class DataConnect {
      */
     executeGraphql<GraphqlResponse, Variables>(query: string, options?: GraphqlOptions<Variables>): Promise<ExecuteGraphqlResponse<GraphqlResponse>>;
     /**
-   * Execute an arbitrary read-only GraphQL query
-   *
-   * @param query - The GraphQL read-only query.
-   * @param options - Optional {@link GraphqlOptions} when executing a read-only GraphQL query.
-   *
-   * @returns A promise that fulfills with a `ExecuteGraphqlResponse`.
-   */
+     * Execute an arbitrary read-only GraphQL query
+     *
+     * @param query - The GraphQL read-only query.
+     * @param options - Optional {@link GraphqlOptions} when executing a read-only GraphQL query.
+     *
+     * @returns A promise that fulfills with a `ExecuteGraphqlResponse`.
+     */
     executeGraphqlRead<GraphqlResponse, Variables>(query: string, options?: GraphqlOptions<Variables>): Promise<ExecuteGraphqlResponse<GraphqlResponse>>;
     /**
      * Insert a single row into the specified table.
@@ -86,4 +86,50 @@ export declare class DataConnect {
      * @returns A promise that fulfills with a `ExecuteGraphqlResponse`.
      */
     upsertMany<GraphQlResponse, Variables extends Array<unknown>>(tableName: string, variables: Variables): Promise<ExecuteGraphqlResponse<GraphQlResponse>>;
+    /**
+     * Executes a GraphQL query. The query must be defined in your Data Connect GraphQL files.
+     * Optionally, you can provide auth impersonation details. If you don't
+     * specify a value for this option, the query will run with admin privileges
+     * and will ignore all auth directives.
+     *
+     * @param name - The name of the defined query to execute.
+     * @param options - The GraphQL options, must include operationName and impersonation details.
+     * @returns A promise that fulfills with the GraphQL response.
+     */
+    executeQuery<Data>(name: string, options?: OperationOptions): Promise<ExecuteOperationResponse<Data>>;
+    /**
+     * Executes a GraphQL query. The query must be defined in your Data Connect GraphQL files.
+     * Optionally, you can provide auth impersonation details. If you don't
+     * specify a value for this option, the query will run with admin privileges
+     * and will ignore all auth directives.
+     *
+     * @param name - The name of the defined query to execute.
+     * @param variables - The variables for the query. May be optional if the query's variables are optional.
+     * @param options - The GraphQL options, must include operationName and impersonation details.
+     * @returns A promise that fulfills with the GraphQL response.
+     */
+    executeQuery<Data, Variables>(name: string, variables: Variables, options?: OperationOptions): Promise<ExecuteOperationResponse<Data>>;
+    /**
+     * Executes a GraphQL mutation. The mutation must be defined in your Data Connect GraphQL files.
+     * Optionally, you can provide auth impersonation details. If you don't
+     * specify a value for this option, the query will run with admin privileges
+     * and will ignore all auth directives.
+     *
+     * @param name - The name of the defined mutation to execute.
+     * @param options - The GraphQL options, must include operationName and impersonation details.
+     * @returns A promise that fulfills with the GraphQL response.
+     */
+    executeMutation<Data>(name: string, options?: OperationOptions): Promise<ExecuteOperationResponse<Data>>;
+    /**
+     * Executes a GraphQL mutation. The mutation must be defined in your Data Connect GraphQL files.
+     * Optionally, you can provide auth impersonation details. If you don't
+     * specify a value for this option, the query will run with admin privileges
+     * and will ignore all auth directives.
+     *
+     * @param name - The name of the defined mutation to execute.
+     * @param variables - The variables for the mutation. May be optional if the mutation's variables are optional.
+     * @param options - The GraphQL options, must include operationName and impersonation details.
+     * @returns A promise that fulfills with the GraphQL response.
+     */
+    executeMutation<Data, Variables>(name: string, variables: Variables, options?: OperationOptions): Promise<ExecuteOperationResponse<Data>>;
 }

package/lib/data-connect/data-connect.js

@@ -1,8 +1,8 @@
-/*! firebase-admin v13.4.0 */
+/*! firebase-admin v13.6.0 */
 "use strict";
 /*!
  * @license
- * Copyright 2024 Google Inc.
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -59,6 +59,13 @@ class DataConnect {
         this.app = app;
         this.client = new data_connect_api_client_internal_1.DataConnectApiClient(connectorConfig, app);
     }
+    /**
+     * @param isUsingGen
+     * @internal
+     */
+    useGen(isUsingGen) {
+        this.client.setIsUsingGen(isUsingGen);
+    }
     /**
      * Execute an arbitrary GraphQL query or mutation
      *
@@ -71,13 +78,13 @@ class DataConnect {
         return this.client.executeGraphql(query, options);
     }
     /**
-   * Execute an arbitrary read-only GraphQL query
-   *
-   * @param query - The GraphQL read-only query.
-   * @param options - Optional {@link GraphqlOptions} when executing a read-only GraphQL query.
-   *
-   * @returns A promise that fulfills with a `ExecuteGraphqlResponse`.
-   */
+     * Execute an arbitrary read-only GraphQL query
+     *
+     * @param query - The GraphQL read-only query.
+     * @param options - Optional {@link GraphqlOptions} when executing a read-only GraphQL query.
+     *
+     * @returns A promise that fulfills with a `ExecuteGraphqlResponse`.
+     */
     executeGraphqlRead(query, options) {
         return this.client.executeGraphqlRead(query, options);
     }
@@ -121,5 +128,11 @@ class DataConnect {
     upsertMany(tableName, variables) {
         return this.client.upsertMany(tableName, variables);
     }
+    executeQuery(name, variables, options) {
+        return this.client.executeQuery(name, variables, options);
+    }
+    executeMutation(name, variables, options) {
+        return this.client.executeMutation(name, variables, options);
+    }
 }
 exports.DataConnect = DataConnect;

package/lib/data-connect/index.d.ts

@@ -1,20 +1,4 @@
-/*! firebase-admin v13.4.0 */
-/*!
- * @license
- * Copyright 2024 Google Inc.
- *
- * 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.
- */
+/*! firebase-admin v13.6.0 */
 /**
  * Firebase Data Connect service.
  *
@@ -23,7 +7,7 @@
 import { App } from '../app';
 import { DataConnect } from './data-connect';
 import { ConnectorConfig } from './data-connect-api';
-export { GraphqlOptions, ExecuteGraphqlResponse, ConnectorConfig, ImpersonateAuthenticated, ImpersonateUnauthenticated, AuthClaims } from './data-connect-api';
+export { GraphqlOptions, ExecuteGraphqlResponse, ExecuteOperationResponse, ConnectorConfig, ImpersonateAuthenticated, ImpersonateUnauthenticated, AuthClaims, OperationOptions, } from './data-connect-api';
 export { DataConnect, } from './data-connect';
 /**
  * Gets the {@link DataConnect} service with the provided connector configuration
@@ -38,6 +22,7 @@ export { DataConnect, } from './data-connect';
  * const connectorConfig: ConnectorConfig = {
  *  location: 'us-west2',
  *  serviceId: 'my-service',
+ *  connectorName: 'my-connector',
  * };
  *
  * // Get the `DataConnect` service for the default app

package/lib/data-connect/index.js

@@ -1,8 +1,16 @@
-/*! firebase-admin v13.4.0 */
+/*! firebase-admin v13.6.0 */
 "use strict";
+/**
+ * Firebase Data Connect service.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAdminArgs = exports.DataConnect = void 0;
+exports.getDataConnect = getDataConnect;
 /*!
  * @license
- * Copyright 2024 Google Inc.
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,14 +24,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataConnect = void 0;
-exports.getDataConnect = getDataConnect;
-/**
- * Firebase Data Connect service.
- *
- * @packageDocumentation
- */
+const validate_admin_args_1 = require("./validate-admin-args");
 const app_1 = require("../app");
 const data_connect_1 = require("./data-connect");
 var data_connect_2 = require("./data-connect");
@@ -41,6 +42,7 @@ Object.defineProperty(exports, "DataConnect", { enumerable: true, get: function
  * const connectorConfig: ConnectorConfig = {
  *  location: 'us-west2',
  *  serviceId: 'my-service',
+ *  connectorName: 'my-connector',
  * };
  *
  * // Get the `DataConnect` service for the default app
@@ -69,3 +71,7 @@ function getDataConnect(connectorConfig, app) {
     const dataConnectService = firebaseApp.getOrInitService('dataConnect', (app) => new data_connect_1.DataConnectService(app));
     return dataConnectService.getDataConnect(connectorConfig);
 }
+/**
+ * @internal
+ */
+exports.validateAdminArgs = validate_admin_args_1._validateAdminArgs;

package/lib/data-connect/validate-admin-args.d.ts

@@ -0,0 +1,18 @@
+/*! firebase-admin v13.6.0 */
+/*!
+ * @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.
+ */
+export {};