firebase-tools 13.7.5 → 13.8.0

package/lib/gcp/cloudsql/connect.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupIAMUser = exports.execute = void 0;
+const pg = require("pg");
+const cloud_sql_connector_1 = require("@google-cloud/cloud-sql-connector");
+const requireAuth_1 = require("../../requireAuth");
+const projectUtils_1 = require("../../projectUtils");
+const cloudSqlAdminClient = require("./cloudsqladmin");
+const utils = require("../../utils");
+const logger_1 = require("../../logger");
+const error_1 = require("../../error");
+const fbToolsAuthClient_1 = require("./fbToolsAuthClient");
+async function execute(sqlStatements, opts) {
+    const logFn = opts.silent ? logger_1.logger.debug : logger_1.logger.info;
+    const instance = await cloudSqlAdminClient.getInstance(opts.projectId, opts.instanceId);
+    const user = await cloudSqlAdminClient.getUser(opts.projectId, opts.instanceId, opts.username);
+    const connectionName = instance.connectionName;
+    if (!connectionName) {
+        throw new error_1.FirebaseError(`Could not get instance conection string for ${opts.instanceId}:${opts.databaseId}`);
+    }
+    let connector;
+    let pool;
+    switch (user.type) {
+        case "CLOUD_IAM_USER": {
+            connector = new cloud_sql_connector_1.Connector({
+                auth: new fbToolsAuthClient_1.FBToolsAuthClient(),
+            });
+            const clientOpts = await connector.getOptions({
+                instanceConnectionName: connectionName,
+                ipType: cloud_sql_connector_1.IpAddressTypes.PUBLIC,
+                authType: cloud_sql_connector_1.AuthTypes.IAM,
+            });
+            pool = new pg.Pool(Object.assign(Object.assign({}, clientOpts), { user: opts.username, database: opts.databaseId, max: 1 }));
+            break;
+        }
+        case "CLOUD_IAM_SERVICE_ACCOUNT": {
+            connector = new cloud_sql_connector_1.Connector();
+            const clientOpts = await connector.getOptions({
+                instanceConnectionName: connectionName,
+                ipType: cloud_sql_connector_1.IpAddressTypes.PUBLIC,
+                authType: cloud_sql_connector_1.AuthTypes.IAM,
+            });
+            pool = new pg.Pool(Object.assign(Object.assign({}, clientOpts), { user: opts.username, database: opts.databaseId, max: 1 }));
+            break;
+        }
+        default: {
+            if (!opts.password) {
+                throw new error_1.FirebaseError(`Cannot connect as BUILT_IN user without a password.`);
+            }
+            connector = new cloud_sql_connector_1.Connector({
+                auth: new fbToolsAuthClient_1.FBToolsAuthClient(),
+            });
+            const clientOpts = await connector.getOptions({
+                instanceConnectionName: connectionName,
+                ipType: cloud_sql_connector_1.IpAddressTypes.PUBLIC,
+            });
+            pool = new pg.Pool(Object.assign(Object.assign({}, clientOpts), { user: opts.username, password: opts.password, database: opts.databaseId, max: 1 }));
+            break;
+        }
+    }
+    for (const s of sqlStatements) {
+        logFn(`Executing: '${s}' as ${opts.username}`);
+        try {
+            await pool.query(s);
+        }
+        catch (err) {
+            throw new error_1.FirebaseError(`Error executing ${err}`);
+        }
+    }
+    await pool.end();
+    connector.close();
+}
+exports.execute = execute;
+async function setupIAMUser(instanceId, databaseId, options) {
+    const projectId = (0, projectUtils_1.needProjectId)(options);
+    const account = await (0, requireAuth_1.requireAuth)(options);
+    if (!account) {
+        throw new error_1.FirebaseError("No account to set up! Run `firebase login` or set Application Default Credentials");
+    }
+    const setupUser = "firebasesuperuser";
+    const temporaryPassword = utils.generateId(20);
+    await cloudSqlAdminClient.createUser(projectId, instanceId, "BUILT_IN", setupUser, temporaryPassword);
+    const { user, mode } = toDatabaseUser(account);
+    await cloudSqlAdminClient.createUser(projectId, instanceId, mode, user);
+    const grants = [
+        `do
+      $$
+      begin
+        if not exists (select FROM pg_catalog.pg_roles
+          WHERE  rolname = '${firebaseowner(databaseId)}') then
+          CREATE ROLE "${firebaseowner(databaseId)}" WITH ADMIN "${setupUser}";
+        end if;
+      end
+      $$
+      ;`,
+        `GRANT ALL PRIVILEGES ON DATABASE "${databaseId}" TO "${firebaseowner(databaseId)}"`,
+        `GRANT cloudsqlsuperuser TO "${firebaseowner(databaseId)}"`,
+        `GRANT "${firebaseowner(databaseId)}" TO "${setupUser}"`,
+        `GRANT "${firebaseowner(databaseId)}" TO "${user}"`,
+        `ALTER SCHEMA public OWNER TO "${firebaseowner(databaseId)}"`,
+        `GRANT USAGE ON SCHEMA "public" TO PUBLIC`,
+        `GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA "public" TO PUBLIC`,
+        `GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA "public" TO PUBLIC`,
+    ];
+    await execute(grants, {
+        projectId,
+        instanceId,
+        databaseId,
+        username: setupUser,
+        password: temporaryPassword,
+        silent: true,
+    });
+    return user;
+}
+exports.setupIAMUser = setupIAMUser;
+function firebaseowner(databaseId) {
+    return `firebaseowner_${databaseId}_public`;
+}
+function toDatabaseUser(account) {
+    let mode = "CLOUD_IAM_USER";
+    let user = account;
+    if (account.endsWith(".gserviceaccount.com")) {
+        user = account.replace(".gserviceaccount.com", "");
+        mode = "CLOUD_IAM_SERVICE_ACCOUNT";
+    }
+    return { user, mode };
+}

