firebase-tools 11.30.0 → 12.0.0

package/lib/api.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.githubClientSecret = exports.githubClientId = exports.secretManagerOrigin = exports.githubApiOrigin = exports.githubOrigin = exports.serviceUsageOrigin = exports.cloudRunApiOrigin = exports.hostingApiOrigin = exports.firebaseStorageOrigin = exports.storageOrigin = exports.runtimeconfigOrigin = exports.rulesOrigin = exports.resourceManagerOrigin = exports.remoteConfigApiOrigin = exports.rtdbMetadataOrigin = exports.rtdbManagementOrigin = exports.realtimeOrigin = exports.extensionsOrigin = exports.iamOrigin = exports.identityOrigin = exports.hostingOrigin = exports.googleOrigin = exports.pubsubOrigin = exports.cloudTasksOrigin = exports.cloudschedulerOrigin = exports.functionsDefaultRegion = exports.runOrigin = exports.functionsV2Origin = exports.functionsOrigin = exports.firestoreOrigin = exports.firestoreOriginOrEmulator = exports.firedataOrigin = exports.firebaseExtensionsRegistryOrigin = exports.firebaseApiOrigin = exports.eventarcOrigin = exports.dynamicLinksKey = exports.dynamicLinksOrigin = exports.deployOrigin = exports.consoleOrigin = exports.authOrigin = exports.appengineOrigin = exports.appDistributionOrigin = exports.artifactRegistryDomain = exports.containerRegistryDomain = exports.cloudMonitoringOrigin = exports.cloudloggingOrigin = exports.cloudbillingOrigin = exports.clientSecret = exports.clientId = exports.authProxyOrigin = void 0;
-exports.setScopes = exports.getScopes = void 0;
+exports.secretManagerOrigin = exports.githubApiOrigin = exports.githubOrigin = exports.serviceUsageOrigin = exports.cloudRunApiOrigin = exports.hostingApiOrigin = exports.firebaseStorageOrigin = exports.storageOrigin = exports.runtimeconfigOrigin = exports.rulesOrigin = exports.resourceManagerOrigin = exports.remoteConfigApiOrigin = exports.rtdbMetadataOrigin = exports.rtdbManagementOrigin = exports.realtimeOrigin = exports.extensionsTOSOrigin = exports.extensionsPublisherOrigin = exports.extensionsOrigin = exports.iamOrigin = exports.identityOrigin = exports.hostingOrigin = exports.googleOrigin = exports.pubsubOrigin = exports.cloudTasksOrigin = exports.cloudschedulerOrigin = exports.functionsDefaultRegion = exports.runOrigin = exports.functionsV2Origin = exports.functionsOrigin = exports.firestoreOrigin = exports.firestoreOriginOrEmulator = exports.firedataOrigin = exports.firebaseExtensionsRegistryOrigin = exports.firebaseApiOrigin = exports.eventarcOrigin = exports.dynamicLinksKey = exports.dynamicLinksOrigin = exports.deployOrigin = exports.consoleOrigin = exports.authOrigin = exports.appengineOrigin = exports.appDistributionOrigin = exports.artifactRegistryDomain = exports.containerRegistryDomain = exports.cloudMonitoringOrigin = exports.cloudloggingOrigin = exports.cloudbillingOrigin = exports.clientSecret = exports.clientId = exports.authProxyOrigin = void 0;
+exports.setScopes = exports.getScopes = exports.githubClientSecret = exports.githubClientId = void 0;
 const constants_1 = require("./emulator/constants");
 const logger_1 = require("./logger");
 const scopes = require("./scopes");
@@ -45,6 +45,8 @@ exports.hostingOrigin = utils.envOverride("FIREBASE_HOSTING_URL", "https://web.a
 exports.identityOrigin = utils.envOverride("FIREBASE_IDENTITY_URL", "https://identitytoolkit.googleapis.com");
 exports.iamOrigin = utils.envOverride("FIREBASE_IAM_URL", "https://iam.googleapis.com");
 exports.extensionsOrigin = utils.envOverride("FIREBASE_EXT_URL", "https://firebaseextensions.googleapis.com");
+exports.extensionsPublisherOrigin = utils.envOverride("FIREBASE_EXT_PUBLISHER_URL", "https://firebaseextensionspublisher.googleapis.com");
+exports.extensionsTOSOrigin = utils.envOverride("FIREBASE_EXT_TOS_URL", "https://firebaseextensionstos-pa.googleapis.com");
 exports.realtimeOrigin = utils.envOverride("FIREBASE_REALTIME_URL", "https://firebaseio.com");
 exports.rtdbManagementOrigin = utils.envOverride("FIREBASE_RTDB_MANAGEMENT_URL", "https://firebasedatabase.googleapis.com");
 exports.rtdbMetadataOrigin = utils.envOverride("FIREBASE_RTDB_METADATA_URL", "https://metadata-dot-firebase-prod.appspot.com");

package/lib/commands/ext-configure.js

@@ -18,6 +18,7 @@ const manifest = require("../extensions/manifest");
 const functional_1 = require("../functional");
 const paramHelper_1 = require("../extensions/paramHelper");
 const askUserForEventsConfig = require("../extensions/askUserForEventsConfig");
+const tos_1 = require("../extensions/tos");
 marked_1.marked.setOptions({
     renderer: new TerminalRenderer(),
 });
@@ -90,7 +91,7 @@ exports.command = new command_1.Command("ext:configure <extensionInstanceId>")
         nonInteractive: false,
         force: true,
     });
