firebase-tools 10.9.2 → 11.1.0

package/lib/commands/ext-configure.js

@@ -1,9 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const _ = require("lodash");
-const clc = require("cli-color");
+exports.command = void 0;
 const { marked } = require("marked");
-const ora = require("ora");
 const TerminalRenderer = require("marked-terminal");
 const checkMinRequiredVersion_1 = require("../checkMinRequiredVersion");
 const command_1 = require("../command");
@@ -23,11 +21,10 @@ const askUserForEventsConfig = require("../extensions/askUserForEventsConfig");
 marked.setOptions({
     renderer: new TerminalRenderer(),
 });
-exports.default = new command_1.Command("ext:configure <extensionInstanceId>")
+exports.command = new command_1.Command("ext:configure <extensionInstanceId>")
     .description("configure an existing extension instance")
     .withForce()
-    .option("--params <paramsFile>", "path of params file with .env format.")
-    .option("--local", "save to firebase.json rather than directly install to a Firebase project")
+    .option("--local", "deprecated")
     .before(requirePermissions_1.requirePermissions, [
     "firebaseextensions.instances.update",
     "firebaseextensions.instances.get",
@@ -35,126 +32,65 @@ exports.default = new command_1.Command("ext:configure <extensionInstanceId>")
     .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extMinVersion")
     .before(extensionsHelper_1.diagnoseAndFixProject)
     .action(async (instanceId, options) => {
-    var _a;
     const projectId = (0, projectUtils_1.getProjectId)(options);
+    if (options.nonInteractive) {
+        throw new error_1.FirebaseError(`Command not supported in non-interactive mode, edit ./extensions/${instanceId}.env directly instead. ` +
+            `See https://firebase.google.com/docs/extensions/manifest for more details.`);
+    }
     if (options.local) {
-        if (options.nonInteractive) {
-            throw new error_1.FirebaseError(`Command not supported in non-interactive mode, edit ./extensions/${instanceId}.env directly instead`);
-        }
-        const config = manifest.loadConfig(options);
-        const refOrPath = manifest.getInstanceTarget(instanceId, config);
-        const isLocalSource = (0, extensionsHelper_1.isLocalPath)(refOrPath);
-        let spec;
-        if (isLocalSource) {
-            const source = await (0, extensionsHelper_1.createSourceFromLocation)((0, projectUtils_1.needProjectId)({ projectId }), refOrPath);
-            spec = source.spec;
-        }
-        else {
-            const extensionVersion = await extensionsApi.getExtensionVersion(refOrPath);
-            spec = extensionVersion.spec;
-        }
-        const oldParamValues = manifest.readInstanceParam({
-            instanceId,
-            projectDir: config.projectDir,
-        });
-        const [immutableParams, tbdParams] = (0, functional_1.partition)(spec.params, (param) => { var _a; return (_a = param.immutable) !== null && _a !== void 0 ? _a : false; });
-        infoImmutableParams(immutableParams, oldParamValues);
-        paramHelper.setNewDefaults(tbdParams, oldParamValues);
-        const mutableParamsBindingOptions = await paramHelper.getParams({
-            projectId,
-            paramSpecs: tbdParams,
-            nonInteractive: false,
-            paramsEnvPath: ((_a = options.params) !== null && _a !== void 0 ? _a : ""),
-            instanceId,
-            reconfiguring: true,
-        });
-        const eventsConfig = spec.events
-            ? await askUserForEventsConfig.askForEventsConfig(spec.events, "${param:PROJECT_ID}", instanceId)
-            : undefined;
-        if (eventsConfig) {
-            mutableParamsBindingOptions.EVENTARC_CHANNEL = { baseValue: eventsConfig.channel };
-            mutableParamsBindingOptions.ALLOWED_EVENT_TYPES = {
-                baseValue: eventsConfig.allowedEventTypes.join(","),
-            };
-        }
-        const newParamOptions = Object.assign(Object.assign({}, (0, paramHelper_1.buildBindingOptionsWithBaseValue)(oldParamValues)), mutableParamsBindingOptions);
-        await manifest.writeToManifest([
-            {
-                instanceId,
-                ref: !isLocalSource ? refs.parse(refOrPath) : undefined,
-                localPath: isLocalSource ? refOrPath : undefined,
-                params: newParamOptions,
-                extensionSpec: spec,
-            },
-        ], config, {
-            nonInteractive: false,
-            force: true,
-        });
-        manifest.showPreviewWarning();
-        return;
+        utils.logLabeledWarning(extensionsHelper_1.logPrefix, "As of firebase-tools@11.0.0, the `--local` flag is no longer required, as it is the default behavior.");
     }
-    if (!projectId) {
-        throw new error_1.FirebaseError(`Project ID must be provided when re-configuring an instance outside of local mode.`);
+    const config = manifest.loadConfig(options);
+    const refOrPath = manifest.getInstanceTarget(instanceId, config);
+    const isLocalSource = (0, extensionsHelper_1.isLocalPath)(refOrPath);
+    let spec;
+    if (isLocalSource) {
+        const source = await (0, extensionsHelper_1.createSourceFromLocation)((0, projectUtils_1.needProjectId)({ projectId }), refOrPath);
+        spec = source.spec;
     }
-    const spinner = ora(`Configuring ${clc.bold(instanceId)}. This usually takes 3 to 5 minutes...`);
-    try {
-        const existingInstance = await extensionsApi.getInstance((0, projectUtils_1.needProjectId)({ projectId }), instanceId);
-        const paramSpecWithNewDefaults = paramHelper.getParamsWithCurrentValuesAsDefaults(existingInstance);
-        const immutableParams = _.remove(paramSpecWithNewDefaults, (param) => param.immutable);
-        const paramBindingOptions = await paramHelper.getParams({
-            projectId,
-            paramSpecs: paramSpecWithNewDefaults,
-            nonInteractive: options.nonInteractive,
-            paramsEnvPath: options.params,
-            instanceId,
-            reconfiguring: true,
-        });
-        const paramBindings = (0, paramHelper_1.getBaseParamBindings)(paramBindingOptions);
-        if (immutableParams.length) {
-            const plural = immutableParams.length > 1;
-            logger_1.logger.info(`The following param${plural ? "s are" : " is"} immutable:`);
-            for (const { param } of immutableParams) {
-                const value = _.get(existingInstance, `config.params.${param}`);
-                logger_1.logger.info(`param: ${param}, value: ${value}`);
-                paramBindings[param] = value;
-            }
-            logger_1.logger.info((plural
-                ? "To set different values for these params"
-                : "To set a different value for this param") +
-                ", uninstall the extension, then install a new instance of this extension.");
-        }
-        const pId = (0, projectUtils_1.needProjectId)({ projectId });
-        const spec = existingInstance ? existingInstance.config.source.spec : undefined;
-        const eventsConfig = spec.events
-            ? await askUserForEventsConfig.askForEventsConfig(spec.events, pId, instanceId)
-            : undefined;
-        spinner.start();
-        const configureOptions = {
-            projectId: pId,
-            instanceId,
-            params: paramBindings,
-            canEmitEvents: eventsConfig ? true : false,
-            eventarcChannel: eventsConfig === null || eventsConfig === void 0 ? void 0 : eventsConfig.channel,
-            allowedEventTypes: eventsConfig === null || eventsConfig === void 0 ? void 0 : eventsConfig.allowedEventTypes,
-        };
-        const res = await extensionsApi.configureInstance(configureOptions);
-        spinner.stop();
-        utils.logLabeledSuccess(extensionsHelper_1.logPrefix, `successfully configured ${clc.bold(instanceId)}.`);
-        utils.logLabeledBullet(extensionsHelper_1.logPrefix, marked(`You can view your reconfigured instance in the Firebase console: ${utils.consoleUrl((0, projectUtils_1.needProjectId)({ projectId }), `/extensions/instances/${instanceId}?tab=config`)}`));
-        manifest.showDeprecationWarning();
-        return res;
+    else {
+        const extensionVersion = await extensionsApi.getExtensionVersion(refOrPath);
+        spec = extensionVersion.spec;
     }
-    catch (err) {
-        if (spinner.isSpinning) {
-            spinner.fail();
-        }
-        if (!(err instanceof error_1.FirebaseError)) {
-            throw new error_1.FirebaseError(`Error occurred while configuring the instance: ${err.message}`, {
-                original: err,
-            });
-        }
-        throw err;
+    const oldParamValues = manifest.readInstanceParam({
+        instanceId,
+        projectDir: config.projectDir,
+    });
+    const [immutableParams, tbdParams] = (0, functional_1.partition)(spec.params, (param) => { var _a; return (_a = param.immutable) !== null && _a !== void 0 ? _a : false; });
+    infoImmutableParams(immutableParams, oldParamValues);
+    paramHelper.setNewDefaults(tbdParams, oldParamValues);
+    const mutableParamsBindingOptions = await paramHelper.getParams({
+        projectId,
+        paramSpecs: tbdParams,
+        nonInteractive: false,
+        paramsEnvPath: "",
+        instanceId,
+        reconfiguring: true,
+    });
+    const eventsConfig = spec.events
+        ? await askUserForEventsConfig.askForEventsConfig(spec.events, "${param:PROJECT_ID}", instanceId)
+        : undefined;
+    if (eventsConfig) {
+        mutableParamsBindingOptions.EVENTARC_CHANNEL = { baseValue: eventsConfig.channel };
+        mutableParamsBindingOptions.ALLOWED_EVENT_TYPES = {
+            baseValue: eventsConfig.allowedEventTypes.join(","),
+        };
     }
+    const newParamOptions = Object.assign(Object.assign({}, (0, paramHelper_1.buildBindingOptionsWithBaseValue)(oldParamValues)), mutableParamsBindingOptions);
+    await manifest.writeToManifest([
+        {
+            instanceId,
+            ref: !isLocalSource ? refs.parse(refOrPath) : undefined,
+            localPath: isLocalSource ? refOrPath : undefined,
+            params: newParamOptions,
+            extensionSpec: spec,
+        },
+    ], config, {
+        nonInteractive: false,
+        force: true,
+    });
+    manifest.showPostDeprecationNotice();
+    return;
 });
 function infoImmutableParams(immutableParams, paramValues) {
     if (!immutableParams.length) {

package/lib/commands/ext-dev-deprecate.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
 const clc = require("cli-color");
 const semver = require("semver");
 const refs = require("../extensions/refs");
@@ -11,7 +12,7 @@ const extensionsApi_1 = require("../extensions/extensionsApi");
 const versionHelper_1 = require("../extensions/versionHelper");
 const requireAuth_1 = require("../requireAuth");
 const error_1 = require("../error");
-exports.default = new command_1.Command("ext:dev:deprecate <extensionRef> <versionPredicate>")
+exports.command = new command_1.Command("ext:dev:deprecate <extensionRef> <versionPredicate>")
     .description("deprecate extension versions that match the version predicate")
     .option("-m, --message <deprecationMessage>", "deprecation message")
     .option("-f, --force", "override deprecation message for existing deprecated extension versions that match")

package/lib/commands/ext-dev-emulators-exec.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const clc = require("cli-color");
 const checkMinRequiredVersion_1 = require("../checkMinRequiredVersion");
 const command_1 = require("../command");
+const error_1 = require("../error");
 const commandUtils = require("../emulator/commandUtils");
-const optionsHelper = require("../extensions/emulator/optionsHelper");
-module.exports = new command_1.Command("ext:dev:emulators:exec <script>")
-    .description("emulate an extension, run a test script, then shut down the emulators")
+exports.command = new command_1.Command("ext:dev:emulators:exec <script>")
+    .description("deprecated: please use `firebase emulators:exec` instead")
     .before(commandUtils.setExportOnExitOptions)
     .option(commandUtils.FLAG_INSPECT_FUNCTIONS, commandUtils.DESC_INSPECT_FUNCTIONS)
     .option(commandUtils.FLAG_TEST_CONFIG, commandUtils.DESC_TEST_CONFIG)
@@ -14,8 +16,12 @@ module.exports = new command_1.Command("ext:dev:emulators:exec <script>")
     .option(commandUtils.FLAG_EXPORT_ON_EXIT, commandUtils.DESC_EXPORT_ON_EXIT)
     .option(commandUtils.FLAG_UI, commandUtils.DESC_UI)
     .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extDevMinVersion")
-    .action(async (script, options) => {
-    const emulatorOptions = await optionsHelper.buildOptions(options);
-    commandUtils.beforeEmulatorCommand(emulatorOptions);
-    await commandUtils.emulatorExec(script, emulatorOptions);
+    .action((script, options) => {
+    const localInstallCommand = `firebase ext:install ${process.cwd()}`;
+    const emulatorsExecCommand = `firebase emulators:exec '${script}`;
+    throw new error_1.FirebaseError("ext:dev:emulators:exec is no longer supported. " +
+        "Instead, navigate to a Firebase project directory and add this extension to the extensions manifest by running:\n" +
+        clc.bold(localInstallCommand) +
+        "\nThen, you can emulate this extension as part of that project by running:\n" +
+        clc.bold(emulatorsExecCommand));
 });

package/lib/commands/ext-dev-emulators-start.js

@@ -1,39 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const checkMinRequiredVersion_1 = require("../checkMinRequiredVersion");
+exports.command = void 0;
+const clc = require("cli-color");
 const command_1 = require("../command");
-const controller = require("../emulator/controller");
 const commandUtils = require("../emulator/commandUtils");
-const optionsHelper = require("../extensions/emulator/optionsHelper");
-const utils = require("../utils");
 const error_1 = require("../error");
-module.exports = new command_1.Command("ext:dev:emulators:start")
-    .description("start the local Firebase extension emulator")
+exports.command = new command_1.Command("ext:dev:emulators:start")
+    .description("deprecated: please use `firebase emulators:start`")
     .before(commandUtils.setExportOnExitOptions)
     .option(commandUtils.FLAG_INSPECT_FUNCTIONS, commandUtils.DESC_INSPECT_FUNCTIONS)
     .option(commandUtils.FLAG_TEST_CONFIG, commandUtils.DESC_TEST_CONFIG)
     .option(commandUtils.FLAG_TEST_PARAMS, commandUtils.DESC_TEST_PARAMS)
     .option(commandUtils.FLAG_IMPORT, commandUtils.DESC_IMPORT)
     .option(commandUtils.FLAG_EXPORT_ON_EXIT, commandUtils.DESC_EXPORT_ON_EXIT)
-    .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extDevMinVersion")
-    .action(async (options) => {
-    const killSignalPromise = commandUtils.shutdownWhenKilled(options);
-    const emulatorOptions = await optionsHelper.buildOptions(options);
-    let deprecationNotices;
-    try {
-        commandUtils.beforeEmulatorCommand(emulatorOptions);
-        ({ deprecationNotices } = await controller.startAll(emulatorOptions));
-    }
-    catch (e) {
-        await controller.cleanShutdown();
-        if (!(e instanceof error_1.FirebaseError)) {
-            throw new error_1.FirebaseError("Error in ext:dev:emulator:start", e);
-        }
-        throw e;
-    }
-    utils.logSuccess("All emulators ready, it is now safe to connect.");
-    for (const notice of deprecationNotices) {
-        utils.logLabeledWarning("emulators", notice, "warn");
-    }
-    await killSignalPromise;
+    .action((options) => {
+    const localInstallCommand = `firebase ext:install ${process.cwd()}`;
+    const emulatorsStartCommand = "firebase emulators:start";
+    throw new error_1.FirebaseError("ext:dev:emulators:start is no longer supported. " +
+        "Instead, navigate to a Firebase project directory and add this extension to the extensions manifest by running:\n" +
+        clc.bold(localInstallCommand) +
+        "\nThen, you can emulate this extension as part of that project by running:\n" +
+        clc.bold(emulatorsStartCommand));
 });

package/lib/commands/ext-dev-extension-delete.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
 const utils = require("../utils");
 const clc = require("cli-color");
 const command_1 = require("../command");
@@ -10,7 +11,7 @@ const prompt_1 = require("../prompt");
 const requireAuth_1 = require("../requireAuth");
 const error_1 = require("../error");
 const checkMinRequiredVersion_1 = require("../checkMinRequiredVersion");
-module.exports = new command_1.Command("ext:dev:delete <extensionRef>")
+exports.command = new command_1.Command("ext:dev:delete <extensionRef>")
     .description("delete an extension")
     .help("use this command to delete an extension, and make it unavailable for developers to install or reconfigure. " +
     "Specify the extension you want to delete using the format '<publisherId>/<extensionId>.")

package/lib/commands/ext-dev-init.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
 const fs = require("fs");
 const path = require("path");
 const { marked } = require("marked");
@@ -24,7 +25,7 @@ function readCommonTemplates() {
         changelogTemplate: fs.readFileSync(path.join(TEMPLATE_ROOT, "CHANGELOG.md"), "utf8"),
     };
 }
-exports.default = new command_1.Command("ext:dev:init")
+exports.command = new command_1.Command("ext:dev:init")
     .description("initialize files for writing an extension in the current directory")
     .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extDevMinVersion")
     .action(async (options) => {

package/lib/commands/ext-dev-list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
 const clc = require("cli-color");
 const Table = require("cli-table");
 const _ = require("lodash");
@@ -11,7 +12,7 @@ const extensionsUtils = require("../extensions/utils");
 const extensionsApi_1 = require("../extensions/extensionsApi");
 const logger_1 = require("../logger");
 const requireAuth_1 = require("../requireAuth");
-exports.default = new command_1.Command("ext:dev:list <publisherId>")
+exports.command = new command_1.Command("ext:dev:list <publisherId>")
     .description("list all published extensions associated with this publisher ID")
     .before(requireAuth_1.requireAuth)
     .action(async (publisherId) => {

package/lib/commands/ext-dev-publish.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
 const clc = require("cli-color");
 const { marked } = require("marked");
 const TerminalRenderer = require("marked-terminal");
@@ -14,7 +15,7 @@ const utils = require("../utils");
 marked.setOptions({
     renderer: new TerminalRenderer(),
 });
-exports.default = new command_1.Command("ext:dev:publish <extensionRef>")
+exports.command = new command_1.Command("ext:dev:publish <extensionRef>")
     .description(`publish a new version of an extension`)
     .withForce()
     .help("if you have not previously published a version of this extension, this will " +

package/lib/commands/ext-dev-register.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
 const clc = require("cli-color");
 const { marked } = require("marked");
 const command_1 = require("../command");
@@ -11,7 +12,7 @@ const askUserForConsent_1 = require("../extensions/askUserForConsent");
 const requirePermissions_1 = require("../requirePermissions");
 const error_1 = require("../error");
 const utils = require("../utils");
-exports.default = new command_1.Command("ext:dev:register")
+exports.command = new command_1.Command("ext:dev:register")
     .description("register a publisher ID; run this before publishing your first extension.")
     .before(requirePermissions_1.requirePermissions, ["firebaseextensions.sources.create"])
     .before(extensionsHelper_1.ensureExtensionsApiEnabled)

package/lib/commands/ext-dev-undeprecate.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
 const clc = require("cli-color");
 const semver = require("semver");
 const refs = require("../extensions/refs");
@@ -11,7 +12,7 @@ const extensionsApi_1 = require("../extensions/extensionsApi");
 const versionHelper_1 = require("../extensions/versionHelper");
 const requireAuth_1 = require("../requireAuth");
 const error_1 = require("../error");
-exports.default = new command_1.Command("ext:dev:undeprecate <extensionRef> <versionPredicate>")
+exports.command = new command_1.Command("ext:dev:undeprecate <extensionRef> <versionPredicate>")
     .description("undeprecate extension versions that match the version predicate")
     .before(requireAuth_1.requireAuth)
     .before(extensionsHelper_1.ensureExtensionsApiEnabled)

package/lib/commands/ext-dev-unpublish.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
 const command_1 = require("../command");
 const extensionsHelper_1 = require("../extensions/extensionsHelper");
 const extensionsApi_1 = require("../extensions/extensionsApi");
@@ -10,7 +11,7 @@ const clc = require("cli-color");
 const requireAuth_1 = require("../requireAuth");
 const error_1 = require("../error");
 const checkMinRequiredVersion_1 = require("../checkMinRequiredVersion");
-module.exports = new command_1.Command("ext:dev:unpublish <extensionRef>")
+exports.command = new command_1.Command("ext:dev:unpublish <extensionRef>")
     .description("unpublish an extension")
     .withForce()
     .help("use this command to unpublish an extension, and make it unavailable for developers to install or reconfigure. " +

package/lib/commands/ext-dev-usage.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
 const Table = require("cli-table");
 const clc = require("cli-color");
 const utils = require("../utils");
@@ -14,7 +15,7 @@ const error_1 = require("../error");
 const logger_1 = require("../logger");
 const prompt_1 = require("../prompt");
 const shortenUrl_1 = require("../shortenUrl");
-module.exports = new command_1.Command("ext:dev:usage <publisherId>")
+exports.command = new command_1.Command("ext:dev:usage <publisherId>")
     .description("get usage for an extension")
     .help("use this command to get the usage of extensions you published. " +
     "Specify the publisher ID you used to publish your extensions, " +

package/lib/commands/ext-export.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
 const checkMinRequiredVersion_1 = require("../checkMinRequiredVersion");
 const command_1 = require("../command");
 const planner = require("../deploy/extensions/planner");
@@ -13,7 +14,7 @@ const logger_1 = require("../logger");
 const projectUtils_1 = require("../projectUtils");
 const prompt_1 = require("../prompt");
 const requirePermissions_1 = require("../requirePermissions");
-module.exports = new command_1.Command("ext:export")
+exports.command = new command_1.Command("ext:export")
     .description("export all Extension instances installed on a project to a local Firebase directory")
     .before(requirePermissions_1.requirePermissions, ["firebaseextensions.instances.list"])
     .before(extensionsHelper_1.ensureExtensionsApiEnabled)

package/lib/commands/ext-info.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
 const clc = require("cli-color");
 const _ = require("lodash");
 const checkMinRequiredVersion_1 = require("../checkMinRequiredVersion");
@@ -13,7 +14,7 @@ const utils = require("../utils");
 const { marked } = require("marked");
 const TerminalRenderer = require("marked-terminal");
 const FUNCTION_TYPE_REGEX = /\..+\.function/;
-exports.default = new command_1.Command("ext:info <extensionName>")
+exports.command = new command_1.Command("ext:info <extensionName>")
     .description("display information about an extension by name (extensionName@x.y.z for a specific version)")
     .option("--markdown", "output info in Markdown suitable for constructing a README file")
     .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extMinVersion")