package/lib/gcp/cloudsql/fbToolsAuthClient.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FBToolsAuthClient = void 0;
+const google_auth_library_1 = require("google-auth-library");
+const apiv2 = require("../../apiv2");
+const error_1 = require("../../error");
+class FBToolsAuthClient extends google_auth_library_1.AuthClient {
+    async request(opts) {
+        var _a;
+        if (!opts.url) {
+            throw new error_1.FirebaseError("opts.url was undefined");
+        }
+        const url = new URL(opts.url);
+        const client = new apiv2.Client({
+            urlPrefix: url.origin,
+            auth: true,
+        });
+        const res = await client.request({
+            method: (_a = opts.method) !== null && _a !== void 0 ? _a : "POST",
+            path: url.pathname,
+            queryParams: opts.params,
+            body: opts.data,
+            responseType: opts.responseType,
+        });
+        return {
+            config: opts,
+            status: res.status,
+            statusText: res.response.statusText,
+            data: res.body,
+            headers: res.response.headers,
+            request: {},
+        };
+    }
+    async getAccessToken() {
+        return { token: await apiv2.getAccessToken() };
+    }
+    async getRequestHeaders() {
+        const token = await this.getAccessToken();
+        return Object.assign(Object.assign({}, apiv2.STANDARD_HEADERS), { Authorization: `Bearer ${token.token}` });
+    }
+}
+exports.FBToolsAuthClient = FBToolsAuthClient;

package/lib/gcp/cloudsql/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/gcp/iam.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.testIamPermissions = exports.testResourceIamPermissions = exports.getRole = exports.listServiceAccountKeys = exports.deleteServiceAccount = exports.createServiceAccountKey = exports.getServiceAccount = exports.createServiceAccount = exports.getDefaultComputeEngineServiceAgent = exports.getDefaultCloudBuildServiceAgent = void 0;
+exports.printManualIamConfig = exports.mergeBindings = exports.testIamPermissions = exports.testResourceIamPermissions = exports.getRole = exports.listServiceAccountKeys = exports.deleteServiceAccount = exports.createServiceAccountKey = exports.getServiceAccount = exports.createServiceAccount = exports.getDefaultComputeEngineServiceAgent = exports.getDefaultCloudBuildServiceAgent = void 0;
 const api_1 = require("../api");
 const logger_1 = require("../logger");
 const apiv2_1 = require("../apiv2");