-    manifest.showPostDeprecationNotice();
+    (0, tos_1.displayDeveloperTOSWarning)();
     return;
 });
 function infoImmutableParams(immutableParams, paramValues) {

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

@@ -8,27 +8,34 @@ const utils = require("../utils");
 const command_1 = require("../command");
 const prompt_1 = require("../prompt");
 const extensionsHelper_1 = require("../extensions/extensionsHelper");
-const extensionsApi_1 = require("../extensions/extensionsApi");
+const publisherApi_1 = require("../extensions/publisherApi");
 const versionHelper_1 = require("../extensions/versionHelper");
 const requireAuth_1 = require("../requireAuth");
 const error_1 = require("../error");
-exports.command = 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")
     .before(requireAuth_1.requireAuth)
-    .before(extensionsHelper_1.ensureExtensionsApiEnabled)
+    .before(extensionsHelper_1.ensureExtensionsPublisherApiEnabled)
     .action(async (extensionRef, versionPredicate, options) => {
-    const { publisherId, extensionId, version } = refs.parse(extensionRef);
+    const ref = refs.parse(extensionRef);
+    return deprecate(ref, versionPredicate, options);
+});
+async function deprecate(extensionRef, versionPredicate, options) {
+    const { publisherId, extensionId, version } = extensionRef;
     if (version) {
         throw new error_1.FirebaseError(`The input extension reference must be of the format ${clc.bold("<publisherId>/<extensionId>")}. Version should be supplied in the version predicate argument.`);
     }
     if (!publisherId || !extensionId) {
-        throw new error_1.FirebaseError(`Error parsing publisher ID and extension ID from extension reference '${clc.bold(extensionRef)}'. Please use the format '${clc.bold("<publisherId>/<extensionId>")}'.`);
+        throw new error_1.FirebaseError(`Error parsing publisher ID and extension ID from extension reference '${clc.bold(refs.toExtensionRef(extensionRef))}'. Please use the format '${clc.bold("<publisherId>/<extensionId>")}'.`);
+    }
+    let filter = "";
+    if (versionPredicate) {
+        const { comparator, targetSemVer } = (0, versionHelper_1.parseVersionPredicate)(versionPredicate);
+        filter = `id${comparator}"${targetSemVer}"`;
     }
-    const { comparator, targetSemVer } = (0, versionHelper_1.parseVersionPredicate)(versionPredicate);
-    const filter = `id${comparator}"${targetSemVer}"`;
-    const extensionVersions = await (0, extensionsApi_1.listExtensionVersions)(extensionRef, filter);
+    const extensionVersions = await (0, publisherApi_1.listExtensionVersions)(refs.toExtensionRef(extensionRef), filter);
     const filteredExtensionVersions = extensionVersions
         .sort((ev1, ev2) => {
         return -semver.compare(ev1.spec.version, ev2.spec.version);
@@ -42,23 +49,20 @@ exports.command = new command_1.Command("ext:dev:deprecate <extensionRef> <versi
         return true;
     });
     if (filteredExtensionVersions.length > 0) {
-        if (!options.force) {
-            const confirmMessage = "You are about to deprecate these extension version(s). Do you wish to continue?";
-            const consent = await (0, prompt_1.promptOnce)({
-                type: "confirm",
-                message: confirmMessage,
-                default: false,
-            });
-            if (!consent) {
-                throw new error_1.FirebaseError("Deprecation canceled.");
-            }
+        const consent = await (0, prompt_1.confirm)({
+            default: false,
+            force: options.force,
+            nonInteractive: options.nonInteractive,
+        });
+        if (!consent) {
+            throw new error_1.FirebaseError("Deprecation canceled.");
         }
     }
     else {
         throw new error_1.FirebaseError("No extension versions matched the version predicate.");
     }
     await utils.allSettled(filteredExtensionVersions.map(async (extensionVersion) => {
-        await (0, extensionsApi_1.deprecateExtensionVersion)(extensionVersion.ref, options.deprecationMessage);
+        await (0, publisherApi_1.deprecateExtensionVersion)(extensionVersion.ref, options.message);
     }));
     utils.logLabeledSuccess(extensionsHelper_1.logPrefix, "successfully deprecated extension version(s).");
-});
+}

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

@@ -6,41 +6,42 @@ const Table = require("cli-table");
 const command_1 = require("../command");
 const error_1 = require("../error");
 const utils_1 = require("../utils");
-const extensionsApi_1 = require("../extensions/extensionsApi");
+const publisherApi_1 = require("../extensions/publisherApi");
 const logger_1 = require("../logger");
 const extensionsHelper_1 = require("../extensions/extensionsHelper");
 const requireAuth_1 = require("../requireAuth");
-const extensionsUtils = require("../extensions/utils");
 exports.command = new command_1.Command("ext:dev:list <publisherId>")
-    .description("list all published extensions associated with this publisher ID")
+    .description("list all extensions uploaded under publisher ID")
     .before(requireAuth_1.requireAuth)
     .action(async (publisherId) => {
     let extensions;
     try {
-        extensions = await (0, extensionsApi_1.listExtensions)(publisherId);
+        extensions = await (0, publisherApi_1.listExtensions)(publisherId);
     }
     catch (err) {
         throw new error_1.FirebaseError(err);
     }
     if (extensions.length < 1) {
-        throw new error_1.FirebaseError(`There are no published extensions associated with publisher ID ${clc.bold(publisherId)}. This could happen for two reasons:\n` +
+        throw new error_1.FirebaseError(`There are no extensions uploaded under publisher ID ${clc.bold(publisherId)}. This could happen for two reasons:\n` +
             "  - The publisher ID doesn't exist or could be misspelled\n" +
-            "  - This publisher has not published any extensions\n\n" +
+            "  - This publisher has not uploaded any extensions\n\n" +
             "If you are expecting some extensions to appear, please make sure you have the correct publisher ID and try again.");
     }
     const table = new Table({
-        head: ["Extension ID", "Version", "Published"],
+        head: ["Extension ID", "State", "Latest Version", "Version in Extensions Hub"],
         style: { head: ["yellow"] },
     });
-    const sorted = extensions.sort((a, b) => new Date(b.createTime).valueOf() - new Date(a.createTime).valueOf());
+    const sorted = extensions.sort((a, b) => a.ref.localeCompare(b.ref));
     sorted.forEach((extension) => {
+        var _a, _b;
         table.push([
             (0, utils_1.last)(extension.ref.split("/")),
-            extension.latestVersion,
-            extension.createTime ? extensionsUtils.formatTimestamp(extension.createTime) : "",
+            (0, extensionsHelper_1.unpackExtensionState)(extension),
+            (_a = extension.latestVersion) !== null && _a !== void 0 ? _a : "-",
+            (_b = extension.latestApprovedVersion) !== null && _b !== void 0 ? _b : "-",
         ]);
     });
-    (0, utils_1.logLabeledBullet)(extensionsHelper_1.logPrefix, `list of published extensions for publisher ${clc.bold(publisherId)}:`);
+    (0, utils_1.logLabeledBullet)(extensionsHelper_1.logPrefix, `list of uploaded extensions for publisher ${clc.bold(publisherId)}:`);
     logger_1.logger.info(table.toString());
     return { extensions: sorted };
 });

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

@@ -1,66 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.command = void 0;
-const clc = require("colorette");
 const marked_1 = require("marked");
 const TerminalRenderer = require("marked-terminal");
 const command_1 = require("../command");
-const extensionsHelper_1 = require("../extensions/extensionsHelper");
-const refs = require("../extensions/refs");
-const localHelper_1 = require("../extensions/localHelper");
-const publishHelpers_1 = require("../extensions/publishHelpers");
 const requireAuth_1 = require("../requireAuth");
-const error_1 = require("../error");
-const utils = require("../utils");
+const ext_dev_upload_1 = require("./ext-dev-upload");
+const utils_1 = require("../utils");
+const extensionsHelper_1 = require("../extensions/extensionsHelper");
 marked_1.marked.setOptions({
     renderer: new TerminalRenderer(),
 });
 exports.command = new command_1.Command("ext:dev:publish <extensionRef>")
-    .description(`publish a new version of an extension`)
+    .description(`Deprecated. Use ext:dev:upload instead`)
     .option(`-s, --stage <stage>`, `release stage (supports "alpha", "beta", "rc", and "stable")`)
-    .option(`--repo <repo>`, `Public Git repo URI (only required for first version from repo, cannot be changed)`)
+    .option(`--repo <repo>`, `Public GitHub repo URI that contains the extension source`)
     .option(`--ref <ref>`, `commit hash, branch, or tag to build from the repo (defaults to HEAD)`)
-    .option(`--root <root>`, `root directory that contains this Extension (defaults to previous version's root or root of repo if none set)`)
+    .option(`--root <root>`, `root directory that contains this extension (defaults to last uploaded root or "/" if none set)`)
     .withForce()
-    .help("if you have not previously published a version of this extension, this will " +
-    "create the extension. If you have previously published a version of this extension, this version must " +
+    .help("if you have not previously uploaded a version of this extension, this will " +
+    "create the extension. If you have previously uploaded a version of this extension, this version must " +
     "be greater than previous versions.")
     .before(requireAuth_1.requireAuth)
+    .before(extensionsHelper_1.ensureExtensionsPublisherApiEnabled)
     .action(async (extensionRef, options) => {
-    var _a;
-    const { publisherId, extensionId, version } = refs.parse(extensionRef);
-    if (version) {
-        throw new error_1.FirebaseError(`The input extension reference must be of the format ${clc.bold("<publisherId>/<extensionId>")}. Version should not be supplied and will be inferred directly from extension.yaml. Please increment the version in extension.yaml if you would like to bump/specify a version.`);
-    }
-    if (!publisherId || !extensionId) {
-        throw new error_1.FirebaseError(`Error parsing publisher ID and extension ID from extension reference '${clc.bold(extensionRef)}'. Please use the format '${clc.bold("<publisherId>/<extensionId>")}'.`);
-    }
-    let res;
-    if (options.repo || options.root || options.ref) {
-        res = await (0, extensionsHelper_1.publishExtensionVersionFromRemoteRepo)({
-            publisherId,
-            extensionId,
-            repoUri: options.repo,
-            sourceRef: options.ref,
-            extensionRoot: options.root,
-            nonInteractive: options.nonInteractive,
-            force: options.force,
-            stage: options.stage,
-        });
-    }
-    else {
-        const extensionYamlDirectory = (0, localHelper_1.findExtensionYaml)(process.cwd());
-        res = await (0, extensionsHelper_1.publishExtensionVersionFromLocalSource)({
-            publisherId,
-            extensionId,
-            rootDirectory: extensionYamlDirectory,
-            nonInteractive: options.nonInteractive,
-            force: options.force,
-            stage: (_a = options.stage) !== null && _a !== void 0 ? _a : "stable",
-        });
-    }
-    if (res) {
-        utils.logLabeledBullet(extensionsHelper_1.logPrefix, (0, marked_1.marked)(`[Install Link](${(0, publishHelpers_1.consoleInstallLink)(res.ref)})`));
+    (0, utils_1.logLabeledWarning)("Extensions", "ext:dev:publish has been deprecated and will be removed in the future. Please use ext:dev:upload instead.");
+    if (!options.repo && !options.ref && !options.root) {
+        options.local = true;
     }
-    return res;
+    return (0, ext_dev_upload_1.uploadExtensionAction)(extensionRef, options);
 });

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

@@ -4,21 +4,22 @@ exports.command = void 0;
 const clc = require("colorette");
 const marked_1 = require("marked");
 const command_1 = require("../command");
-const extensionsApi_1 = require("../extensions/extensionsApi");
+const publisherApi_1 = require("../extensions/publisherApi");
 const projectUtils_1 = require("../projectUtils");
 const prompt_1 = require("../prompt");
 const extensionsHelper_1 = require("../extensions/extensionsHelper");
-const askUserForConsent_1 = require("../extensions/askUserForConsent");
+const tos_1 = require("../extensions/tos");
 const requirePermissions_1 = require("../requirePermissions");
 const error_1 = require("../error");
 const utils = require("../utils");
 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.ensureExtensionsPublisherApiEnabled)
     .before(extensionsHelper_1.ensureExtensionsApiEnabled)
     .action(async (options) => {
-    await (0, askUserForConsent_1.promptForPublisherTOS)();
     const projectId = (0, projectUtils_1.needProjectId)(options);
+    await (0, tos_1.acceptLatestPublisherTOS)(options, projectId);
     const msg = "What would you like to register as your publisher ID? " +
         "This value identifies you in Firebase's registry of extensions as the author of your extensions. " +
         "Examples: my-company-name, MyGitHubUsername.\n\n" +
@@ -29,8 +30,9 @@ exports.command = new command_1.Command("ext:dev:register")
         message: msg,
         default: projectId,
     });
+    let profile;
     try {
-        await (0, extensionsApi_1.registerPublisherProfile)(projectId, publisherId);
+        profile = await (0, publisherApi_1.registerPublisherProfile)(projectId, publisherId);
     }
     catch (err) {
         if (err.status === 409) {
@@ -43,5 +45,6 @@ exports.command = new command_1.Command("ext:dev:register")
         }
         throw new error_1.FirebaseError(`Failed to register publisher ID ${clc.bold(publisherId)} for project ${clc.bold(projectId)}: ${err.message}`);
     }
-    return utils.logLabeledSuccess(extensionsHelper_1.logPrefix, `Publisher ID '${clc.bold(publisherId)}' has been registered to project ${clc.bold(projectId)}`);
+    utils.logLabeledSuccess(extensionsHelper_1.logPrefix, `Publisher ID '${clc.bold(publisherId)}' has been registered to project ${clc.bold(projectId)}. View and edit your profile at ${utils.consoleUrl(projectId, `/publisher`)}`);
+    return profile;
 });

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

@@ -8,14 +8,14 @@ const utils = require("../utils");
 const command_1 = require("../command");
 const prompt_1 = require("../prompt");
 const extensionsHelper_1 = require("../extensions/extensionsHelper");
-const extensionsApi_1 = require("../extensions/extensionsApi");
+const publisherApi_1 = require("../extensions/publisherApi");
 const versionHelper_1 = require("../extensions/versionHelper");
 const requireAuth_1 = require("../requireAuth");
 const error_1 = require("../error");
 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)
+    .before(extensionsHelper_1.ensureExtensionsPublisherApiEnabled)
     .action(async (extensionRef, versionPredicate, options) => {
     const { publisherId, extensionId, version } = refs.parse(extensionRef);
     if (version) {
@@ -26,7 +26,7 @@ exports.command = new command_1.Command("ext:dev:undeprecate <extensionRef> <ver
     }
     const { comparator, targetSemVer } = (0, versionHelper_1.parseVersionPredicate)(versionPredicate);
     const filter = `id${comparator}"${targetSemVer}"`;
-    const extensionVersions = await (0, extensionsApi_1.listExtensionVersions)(extensionRef, filter);
+    const extensionVersions = await (0, publisherApi_1.listExtensionVersions)(extensionRef, filter);
     extensionVersions
         .sort((ev1, ev2) => {
         return -semver.compare(ev1.spec.version, ev2.spec.version);
@@ -51,7 +51,7 @@ exports.command = new command_1.Command("ext:dev:undeprecate <extensionRef> <ver
         throw new error_1.FirebaseError("No extension versions matched the version predicate.");
     }
     await utils.allSettled(extensionVersions.map(async (extensionVersion) => {
-        await (0, extensionsApi_1.undeprecateExtensionVersion)(extensionVersion.ref);
+        await (0, publisherApi_1.undeprecateExtensionVersion)(extensionVersion.ref);
     }));
     utils.logLabeledSuccess(extensionsHelper_1.logPrefix, "successfully undeprecated extension version(s).");
 });

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

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadExtensionAction = exports.command = void 0;
+const clc = require("colorette");
+const marked_1 = require("marked");
+const TerminalRenderer = require("marked-terminal");
+const command_1 = require("../command");
+const extensionsHelper_1 = require("../extensions/extensionsHelper");
+const refs = require("../extensions/refs");
+const localHelper_1 = require("../extensions/localHelper");
+const publishHelpers_1 = require("../extensions/publishHelpers");
+const requireAuth_1 = require("../requireAuth");
+const error_1 = require("../error");
+const tos_1 = require("../extensions/tos");
+const utils = require("../utils");
+const publisherApi_1 = require("../extensions/publisherApi");
+const extensionsHelper_2 = require("../extensions/extensionsHelper");
+const projects_1 = require("../management/projects");
+marked_1.marked.setOptions({
+    renderer: new TerminalRenderer(),
+});
+exports.command = new command_1.Command("ext:dev:upload <extensionRef>")
+    .description(`upload a new version of an extension`)
+    .option(`-s, --stage <stage>`, `release stage (supports "alpha", "beta", "rc", and "stable")`)
+    .option(`--repo <repo>`, `Public GitHub repo URI that contains the extension source`)
+    .option(`--ref <ref>`, `commit hash, branch, or tag to build from the repo (defaults to HEAD)`)
+    .option(`--root <root>`, `root directory that contains this extension (defaults to last uploaded root or "/" if none set)`)
+    .option(`--local`, `upload from local source instead`)
+    .withForce()
+    .help("if you have not previously uploaded a version of this extension, this will " +
+    "create the extension. If you have previously uploaded a version of this extension, this version must " +
+    "be greater than previous versions.")
+    .before(requireAuth_1.requireAuth)
+    .before(extensionsHelper_1.ensureExtensionsPublisherApiEnabled)
+    .action(uploadExtensionAction);
+async function uploadExtensionAction(extensionRef, options) {
+    const { publisherId, extensionId, version } = refs.parse(extensionRef);
+    if (version) {
+        throw new error_1.FirebaseError(`The input extension reference must be of the format ${clc.bold("<publisherId>/<extensionId>")}. Version should not be supplied and will be inferred directly from extension.yaml. Please increment the version in extension.yaml if you would like to bump/specify a version.`);
+    }
+    if (!publisherId || !extensionId) {
+        throw new error_1.FirebaseError(`Error parsing publisher ID and extension ID from extension reference '${clc.bold(extensionRef)}'. Please use the format '${clc.bold("<publisherId>/<extensionId>")}'.`);
+    }
+    let profile;
+    try {
+        profile = await (0, publisherApi_1.getPublisherProfile)("-", publisherId);
+    }
+    catch (err) {
+        if (err.status === 404) {
+            throw (0, extensionsHelper_1.getMissingPublisherError)(publisherId);
+        }
+        throw err;
+    }
+    const projectNumber = `${(0, extensionsHelper_2.getPublisherProjectFromName)(profile.name)}`;
+    const { projectId } = await (0, projects_1.getFirebaseProject)(projectNumber);
+    await (0, tos_1.acceptLatestPublisherTOS)(options, projectNumber);
+    let res;
+    if (options.local) {
+        const extensionYamlDirectory = (0, localHelper_1.findExtensionYaml)(process.cwd());
+        res = await (0, extensionsHelper_1.uploadExtensionVersionFromLocalSource)({
+            publisherId,
+            extensionId,
+            rootDirectory: extensionYamlDirectory,
+            nonInteractive: options.nonInteractive,
+            force: options.force,
+            stage: options.stage,
+        });
+    }
+    else {
+        res = await (0, extensionsHelper_1.uploadExtensionVersionFromGitHubSource)({
+            publisherId,
+            extensionId,
+            repoUri: options.repo,
+            sourceRef: options.ref,
+            extensionRoot: options.root,
+            nonInteractive: options.nonInteractive,
+            force: options.force,
+            stage: options.stage,
+        });
+    }
+    if (res) {
+        utils.logLabeledBullet(extensionsHelper_1.logPrefix, (0, marked_1.marked)(`[Install Link](${(0, publishHelpers_1.consoleInstallLink)(res.ref)})`));
+        const version = res.ref.split("@")[1];
+        utils.logLabeledBullet(extensionsHelper_1.logPrefix, (0, marked_1.marked)(`[View in Console](${utils.consoleUrl(projectId, `/publisher/extensions/${extensionId}/v/${version}`)})`));
+    }
+    return res;
+}
+exports.uploadExtensionAction = uploadExtensionAction;

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

@@ -9,7 +9,7 @@ const cloudmonitoring_1 = require("../gcp/cloudmonitoring");
 const requireAuth_1 = require("../requireAuth");
 const checkMinRequiredVersion_1 = require("../checkMinRequiredVersion");
 const metricsUtils_1 = require("../extensions/metricsUtils");
-const extensionsApi_1 = require("../extensions/extensionsApi");
+const publisherApi_1 = require("../extensions/publisherApi");
 const extensionsHelper_1 = require("../extensions/extensionsHelper");
 const error_1 = require("../error");
 const logger_1 = require("../logger");
@@ -33,7 +33,7 @@ exports.command = new command_1.Command("ext:dev:usage <publisherId>")
         publisherId = input;
         let extensions;
         try {
-            extensions = await (0, extensionsApi_1.listExtensions)(publisherId);
+            extensions = await (0, publisherApi_1.listExtensions)(publisherId);
         }
         catch (err) {
             throw new error_1.FirebaseError(err);
@@ -57,7 +57,7 @@ exports.command = new command_1.Command("ext:dev:usage <publisherId>")
             }),
         });
     }