+const utils = require("../utils");
 const apiClient = new apiv2_1.Client({ urlPrefix: (0, api_1.iamOrigin)(), apiVersion: "v1" });
 function getDefaultCloudBuildServiceAgent(projectNumber) {
     return `${projectNumber}@cloudbuild.gserviceaccount.com`;
@@ -82,3 +83,34 @@ async function testIamPermissions(projectId, permissions) {
     return testResourceIamPermissions((0, api_1.resourceManagerOrigin)(), "v1", `projects/${projectId}`, permissions, `projects/${projectId}`);
 }
 exports.testIamPermissions = testIamPermissions;
+function mergeBindings(policy, requiredBindings) {
+    let updated = false;
+    for (const requiredBinding of requiredBindings) {
+        const match = policy.bindings.find((b) => b.role === requiredBinding.role);
+        if (!match) {
+            updated = true;
+            policy.bindings.push(requiredBinding);
+            continue;
+        }
+        for (const requiredMember of requiredBinding.members) {
+            if (!match.members.find((m) => m === requiredMember)) {
+                updated = true;
+                match.members.push(requiredMember);
+            }
+        }
+    }
+    return updated;
+}
+exports.mergeBindings = mergeBindings;
+function printManualIamConfig(requiredBindings, projectId, prefix) {
+    utils.logLabeledBullet(prefix, "Failed to verify the project has the correct IAM bindings for a successful deployment.", "warn");
+    utils.logLabeledBullet(prefix, "You can either re-run this command as a project owner or manually run the following set of `gcloud` commands:", "warn");
+    for (const binding of requiredBindings) {
+        for (const member of binding.members) {
+            utils.logLabeledBullet(prefix, `\`gcloud projects add-iam-policy-binding ${projectId} ` +
+                `--member=${member} ` +
+                `--role=${binding.role}\``, "warn");
+        }
+    }
+}
+exports.printManualIamConfig = printManualIamConfig;

package/lib/gcp/secretManager.js

@@ -51,7 +51,7 @@ async function getSecretMetadata(projectId, secretName, version) {
     const secretInfo = {};
     try {
         secretInfo.secret = await getSecret(projectId, secretName);
-        secretInfo.secretVersion = getSecretVersion(projectId, secretName, version);
+        secretInfo.secretVersion = await getSecretVersion(projectId, secretName, version);
     }
     catch (err) {
         if (err.status !== 404) {

package/lib/init/features/dataconnect/index.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doSetup = void 0;
+const path_1 = require("path");
+const prompt_1 = require("../../../prompt");
+const fs_1 = require("fs");
+const provisionCloudSql_1 = require("../../../dataconnect/provisionCloudSql");
+const ensureApis_1 = require("../../../dataconnect/ensureApis");
+const client_1 = require("../../../dataconnect/client");
+const TEMPLATE_ROOT = (0, path_1.resolve)(__dirname, "../../../../templates/init/dataconnect/");
+const DATACONNECT_YAML_TEMPLATE = (0, fs_1.readFileSync)((0, path_1.join)(TEMPLATE_ROOT, "dataconnect.yaml"), "utf8");
+const CONNECTOR_YAML_TEMPLATE = (0, fs_1.readFileSync)((0, path_1.join)(TEMPLATE_ROOT, "connector.yaml"), "utf8");
+const SCHEMA_TEMPLATE = (0, fs_1.readFileSync)((0, path_1.join)(TEMPLATE_ROOT, "schema.gql"), "utf8");
+const QUERIES_TEMPLATE = (0, fs_1.readFileSync)((0, path_1.join)(TEMPLATE_ROOT, "queries.gql"), "utf8");
+const MUTATIONS_TEMPLATE = (0, fs_1.readFileSync)((0, path_1.join)(TEMPLATE_ROOT, "mutations.gql"), "utf8");
+async function doSetup(setup, config) {
+    var _a, _b, _c;
+    if (setup.projectId) {
+        await (0, ensureApis_1.ensureApis)(setup.projectId);
+    }
+    const serviceId = await (0, prompt_1.promptOnce)({
+        message: "What ID would you like to use for this service?",
+        type: "input",
+        default: "dataconnect",
+    });
+    let locationOptions = [
+        { name: "us-central1", value: "us-central1" },
+        { name: "europe-north1", value: "europe-north1" },
+        { name: "europe-central2", value: "europe-central2" },
+        { name: "europe-west1", value: "europe-west1" },
+        { name: "southamerica-west1", value: "southamerica-west1" },
+        { name: "us-east4", value: "us-east4" },
+        { name: "us-west1", value: "us-west1" },
+        { name: "asia-southeast1", value: "asia-southeast1" },
+    ];
+    if (setup.projectId) {
+        const locations = await (0, client_1.listLocations)(setup.projectId);
+        locationOptions = locations.map((l) => {
+            return { name: l, value: l };
+        });
+    }
+    const locationId = await (0, prompt_1.promptOnce)({
+        message: "What location would you like to deploy this service into?",
+        type: "list",
+        choices: locationOptions,
+    });
+    const connectorId = await (0, prompt_1.promptOnce)({
+        message: "What ID would you like to use for your connector?",
+        type: "input",
+        default: "my-connector",
+    });
+    const dir = config.get("dataconnect.source") ||
+        (await (0, prompt_1.promptOnce)({
+            message: "What directory should be used for DataConnect config and schema?",
+            type: "input",
+            default: "dataconnect",
+        }));
+    if (!config.has("dataconnect")) {
+        config.set("dataconnect.source", dir);
+        config.set("dataconnect.location", locationId);
+    }
+    const cloudSqlInstanceId = await (0, prompt_1.promptOnce)({
+        message: `What CloudSQL instance would you like to use? Please enter the ID of an existing instance in ${locationId}`,
+        type: "input",
+        default: `dataconnect-test`,
+    });
+    const cloudSqlDatabase = await (0, prompt_1.promptOnce)({
+        message: `Which database would you like to use from ${cloudSqlInstanceId}?`,
+        type: "input",
+        default: `dataconnect-test`,
+    });
+    const defaultConnectionString = (_c = (_b = (_a = setup.rcfile.dataconnectEmulatorConfig) === null || _a === void 0 ? void 0 : _a.postgres) === null || _b === void 0 ? void 0 : _b.localConnectionString) !== null && _c !== void 0 ? _c : "postgresql://localhost:5432?sslmode=disable";
+    const localConnectionString = await (0, prompt_1.promptOnce)({
+        type: "input",
+        name: "localConnectionString",
+        message: `What is the connection string of the local Postgres instance you would like to use with the Data Connect emulator?`,
+        default: defaultConnectionString,
+    });
+    setup.rcfile.dataconnectEmulatorConfig = { postgres: { localConnectionString } };
+    const subbedDataconnectYaml = subValues(DATACONNECT_YAML_TEMPLATE, {
+        serviceId,
+        cloudSqlInstanceId,
+        cloudSqlDatabase,
+        connectorId,
+    });
+    const subbedConnectorYaml = subValues(CONNECTOR_YAML_TEMPLATE, {
+        serviceId,
+        cloudSqlInstanceId,
+        cloudSqlDatabase,
+        connectorId,
+    });
+    await config.askWriteProjectFile((0, path_1.join)(dir, "dataconnect.yaml"), subbedDataconnectYaml);
+    await config.askWriteProjectFile((0, path_1.join)(dir, "connector", "connector.yaml"), subbedConnectorYaml);
+    await config.askWriteProjectFile((0, path_1.join)(dir, "schema", "schema.gql"), SCHEMA_TEMPLATE);
+    await config.askWriteProjectFile((0, path_1.join)(dir, "connector", "queries.gql"), QUERIES_TEMPLATE);
+    await config.askWriteProjectFile((0, path_1.join)(dir, "connector", "mutations.gql"), MUTATIONS_TEMPLATE);
+    if (setup.projectId &&
+        (await (0, prompt_1.confirm)({
+            message: "Would you like to provision your CloudSQL instance and database now? This will take a few minutes.",
+            default: true,
+        }))) {
+        await (0, provisionCloudSql_1.provisionCloudSql)({
+            projectId: setup.projectId,
+            locationId,
+            instanceId: cloudSqlInstanceId,
+            databaseId: cloudSqlDatabase,
+            enableGoogleMlIntegration: false,
+        });
+    }
+}
+exports.doSetup = doSetup;
+function subValues(template, replacementValues) {
+    const replacements = {
+        serviceId: "__serviceId__",
+        cloudSqlDatabase: "__cloudSqlDatabase__",
+        cloudSqlInstanceId: "__cloudSqlInstanceId__",
+        connectorId: "__connectorId__",
+    };
+    let replaced = template;
+    for (const [k, v] of Object.entries(replacementValues)) {
+        replaced = replaced.replace(replacements[k], v);
+    }
+    return replaced;
+}

package/lib/init/features/emulators.js

@@ -9,6 +9,7 @@ const types_1 = require("../../emulator/types");
 const constants_1 = require("../../emulator/constants");
 const downloadableEmulators_1 = require("../../emulator/downloadableEmulators");
 async function doSetup(setup, config) {
+    var _a, _b, _c;
     const choices = types_1.ALL_SERVICE_EMULATORS.map((e) => {
         return {
             value: e,
@@ -76,6 +77,18 @@ async function doSetup(setup, config) {
                 ui.port = isNaN(portNum) ? undefined : portNum;
             }
         }
+        if (selections.emulators.includes(types_1.Emulators.DATACONNECT)) {
+            const defaultConnectionString = (_c = (_b = (_a = setup.rcfile.dataconnectEmulatorConfig) === null || _a === void 0 ? void 0 : _a.postgres) === null || _b === void 0 ? void 0 : _b.localConnectionString) !== null && _c !== void 0 ? _c : "postgresql://localhost:5432";
+            const localConnectionString = await (0, prompt_1.prompt)(setup.config.emulators[types_1.Emulators.DATACONNECT], [
+                {
+                    type: "input",
+                    name: "localConnectionString",
+                    message: `What is the connection string of the local Postgres instance you would like to use with the Data Connect emulator?`,
+                    default: defaultConnectionString,
+                },
+            ]);
+            setup.rcfile.dataconnectEmulatorConfig = { postgres: { localConnectionString } };
+        }
         await (0, prompt_1.prompt)(selections, [
             {
                 name: "download",

package/lib/init/features/functions/index.js

@@ -153,13 +153,25 @@ async function languageSetup(setup, config) {
     const cbconfig = (0, projectConfig_1.configForCodebase)(setup.config.functions, setup.functions.codebase);
     switch (language) {
         case "javascript":
-            cbconfig.ignore = ["node_modules", ".git", "firebase-debug.log", "firebase-debug.*.log"];
+            cbconfig.ignore = [
+                "node_modules",
+                ".git",
+                "firebase-debug.log",
+                "firebase-debug.*.log",
+                "*.local",
+            ];
             break;
         case "typescript":
-            cbconfig.ignore = ["node_modules", ".git", "firebase-debug.log", "firebase-debug.*.log"];
+            cbconfig.ignore = [
+                "node_modules",
+                ".git",
+                "firebase-debug.log",
+                "firebase-debug.*.log",
+                "*.local",
+            ];
             break;
         case "python":
-            cbconfig.ignore = ["venv", ".git", "firebase-debug.log", "firebase-debug.*.log"];
+            cbconfig.ignore = ["venv", ".git", "firebase-debug.log", "firebase-debug.*.log", "*.local"];
             break;
     }
     return require("./" + language).setup(setup, config);

package/lib/init/features/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.apphosting = exports.hostingGithub = exports.remoteconfig = exports.project = exports.extensions = exports.emulators = exports.storage = exports.hosting = exports.functions = exports.firestore = exports.database = exports.account = void 0;
+exports.apphosting = exports.dataconnect = exports.hostingGithub = exports.remoteconfig = exports.project = exports.extensions = exports.emulators = exports.storage = exports.hosting = exports.functions = exports.firestore = exports.database = exports.account = void 0;
 var account_1 = require("./account");
 Object.defineProperty(exports, "account", { enumerable: true, get: function () { return account_1.doSetup; } });
 var database_1 = require("./database");
@@ -23,5 +23,7 @@ var remoteconfig_1 = require("./remoteconfig");
 Object.defineProperty(exports, "remoteconfig", { enumerable: true, get: function () { return remoteconfig_1.doSetup; } });
 var github_1 = require("./hosting/github");
 Object.defineProperty(exports, "hostingGithub", { enumerable: true, get: function () { return github_1.initGitHub; } });
+var dataconnect_1 = require("./dataconnect");
+Object.defineProperty(exports, "dataconnect", { enumerable: true, get: function () { return dataconnect_1.doSetup; } });
 var apphosting_1 = require("../../apphosting");
 Object.defineProperty(exports, "apphosting", { enumerable: true, get: function () { return apphosting_1.doSetup; } });

package/lib/init/index.js

@@ -10,6 +10,7 @@ const featureFns = new Map([
     ["account", features.account],
     ["database", features.database],
     ["firestore", features.firestore],
+    ["dataconnect", features.dataconnect],
     ["functions", features.functions],
     ["hosting", features.hosting],
     ["storage", features.storage],

package/lib/logger.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.logger = void 0;
+exports.logger = exports.vsceLogEmitter = void 0;
 const winston = require("winston");
+const utils_1 = require("./utils");
+const events_1 = require("events");
+exports.vsceLogEmitter = new events_1.EventEmitter();
 function expandErrors(logger) {
     const oldLogFunc = logger.log.bind(logger);
     const newLogFunc = function (levelOrEntry, message, ...meta) {
@@ -25,7 +28,24 @@ function annotateDebugLines(logger) {
     logger.debug = newDebug;
     return logger;
 }
+function maybeUseVSCodeLogger(logger) {
+    if (!(0, utils_1.isVSCodeExtension)()) {
+        return logger;
+    }
+    const oldLogFunc = logger.log.bind(logger);
+    const vsceLogger = function (levelOrEntry, message, ...meta) {
+        if (message) {
+            exports.vsceLogEmitter.emit("log", { level: levelOrEntry, message });
+        }
+        else {
+            exports.vsceLogEmitter.emit("log", levelOrEntry);
+        }
+        return oldLogFunc(levelOrEntry, message, ...meta);
+    };
+    logger.log = vsceLogger;
+    return logger;
+}
 const rawLogger = winston.createLogger();
 rawLogger.add(new winston.transports.Console({ silent: true }));
 rawLogger.exitOnError = false;
-exports.logger = annotateDebugLines(expandErrors(rawLogger));
+exports.logger = maybeUseVSCodeLogger(annotateDebugLines(expandErrors(rawLogger)));

package/lib/operation-poller.js

@@ -45,7 +45,13 @@ class OperationPoller {
             if (options.onPoll) {
                 options.onPoll(res.body);
             }
-            if (!res.body.done) {
+            if (options.doneFn) {
+                const done = options.doneFn(res.body);
+                if (!done) {
+                    throw new Error("Polling incomplete, should trigger retry with backoff");
+                }
+            }
+            else if (!res.body.done) {
                 throw new Error("Polling incomplete, should trigger retry with backoff");
             }
             return res.body;

package/lib/rc.js

@@ -37,7 +37,7 @@ class RC {
     }
     constructor(rcpath, data) {
         this.path = rcpath;
-        this.data = Object.assign({ projects: {}, targets: {}, etags: {} }, data);
+        this.data = Object.assign({ projects: {}, targets: {}, etags: {}, dataconnectEmulatorConfig: {} }, data);
     }
     set(key, value) {
         _.set(this.data, key, value);
@@ -152,6 +152,15 @@ class RC {
         this.data.etags[projectId][resourceType] = etagData;
         this.save();
     }
+    getDataconnect() {
+        var _a;
+        return (_a = this.data.dataconnectEmulatorConfig) !== null && _a !== void 0 ? _a : {};
+    }
+    setDataconnect(localConnectionString) {
+        if (!this.data.dataconnectEmulatorConfig) {
+            this.data.dataconnectEmulatorConfig = { postgres: { localConnectionString } };
+        }
+    }
     save() {
         if (this.path) {
             fs.writeFileSync(this.path, JSON.stringify(this.data, null, 2), {

package/lib/requireAuth.js

@@ -77,5 +77,6 @@ async function requireAuth(options) {
         throw new error_1.FirebaseError(AUTH_ERROR_MESSAGE);
     }
     (0, auth_1.setActiveAccount)(options, { user, tokens });
+    return user.email;
 }
 exports.requireAuth = requireAuth;

package/lib/utils.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getHostnameFromUrl = exports.openInBrowserPopup = exports.openInBrowser = exports.connectableHostname = exports.randomInt = exports.debounce = exports.last = exports.cloneDeep = exports.groupBy = exports.assertIsStringOrUndefined = exports.assertIsNumber = exports.assertIsString = exports.thirtyDaysFromNow = exports.isRunningInWSL = exports.isVSCodeExtension = exports.isCloudEnvironment = exports.datetimeString = exports.createDestroyer = exports.promiseWithSpinner = exports.setupLoggers = exports.tryParse = exports.tryStringify = exports.promiseProps = exports.withTimeout = exports.promiseWhile = exports.promiseAllSettled = exports.getFunctionsEventProvider = exports.endpoint = exports.makeActiveProject = exports.streamToString = exports.stringToStream = exports.explainStdin = exports.allSettled = exports.reject = exports.logLabeledError = exports.logLabeledWarning = exports.logWarning = exports.logLabeledBullet = exports.logBullet = exports.logLabeledSuccess = exports.logSuccess = exports.addSubdomain = exports.addDatabaseNamespace = exports.getDatabaseViewDataUrl = exports.getDatabaseUrl = exports.envOverride = exports.getInheritedOption = exports.consoleUrl = exports.envOverrides = exports.IS_WINDOWS = void 0;
-exports.readSecretValue = void 0;
-const fs = require("node:fs");
+exports.openInBrowser = exports.connectableHostname = exports.randomInt = exports.debounce = exports.last = exports.cloneDeep = exports.groupBy = exports.assertIsStringOrUndefined = exports.assertIsNumber = exports.assertIsString = exports.thirtyDaysFromNow = exports.isRunningInWSL = exports.isVSCodeExtension = exports.isCloudEnvironment = exports.datetimeString = exports.createDestroyer = exports.promiseWithSpinner = exports.setupLoggers = exports.tryParse = exports.tryStringify = exports.promiseProps = exports.withTimeout = exports.promiseWhile = exports.promiseAllSettled = exports.getFunctionsEventProvider = exports.endpoint = exports.makeActiveProject = exports.streamToString = exports.stringToStream = exports.explainStdin = exports.allSettled = exports.reject = exports.logLabeledError = exports.logLabeledWarning = exports.logWarning = exports.logLabeledBullet = exports.logBullet = exports.logLabeledSuccess = exports.logSuccess = exports.addSubdomain = exports.addDatabaseNamespace = exports.getDatabaseViewDataUrl = exports.getDatabaseUrl = exports.envOverride = exports.setVSCodeEnvVars = exports.getInheritedOption = exports.consoleUrl = exports.vscodeEnvVars = exports.envOverrides = exports.IS_WINDOWS = void 0;
+exports.readSecretValue = exports.generateId = exports.wrappedSafeLoad = exports.readFileFromDirectory = exports.getHostnameFromUrl = exports.openInBrowserPopup = void 0;
+const fs = require("fs-extra");
 const tty = require("tty");
 const path = require("node:path");
+const yaml = require("yaml");
 const _ = require("lodash");
 const url = require("url");
 const http = require("http");
@@ -28,6 +29,7 @@ const WARNING_CHAR = exports.IS_WINDOWS ? "!" : "⚠";
 const ERROR_CHAR = exports.IS_WINDOWS ? "!!" : "⬢";
 const THIRTY_DAYS_IN_MILLISECONDS = 30 * 24 * 60 * 60 * 1000;
 exports.envOverrides = [];
+exports.vscodeEnvVars = {};
 function consoleUrl(project, path) {
     const api = require("./api");
     return `${api.consoleOrigin()}/project/${project}${path}`;
@@ -43,8 +45,12 @@ function getInheritedOption(options, key) {
     }
 }
 exports.getInheritedOption = getInheritedOption;
+function setVSCodeEnvVars(envVar, value) {
+    exports.vscodeEnvVars[envVar] = value;
+}
+exports.setVSCodeEnvVars = setVSCodeEnvVars;
 function envOverride(envname, value, coerce) {
-    const currentEnvValue = process.env[envname];
+    const currentEnvValue = isVSCodeExtension() && exports.vscodeEnvVars[envname] ? exports.vscodeEnvVars[envname] : process.env[envname];
     if (currentEnvValue && currentEnvValue.length) {
         exports.envOverrides.push(envname);
         if (coerce) {
@@ -527,6 +533,47 @@ function getHostnameFromUrl(url) {
     }
 }
 exports.getHostnameFromUrl = getHostnameFromUrl;
+function readFileFromDirectory(directory, file) {
+    return new Promise((resolve, reject) => {
+        fs.readFile(path.resolve(directory, file), "utf8", (err, data) => {
+            if (err) {
+                if (err.code === "ENOENT") {
+                    return reject(new error_1.FirebaseError(`Could not find "${file}" in "${directory}"`, { original: err }));
+                }
+                reject(new error_1.FirebaseError(`Failed to read file "${file}" in "${directory}"`, { original: err }));
+            }
+            else {
+                resolve(data);
+            }
+        });
+    }).then((source) => {
+        return {
+            source,
+            sourceDirectory: directory,
+        };
+    });
+}
+exports.readFileFromDirectory = readFileFromDirectory;
+function wrappedSafeLoad(source) {
+    try {
+        return yaml.parse(source);
+    }
+    catch (err) {
+        throw new error_1.FirebaseError(`YAML Error: ${err.message}`, { original: err });
+    }
+}
+exports.wrappedSafeLoad = wrappedSafeLoad;
+function generateId(n = 6) {
+    const letters = "abcdefghijklmnopqrstuvwxyz";
+    const allChars = "01234567890-abcdefghijklmnopqrstuvwxyz";
+    let id = letters[Math.floor(Math.random() * letters.length)];
+    for (let i = 1; i < n; i++) {
+        const idx = Math.floor(Math.random() * allChars.length);
+        id += allChars[idx];
+    }
+    return id;
+}
+exports.generateId = generateId;
 function readSecretValue(prompt, dataFile) {
     if ((!dataFile || dataFile === "-") && tty.isatty(0)) {
         return (0, prompt_1.promptOnce)({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-tools",
-  "version": "13.7.5",
+  "version": "13.8.0",
   "description": "Command-Line Interface for Firebase",
   "main": "./lib/index.js",
   "bin": {
@@ -58,6 +58,7 @@
     ]
   },
   "dependencies": {
+    "@google-cloud/cloud-sql-connector": "^1.2.3",
     "@google-cloud/pubsub": "^3.0.1",
     "abort-controller": "^3.0.0",
     "ajv": "^6.12.6",
@@ -82,8 +83,9 @@
     "form-data": "^4.0.0",
     "fs-extra": "^10.1.0",
     "fuzzy": "^0.1.3",
+    "gaxios": "^6.1.1",
     "glob": "^7.1.2",
-    "google-auth-library": "^7.11.0",
+    "google-auth-library": "^9.7.0",
     "inquirer": "^8.2.6",
     "inquirer-autocomplete-prompt": "^2.0.1",
     "jsonwebtoken": "^9.0.0",
@@ -99,12 +101,14 @@
     "open": "^6.3.0",
     "ora": "^5.4.1",
     "p-limit": "^3.0.1",
+    "pg": "^8.11.3",
     "portfinder": "^1.0.32",
     "progress": "^2.0.3",
     "proxy-agent": "^6.3.0",
     "retry": "^0.13.1",
     "rimraf": "^3.0.0",
     "semver": "^7.5.2",
+    "sql-formatter": "^15.3.0",
     "stream-chain": "^2.2.4",
     "stream-json": "^1.7.3",
     "strip-ansi": "^6.0.1",