-    const profile = await (0, extensionsApi_1.getPublisherProfile)("-", publisherId);
+    const profile = await (0, publisherApi_1.getPublisherProfile)("-", publisherId);
     const projectNumber = (0, extensionsHelper_1.getPublisherProjectFromName)(profile.name);
     const past45d = new Date();
     past45d.setDate(past45d.getDate() - 45);

package/lib/commands/ext-install.js

@@ -13,25 +13,21 @@ const projectUtils_1 = require("../projectUtils");
 const extensionsApi = require("../extensions/extensionsApi");
 const refs = require("../extensions/refs");
 const secretsUtils = require("../extensions/secretsUtils");
-const warnings_1 = require("../extensions/warnings");
 const paramHelper = require("../extensions/paramHelper");
 const extensionsHelper_1 = require("../extensions/extensionsHelper");
-const prompt_1 = require("../prompt");
 const utils_1 = require("../extensions/utils");
 const requirePermissions_1 = require("../requirePermissions");
 const utils = require("../utils");
 const track_1 = require("../track");
-const experiments = require("../experiments");
+const prompt_1 = require("../prompt");
 const manifest = require("../extensions/manifest");
+const tos_1 = require("../extensions/tos");
 marked_1.marked.setOptions({
     renderer: new TerminalRenderer(),
 });
 exports.command = new command_1.Command("ext:install [extensionName]")
-    .description("install an official extension if [extensionName] or [extensionName@version] is provided; " +
-    (experiments.isEnabled("extdev")
-        ? "install a local extension if [localPathOrUrl] or [url#root] is provided; install a published extension (not authored by Firebase) if [publisherId/extensionId] is provided "
-        : "") +
-    "or run with `-i` to see all available extensions.")
+    .description("add an uploaded extension to firebase.json if [publisherId/extensionId] is provided;" +
+    "or, add a local extension if [localPath] is provided")
     .option("--local", "deprecated")
     .withForce()
     .before(requirePermissions_1.requirePermissions, ["firebaseextensions.instances.create"])
@@ -118,7 +114,6 @@ exports.command = new command_1.Command("ext:install [extensionName]")
 async function infoExtensionVersion(args) {
     const ref = refs.parse(args.extensionName);
     await (0, displayExtensionInfo_1.displayExtInfo)(args.extensionName, ref.publisherId, args.extensionVersion.spec, true);
-    await (0, warnings_1.displayWarningPrompts)(ref.publisherId, args.extensionVersion);
 }
 async function installToManifest(options) {
     var _a, _b, _c;
@@ -162,5 +157,5 @@ async function installToManifest(options) {
             extensionSpec: spec,
         },
     ], config, { nonInteractive, force: force !== null && force !== void 0 ? force : false });
-    manifest.showPostDeprecationNotice();
+    (0, tos_1.displayDeveloperTOSWarning)();
 }

package/lib/commands/ext-uninstall.js

@@ -26,5 +26,4 @@ exports.command = new command_1.Command("ext:uninstall <extensionInstanceId>")
     }
     const config = manifest.loadConfig(options);
     manifest.removeFromManifest(instanceId, config);
-    manifest.showPostDeprecationNotice();
 });

package/lib/commands/ext-update.js

@@ -14,19 +14,17 @@ const updateHelper_1 = require("../extensions/updateHelper");
 const secretsUtils = require("../extensions/secretsUtils");
 const refs = require("../extensions/refs");
 const projectUtils_1 = require("../projectUtils");
-const prompt_1 = require("../prompt");
 const requirePermissions_1 = require("../requirePermissions");
 const utils = require("../utils");
-const experiments = require("../experiments");
+const prompt_1 = require("../prompt");
 const manifest = require("../extensions/manifest");
 const askUserForEventsConfig = require("../extensions/askUserForEventsConfig");
+const tos_1 = require("../extensions/tos");
 marked_1.marked.setOptions({
     renderer: new TerminalRenderer(),
 });
 exports.command = new command_1.Command("ext:update <extensionInstanceId> [updateSource]")
-    .description(experiments.isEnabled("extdev")
-    ? "update an existing extension instance to the latest version or from a local or URL source"
-    : "update an existing extension instance to the latest version")
+    .description("update an existing extension instance to the latest version, or to a specific version if provided")
     .before(requirePermissions_1.requirePermissions, [
     "firebaseextensions.instances.update",
     "firebaseextensions.instances.get",
@@ -34,14 +32,10 @@ exports.command = new command_1.Command("ext:update <extensionInstanceId> [updat
     .before(extensionsHelper_1.ensureExtensionsApiEnabled)
     .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extMinVersion")
     .before(extensionsHelper_1.diagnoseAndFixProject)
-    .option("--local", "deprecated")
     .withForce()
     .action(async (instanceId, updateSource, options) => {
     const projectId = (0, projectUtils_1.getProjectId)(options);
     const config = manifest.loadConfig(options);
-    if (options.local) {
-        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.");
-    }
     const oldRefOrPath = manifest.getInstanceTarget(instanceId, config);
     if ((0, extensionsHelper_1.isLocalPath)(oldRefOrPath)) {
         throw new error_1.FirebaseError(`Updating an extension with local source is not neccessary. ` +
@@ -107,6 +101,6 @@ exports.command = new command_1.Command("ext:update <extensionInstanceId> [updat
         nonInteractive: options.nonInteractive,
         force: true,
     });
-    manifest.showPostDeprecationNotice();
+    (0, tos_1.displayDeveloperTOSWarning)();
     return;
 });

package/lib/commands/index.js

@@ -80,25 +80,15 @@ function load(client) {
     client.ext.list = loadCommand("ext-list");
     client.ext.uninstall = loadCommand("ext-uninstall");
     client.ext.update = loadCommand("ext-update");
-    if (experiments.isEnabled("ext")) {
-        client.ext.sources = {};
-        client.ext.sources.create = loadCommand("ext-sources-create");
-    }
-    if (experiments.isEnabled("extdev")) {
-        client.ext.dev = {};
-        client.ext.dev.init = loadCommand("ext-dev-init");
-        client.ext.dev.list = loadCommand("ext-dev-list");
-        client.ext.dev.register = loadCommand("ext-dev-register");
-        client.ext.dev.emulators = {};
-        client.ext.dev.emulators.start = loadCommand("ext-dev-emulators-start");
-        client.ext.dev.emulators.exec = loadCommand("ext-dev-emulators-exec");
-        client.ext.dev.deprecate = loadCommand("ext-dev-deprecate");
-        client.ext.dev.undeprecate = loadCommand("ext-dev-undeprecate");
-        client.ext.dev.unpublish = loadCommand("ext-dev-unpublish");
-        client.ext.dev.publish = loadCommand("ext-dev-publish");
-        client.ext.dev.delete = loadCommand("ext-dev-extension-delete");
-        client.ext.dev.usage = loadCommand("ext-dev-usage");
-    }
+    client.ext.dev = {};
+    client.ext.dev.init = loadCommand("ext-dev-init");
+    client.ext.dev.list = loadCommand("ext-dev-list");
+    client.ext.dev.register = loadCommand("ext-dev-register");
+    client.ext.dev.deprecate = loadCommand("ext-dev-deprecate");
+    client.ext.dev.undeprecate = loadCommand("ext-dev-undeprecate");
+    client.ext.dev.upload = loadCommand("ext-dev-upload");
+    client.ext.dev.publish = loadCommand("ext-dev-publish");
+    client.ext.dev.usage = loadCommand("ext-dev-usage");
     client.firestore = {};
     client.firestore.delete = loadCommand("firestore-delete");
     client.firestore.indexes = loadCommand("firestore-indexes-list");

package/lib/deploy/extensions/planner.js

@@ -129,17 +129,23 @@ async function want(args) {
 exports.want = want;
 async function resolveVersion(ref) {
     const extensionRef = refs.toExtensionRef(ref);
+    const extension = await extensionsApi.getExtension(extensionRef);
+    if (!ref.version || ref.version === "latest-approved") {
+        if (!extension.latestApprovedVersion) {
+            throw new error_1.FirebaseError(`${extensionRef} has not been published to Extensions Hub (https://extensions.dev). To install it, you must specify the version you want to install.`);
+        }
+        return extension.latestApprovedVersion;
+    }
+    if (ref.version === "latest") {
+        if (!extension.latestVersion) {
+            throw new error_1.FirebaseError(`${extensionRef} has no stable non-deprecated versions. If you wish to install a prerelease version, you must specify the version you want to install.`);
+        }
+        return extension.latestVersion;
+    }
     const versions = await extensionsApi.listExtensionVersions(extensionRef, undefined, true);
     if (versions.length === 0) {
         throw new error_1.FirebaseError(`No versions found for ${extensionRef}`);
     }
-    if (!ref.version || ref.version === "latest") {
-        return versions
-            .filter((ev) => ev.spec.version !== undefined)
-            .map((ev) => ev.spec.version)
-            .sort(semver.compare)
-            .pop();
-    }
     const maxSatisfying = semver.maxSatisfying(versions.map((ev) => ev.spec.version), ref.version);
     if (!maxSatisfying) {
         throw new error_1.FirebaseError(`No version of ${extensionRef} matches requested version ${ref.version}`);