firebase-tools 11.25.3 → 11.27.0

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

@@ -17,7 +17,10 @@ marked_1.marked.setOptions({
 });
 exports.command = new command_1.Command("ext:dev:publish <extensionRef>")
     .description(`publish a new version of an extension`)
-    .option(`-s, --stage <stage>`, `release stage (supports "rc", "alpha", "beta", and "stable")`)
+    .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(`--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)`)
     .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 " +
@@ -32,15 +35,30 @@ exports.command = new command_1.Command("ext:dev:publish <extensionRef>")
     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>")}'.`);
     }
-    const extensionYamlDirectory = (0, localHelper_1.findExtensionYaml)(process.cwd());
-    const 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",
-    });
+    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)})`));
     }

package/lib/commands/ext-install.js

@@ -115,9 +115,8 @@ exports.command = new command_1.Command("ext:install [extensionName]")
 });
 async function infoExtensionVersion(args) {
     const ref = refs.parse(args.extensionName);
-    const extension = await extensionsApi.getExtension(refs.toExtensionRef(ref));
     await (0, displayExtensionInfo_1.displayExtInfo)(args.extensionName, ref.publisherId, args.extensionVersion.spec, true);
-    await (0, warnings_1.displayWarningPrompts)(ref.publisherId, extension.registryLaunchStage, args.extensionVersion);
+    await (0, warnings_1.displayWarningPrompts)(ref.publisherId, args.extensionVersion);
 }
 async function installToManifest(options) {
     var _a, _b;

package/lib/deploy/functions/backend.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.compareFunctions = exports.missingEndpoint = exports.hasEndpoint = exports.regionalEndpoints = exports.matchingBackend = exports.findEndpoint = exports.someEndpoint = exports.allEndpoints = exports.checkAvailability = exports.existingBackend = exports.scheduleIdForFunction = exports.functionName = exports.isEmptyBackend = exports.merge = exports.of = exports.empty = exports.isBlockingTriggered = exports.isTaskQueueTriggered = exports.isScheduleTriggered = exports.isEventTriggered = exports.isCallableTriggered = exports.isHttpsTriggered = exports.AllFunctionsPlatforms = exports.secretVersionName = exports.SCHEDULED_FUNCTION_LABEL = exports.MIN_CPU_FOR_CONCURRENCY = exports.DEFAULT_MEMORY = exports.DEFAULT_CONCURRENCY = exports.memoryToGen2Cpu = exports.memoryToGen1Cpu = exports.memoryOptionDisplayName = exports.isValidMemoryOption = exports.AllIngressSettings = exports.AllVpcEgressSettings = exports.endpointTriggerType = void 0;
 const gcf = require("../../gcp/cloudfunctions");
 const gcfV2 = require("../../gcp/cloudfunctionsv2");
-const run = require("../../gcp/run");
 const utils = require("../../utils");
 const error_1 = require("../../error");
 const functional_1 = require("../../functional");
@@ -195,11 +194,8 @@ async function loadExistingBackend(ctx) {
     let gcfV2Results;
     try {
         gcfV2Results = await gcfV2.listAllFunctions(ctx.projectId);
-        const runResults = await Promise.all(gcfV2Results.functions.map((fn) => run.getService(fn.serviceConfig.service)));
-        for (const [apiFunction, runService] of (0, functional_1.zip)(gcfV2Results.functions, runResults)) {
+        for (const apiFunction of gcfV2Results.functions) {
             const endpoint = gcfV2.endpointFromFunction(apiFunction);
-            endpoint.concurrency = runService.spec.template.spec.containerConcurrency || 1;
-            endpoint.cpu = +runService.spec.template.spec.containers[0].resources.limits.cpu;
             ctx.existingBackend.endpoints[endpoint.region] =
                 ctx.existingBackend.endpoints[endpoint.region] || {};
             ctx.existingBackend.endpoints[endpoint.region][endpoint.id] = endpoint;

package/lib/deploy/functions/release/fabricator.js

@@ -219,7 +219,7 @@ class Fabricator {
         }
     }
     async createV2Function(endpoint) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         const storage = (_a = this.sources[endpoint.codebase]) === null || _a === void 0 ? void 0 : _a.storage;
         if (!storage) {
             logger_1.logger.debug("Precondition failed. Cannot create a GCFv2 function without storage");
@@ -274,8 +274,13 @@ class Fabricator {
             return await poller.pollOperation(Object.assign(Object.assign({}, gcfV2PollerOptions), { pollerName: `create-${endpoint.codebase}-${endpoint.region}-${endpoint.id}`, operationResourceName: op.name }));
         })
             .catch(rethrowAs(endpoint, "create"));
-        endpoint.uri = resultFunction.serviceConfig.uri;
-        const serviceName = resultFunction.serviceConfig.service;
+        endpoint.uri = (_d = resultFunction.serviceConfig) === null || _d === void 0 ? void 0 : _d.uri;
+        const serviceName = (_e = resultFunction.serviceConfig) === null || _e === void 0 ? void 0 : _e.service;
+        if (!serviceName) {
+            logger_1.logger.debug("Result function unexpectedly didn't have a service name.");
+            utils.logLabeledWarning("functions", "Updated function is not associated with a service. This deployment is in an unexpected state - please re-deploy your functions.");
+            return;
+        }
         if (backend.isHttpsTriggered(endpoint)) {
             const invoker = endpoint.httpsTrigger.invoker || ["public"];
             if (!invoker.includes("private")) {
@@ -346,7 +351,7 @@ class Fabricator {
         }
     }
     async updateV2Function(endpoint) {
-        var _a, _b;
+        var _a, _b, _c, _d;
         const storage = (_a = this.sources[endpoint.codebase]) === null || _a === void 0 ? void 0 : _a.storage;
         if (!storage) {
             logger_1.logger.debug("Precondition failed. Cannot update a GCFv2 function without storage");
@@ -362,8 +367,13 @@ class Fabricator {
             return await poller.pollOperation(Object.assign(Object.assign({}, gcfV2PollerOptions), { pollerName: `update-${endpoint.codebase}-${endpoint.region}-${endpoint.id}`, operationResourceName: op.name }));
         })
             .catch(rethrowAs(endpoint, "update"));
-        endpoint.uri = resultFunction.serviceConfig.uri;
-        const serviceName = resultFunction.serviceConfig.service;
+        endpoint.uri = (_c = resultFunction.serviceConfig) === null || _c === void 0 ? void 0 : _c.uri;
+        const serviceName = (_d = resultFunction.serviceConfig) === null || _d === void 0 ? void 0 : _d.service;
+        if (!serviceName) {
+            logger_1.logger.debug("Result function unexpectedly didn't have a service name.");
+            utils.logLabeledWarning("functions", "Updated function is not associated with a service. This deployment is in an unexpected state - please re-deploy your functions.");
+            return;
+        }
         let invoker;
         if (backend.isHttpsTriggered(endpoint)) {
             invoker = endpoint.httpsTrigger.invoker === null ? ["public"] : endpoint.httpsTrigger.invoker;

package/lib/emulator/functionsEmulator.js

@@ -82,15 +82,15 @@ class FunctionsEmulator {
         this.logger = emulatorLogger_1.EmulatorLogger.forEmulator(types_1.Emulators.FUNCTIONS);
         this.multicastTriggers = {};
         this.blockingFunctionsConfig = {};
+        this.debugMode = false;
         emulatorLogger_1.EmulatorLogger.verbosity = this.args.quiet ? emulatorLogger_1.Verbosity.QUIET : emulatorLogger_1.Verbosity.DEBUG;
         if (this.args.debugPort) {
             this.args.disabledRuntimeFeatures = this.args.disabledRuntimeFeatures || {};
             this.args.disabledRuntimeFeatures.timeout = true;
+            this.debugMode = true;
         }
         this.adminSdkConfig = Object.assign(Object.assign({}, this.args.adminSdkConfig), { projectId: this.args.projectId });
-        const mode = this.args.debugPort
-            ? types_1.FunctionsExecutionMode.SEQUENTIAL
-            : types_1.FunctionsExecutionMode.AUTO;
+        const mode = this.debugMode ? types_1.FunctionsExecutionMode.SEQUENTIAL : types_1.FunctionsExecutionMode.AUTO;
         this.workerPools = {};
         for (const backend of this.args.emulatableBackends) {
             const pool = new functionsRuntimeWorker_1.RuntimeWorkerPool(mode);
@@ -204,6 +204,12 @@ class FunctionsEmulator {
             }
         }
         const worker = pool.getIdleWorker(trigger.id);
+        if (this.debugMode) {
+            await worker.sendDebugMsg({
+                functionTarget: trigger.entryPoint,
+                functionSignature: (0, functionsEmulatorShared_1.getSignatureType)(trigger),
+            });
+        }
         const reqBody = JSON.stringify(body);
         const headers = {
             "Content-Type": "application/json",
@@ -406,7 +412,7 @@ class FunctionsEmulator {
                 this.logger.logLabeled("SUCCESS", `functions[${definition.id}]`, msg);
             }
         }
-        if (this.args.debugPort) {
+        if (this.debugMode) {
             if (!((_a = emulatableBackend.runtime) === null || _a === void 0 ? void 0 : _a.startsWith("node"))) {
                 this.logger.log("WARN", "--inspect-functions only supported for Node.js runtimes.");
             }
@@ -722,7 +728,7 @@ class FunctionsEmulator {
             emulatorInfos = emulatorInfos.concat(Object.values(this.args.remoteEmulators));
         }
         (0, env_1.setEnvVarsForEmulators)(envs, emulatorInfos);
-        if (this.args.debugPort) {
+        if (this.debugMode) {
             envs["FUNCTION_DEBUG_MODE"] = "true";
         }
         return envs;
@@ -789,7 +795,7 @@ class FunctionsEmulator {
     }
     async startNode(backend, envs) {
         const args = [path.join(__dirname, "functionsEmulatorRuntime")];
-        if (this.args.debugPort) {
+        if (this.debugMode) {
             if (process.env.FIREPIT_VERSION) {
                 this.logger.log("WARN", `To enable function inspection, please run "npm i node@${semver.coerce(backend.runtime || "18.0.0")} --save-dev" in your functions directory`);
             }
@@ -824,7 +830,7 @@ class FunctionsEmulator {
     }
     async startPython(backend, envs) {
         const args = ["functions-framework"];
-        if (this.args.debugPort) {
+        if (this.debugMode) {
             this.logger.log("WARN", "--inspect-functions not supported for Python functions. Ignored.");
         }
         const port = await portfinder.getPortPromise({
@@ -961,12 +967,13 @@ class FunctionsEmulator {
                 return;
             }
         }
-        const debugBundle = this.args.debugPort
-            ? {
+        let debugBundle;
+        if (this.debugMode) {
+            debugBundle = {
                 functionTarget: trigger.entryPoint,
                 functionSignature: (0, functionsEmulatorShared_1.getSignatureType)(trigger),
-            }
-            : undefined;
+            };
+        }
         await pool.submitRequest(trigger.id, {
             method,
             path,

package/lib/emulator/storage/apis/gcloud.js

@@ -135,7 +135,7 @@ function createCloudEndpoints(emulator) {
             items: (_a = listResponse.items) === null || _a === void 0 ? void 0 : _a.map((item) => new metadata_1.CloudStorageObjectMetadata(item)),
         });
     });
-    gcloudStorageAPI.delete("/b/:bucketId/o/:objectId", async (req, res) => {
+    gcloudStorageAPI.delete(["/b/:bucketId/o/:objectId", "/storage/v1/b/:bucketId/o/:objectId"], async (req, res) => {
         try {
             await adminStorageLayer.deleteObject({
                 bucketId: req.params.bucketId,

package/lib/extensions/extensionsApi.js

@@ -391,15 +391,18 @@ async function undeprecateExtensionVersion(extensionRef) {
     }
 }
 exports.undeprecateExtensionVersion = undeprecateExtensionVersion;
-async function publishExtensionVersion(extensionVersionRef, packageUri, extensionRoot) {
-    const ref = refs.parse(extensionVersionRef);
+async function publishExtensionVersion(args) {
+    var _a, _b, _c, _d;
+    const ref = refs.parse(args.extensionVersionRef);
     if (!ref.version) {
-        throw new error_1.FirebaseError(`ExtensionVersion ref "${extensionVersionRef}" must supply a version.`);
+        throw new error_1.FirebaseError(`ExtensionVersion ref "${args.extensionVersionRef}" must supply a version.`);
     }
     const publishRes = await apiClient.post(`/${refs.toExtensionName(ref)}/versions:publish`, {
         versionId: ref.version,
-        packageUri,
-        extensionRoot: extensionRoot !== null && extensionRoot !== void 0 ? extensionRoot : "/",
+        packageUri: (_a = args.packageUri) !== null && _a !== void 0 ? _a : "",
+        extensionRoot: (_b = args.extensionRoot) !== null && _b !== void 0 ? _b : "/",
+        repoUri: (_c = args.repoUri) !== null && _c !== void 0 ? _c : "",
+        sourceRef: (_d = args.sourceRef) !== null && _d !== void 0 ? _d : "",
     });
     const pollRes = await operationPoller.pollOperation({
         apiOrigin: api_1.extensionsOrigin,

package/lib/extensions/extensionsHelper.js

@@ -1,9 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.canonicalizeRefInput = exports.diagnoseAndFixProject = exports.confirm = exports.getSourceOrigin = exports.isLocalOrURLPath = exports.isLocalPath = exports.isUrlPath = exports.instanceIdExists = exports.promptForRepeatInstance = exports.promptForOfficialExtension = exports.displayReleaseNotes = exports.getPublisherProjectFromName = exports.createSourceFromLocation = exports.publishExtensionVersionFromLocalSource = exports.incrementPrereleaseVersion = exports.ensureExtensionsApiEnabled = exports.promptForValidInstanceId = exports.validateSpec = exports.validateCommandLineParams = exports.populateDefaultParams = exports.substituteParams = exports.getFirebaseProjectParams = exports.getDBInstanceFromURL = exports.AUTOPOULATED_PARAM_PLACEHOLDERS = exports.EXTENSIONS_BUCKET_NAME = exports.URL_REGEX = exports.logPrefix = exports.SourceOrigin = exports.SpecParamType = void 0;
+exports.canonicalizeRefInput = exports.diagnoseAndFixProject = exports.confirm = exports.getSourceOrigin = exports.isLocalOrURLPath = exports.isLocalPath = exports.isUrlPath = exports.instanceIdExists = exports.promptForRepeatInstance = exports.promptForOfficialExtension = exports.displayReleaseNotes = exports.getPublisherProjectFromName = exports.createSourceFromLocation = exports.publishExtensionVersionFromLocalSource = exports.publishExtensionVersionFromRemoteRepo = exports.incrementPrereleaseVersion = exports.ensureExtensionsApiEnabled = exports.promptForValidRepoURI = exports.promptForValidInstanceId = exports.validateSpec = exports.validateCommandLineParams = exports.populateDefaultParams = exports.substituteParams = exports.getFirebaseProjectParams = exports.getDBInstanceFromURL = exports.resourceTypeToNiceName = exports.AUTOPOULATED_PARAM_PLACEHOLDERS = exports.EXTENSIONS_BUCKET_NAME = exports.URL_REGEX = exports.logPrefix = exports.SourceOrigin = exports.SpecParamType = void 0;
 const clc = require("colorette");
 const ora = require("ora");
 const semver = require("semver");
+const tmp = require("tmp");
+const fs = require("fs-extra");
+const unzipper = require("unzipper");
+const node_fetch_1 = require("node-fetch");
+const path = require("path");
 const marked_1 = require("marked");
 const TerminalRenderer = require("marked-terminal");
 marked_1.marked.setOptions({
@@ -66,6 +71,11 @@ exports.AUTOPOULATED_PARAM_PLACEHOLDERS = {
     DATABASE_INSTANCE: "project-id-default-rtdb",
     DATABASE_URL: "https://project-id-default-rtdb.firebaseio.com",
 };
+exports.resourceTypeToNiceName = {
+    "firebaseextensions.v1beta.function": "Cloud Function",
+};
+const repoRegex = new RegExp(`^https:\/\/github\.com\/[^\/]+\/[^\/]+$`);
+const stageOptions = ["alpha", "beta", "rc", "stable"];
 function getDBInstanceFromURL(databaseUrl = "") {
     const instanceRegex = new RegExp("(?:https://)(.*)(?:.firebaseio.com)");
     const matches = instanceRegex.exec(databaseUrl);
@@ -263,6 +273,24 @@ async function promptForValidInstanceId(instanceId) {
     return newInstanceId;
 }
 exports.promptForValidInstanceId = promptForValidInstanceId;
+async function promptForValidRepoURI() {
+    let repoIsValid = false;
+    let extensionRoot = "";
+    while (!repoIsValid) {
+        extensionRoot = await (0, prompt_1.promptOnce)({
+            type: "input",
+            message: "Enter the GitHub repo URI where this Extension's source code is located:",
+        });
+        if (!repoRegex.test(extensionRoot)) {
+            logger_1.logger.info("Repo URI must follow this format: https://github.com/<user>/<repo>");
+        }
+        else {
+            repoIsValid = true;
+        }
+    }
+    return extensionRoot;
+}
+exports.promptForValidRepoURI = promptForValidRepoURI;
 async function ensureExtensionsApiEnabled(options) {
     const projectId = (0, projectUtils_1.getProjectId)(options);
     if (!projectId) {
@@ -281,7 +309,6 @@ async function archiveAndUploadSource(extPath, bucketName) {
 }
 async function incrementPrereleaseVersion(ref, extensionVersion, stage) {
     var _a;
-    const stageOptions = ["stable", "alpha", "beta", "rc"];
     if (!stageOptions.includes(stage)) {
         throw new error_1.FirebaseError(`--stage flag only supports the following values: ${stageOptions}`);
     }
@@ -306,7 +333,8 @@ async function incrementPrereleaseVersion(ref, extensionVersion, stage) {
     return extensionVersion;
 }
 exports.incrementPrereleaseVersion = incrementPrereleaseVersion;
-async function publishExtensionVersionFromLocalSource(args) {
+async function validateExtensionSpec(args) {
+    const extensionRef = `${args.publisherId}/${args.extensionId}`;
     const extensionSpec = await (0, localHelper_1.getLocalExtensionSpec)(args.rootDirectory);
     if (extensionSpec.name !== args.extensionId) {
         throw new error_1.FirebaseError(`Extension ID '${clc.bold(args.extensionId)}' does not match the name in extension.yaml '${clc.bold(extensionSpec.name)}'.`);
@@ -314,13 +342,7 @@ async function publishExtensionVersionFromLocalSource(args) {
     const subbedSpec = JSON.parse(JSON.stringify(extensionSpec));
     subbedSpec.params = substituteParams(extensionSpec.params || [], exports.AUTOPOULATED_PARAM_PLACEHOLDERS);
     validateSpec(subbedSpec);
-    extensionSpec.version = await incrementPrereleaseVersion(`${args.publisherId}/${args.extensionId}`, extensionSpec.version, args.stage);
-    let extension;
-    try {
-        extension = await (0, extensionsApi_1.getExtension)(`${args.publisherId}/${args.extensionId}`);
-    }
-    catch (err) {
-    }
+    extensionSpec.version = await incrementPrereleaseVersion(extensionRef, extensionSpec.version, args.stage);
     let notes;
     try {
         const changes = (0, change_log_1.getLocalChangelog)(args.rootDirectory);
@@ -331,30 +353,197 @@ async function publishExtensionVersionFromLocalSource(args) {
             "Please create one and add an entry for this version. " +
             (0, marked_1.marked)("See https://firebase.google.com/docs/extensions/alpha/create-user-docs#writing-changelog for more details."));
     }
-    if (!notes && !semver.prerelease(extensionSpec.version) && extension) {
+    if (!notes && !semver.prerelease(extensionSpec.version) && args.latestVersion) {
         throw new error_1.FirebaseError(`No entry for version ${extensionSpec.version} found in CHANGELOG.md. ` +
             "Please add one so users know what has changed in this version. " +
             (0, marked_1.marked)("See https://firebase.google.com/docs/extensions/alpha/create-user-docs#writing-changelog for more details."));
     }
-    displayReleaseNotes(args.publisherId, args.extensionId, extensionSpec.version, notes);
-    if (!(await confirm({
+    if (args.latestVersion) {
+        if (semver.lt(extensionSpec.version, args.latestVersion)) {
+            throw new error_1.FirebaseError(`The version you are trying to publish (${clc.bold(extensionSpec.version)}) is lower than the current version (${clc.bold(args.latestVersion)}) for the extension '${clc.bold(extensionRef)}'. Please make sure this version is greater than the current version (${clc.bold(args.latestVersion)}) inside of extension.yaml.\n`, { exit: 104 });
+        }
+        else if (semver.eq(extensionSpec.version, args.latestVersion)) {
+            throw new error_1.FirebaseError(`The version you are trying to publish (${clc.bold(extensionSpec.version)}) already exists for Extension '${clc.bold(extensionRef)}'. Please increment the version inside of extension.yaml.\n`, { exit: 103 });
+        }
+    }
+    return { extensionSpec, notes };
+}
+async function publishExtensionVersionFromRemoteRepo(args) {
+    const extensionRef = `${args.publisherId}/${args.extensionId}`;
+    let extension;
+    try {
+        extension = await (0, extensionsApi_1.getExtension)(extensionRef);
+    }
+    catch (err) {
+    }
+    if (args.repoUri && !repoRegex.test(args.repoUri)) {
+        throw new error_1.FirebaseError("Repo URI must follow this format: https://github.com/<user>/<repo>");
+    }
+    let repoUri = args.repoUri || (extension === null || extension === void 0 ? void 0 : extension.repoUri);
+    if (!repoUri) {
+        if (!args.nonInteractive) {
+            repoUri = await promptForValidRepoURI();
+        }
+        else {
+            throw new error_1.FirebaseError("Repo URI is required but not currently set.");
+        }
+    }
+    if ((extension === null || extension === void 0 ? void 0 : extension.repoUri) && extension.repoUri !== repoUri) {
+        throw new error_1.FirebaseError(`Repo URI '${clc.bold(args.repoUri)}' does not match repo URI '${clc.bold(extension.repoUri)}' already associated with Extension ${clc.bold(extensionRef)}. Repo URI cannot be changed.`);
+    }
+    if (!(extension === null || extension === void 0 ? void 0 : extension.repoUri)) {
+        logger_1.logger.info(`\n${clc.red("Warning:")} You are about to associate repo URI ${clc.bold(repoUri)} with Extension ${clc.bold(extensionRef)}. This cannot be changed. All future verifiable versions must be published from this repo. ` +
+            `You can continue publishing unverifiable versions from local source.`);
+        const confirmed = await confirm({
+            nonInteractive: args.nonInteractive,
+            force: args.force,
+            default: false,
+        });
+        if (!confirmed) {
+            return;
+        }
+    }
+    else {
+        logger_1.logger.info(`Extension ${clc.bold(extensionRef)} is published from ${clc.bold(extension === null || extension === void 0 ? void 0 : extension.repoUri)}.`);
+    }
+    let extensionRoot = args.extensionRoot;
+    let defaultRoot = "/";
+    if (!extensionRoot) {
+        if (extension) {
+            try {
+                const extensionVersionRef = `${extensionRef}@${extension.latestVersion}`;
+                const extensionVersion = await (0, extensionsApi_1.getExtensionVersion)(extensionVersionRef);
+                if (extensionVersion.extensionRoot) {
+                    defaultRoot = extensionVersion.extensionRoot;
+                }
+            }
+            catch (err) {
+            }
+        }
+        extensionRoot = defaultRoot;
+        if (!args.nonInteractive) {
+            extensionRoot = await (0, prompt_1.promptOnce)({
+                type: "input",
+                message: "Enter this Extension's root directory in the repo (defaults to previous root if set):",
+                default: defaultRoot,
+            });
+        }
+    }
+    let sourceRef = args.sourceRef;
+    const defaultSourceRef = "HEAD";
+    if (!sourceRef) {
+        if (!args.nonInteractive) {
+            sourceRef = await (0, prompt_1.promptOnce)({
+                type: "input",
+                message: "Enter the commit hash, branch, or tag name to build from in the repo:",
+                default: defaultSourceRef,
+            });
+        }
+        else {
+            sourceRef = defaultSourceRef;
+        }
+    }
+    let stage = args.stage;
+    const defaultStage = "rc";
+    if (!stage) {
+        if (!args.nonInteractive) {
+            stage = await (0, prompt_1.promptOnce)({
+                type: "list",
+                message: "Choose the release stage (pre-release annotations will be auto-incremented):",
+                choices: stageOptions,
+                default: defaultStage,
+            });
+        }
+        else {
+            stage = defaultStage;
+        }
+    }
+    logger_1.logger.info("Downloading and validating source code...");
+    const archiveUri = `${repoUri}/archive/${sourceRef}.zip`;
+    const tempDirectory = tmp.dirSync({ unsafeCleanup: true });
+    try {
+        const response = await (0, node_fetch_1.default)(archiveUri);
+        if (response.ok) {
+            await response.body.pipe(unzipper.Extract({ path: tempDirectory.name })).promise();
+        }
+    }
+    catch (err) {
+        throw new error_1.FirebaseError(`Failed to fetch Extension archive ${archiveUri}. Please check the repo URI and source ref. ${err}`);
+    }
+    const archiveName = fs.readdirSync(tempDirectory.name)[0];
+    const rootDirectory = path.join(tempDirectory.name, archiveName, extensionRoot);
+    try {
+        (0, localHelper_1.readFile)(path.resolve(rootDirectory, localHelper_1.EXTENSIONS_SPEC_FILE));
+    }
+    catch (err) {
+        throw new error_1.FirebaseError(`Failed to find ${clc.bold(localHelper_1.EXTENSIONS_SPEC_FILE)} in directory ${clc.bold(extensionRoot)}. Please verify the root and try again.`);
+    }
+    const { extensionSpec, notes } = await validateExtensionSpec({
+        publisherId: args.publisherId,
+        extensionId: args.extensionId,
+        rootDirectory: rootDirectory,
+        latestVersion: extension === null || extension === void 0 ? void 0 : extension.latestVersion,
+        stage: stage,
+    });
+    const sourceUri = path.join(repoUri, "tree", sourceRef, extensionRoot);
+    displayReleaseNotes(extensionRef, extensionSpec.version, notes, sourceUri);
+    const confirmed = await confirm({
         nonInteractive: args.nonInteractive,
         force: args.force,
         default: false,
-    }))) {
+    });
+    if (!confirmed) {
         return;
     }
-    if (extension &&
-        extension.latestVersion &&
-        semver.lt(extensionSpec.version, extension.latestVersion)) {
-        throw new error_1.FirebaseError(`The version you are trying to publish (${clc.bold(extensionSpec.version)}) is lower than the current version (${clc.bold(extension.latestVersion)}) for the extension '${clc.bold(`${args.publisherId}/${args.extensionId}`)}'. Please make sure this version is greater than the current version (${clc.bold(extension.latestVersion)}) inside of extension.yaml.\n`, { exit: 104 });
+    const extensionVersionRef = `${extensionRef}@${extensionSpec.version}`;
+    const publishSpinner = ora(`Publishing ${clc.bold(extensionVersionRef)}`);
+    let res;
+    try {
+        publishSpinner.start();
+        res = await (0, extensionsApi_1.publishExtensionVersion)({
+            extensionVersionRef,
+            packageUri: "",
+            extensionRoot,
+            repoUri,
+            sourceRef: args.sourceRef,
+        });
+        publishSpinner.succeed(` Successfully published ${clc.bold(extensionRef)}`);
     }
-    else if (extension &&
-        extension.latestVersion &&
-        semver.eq(extensionSpec.version, extension.latestVersion)) {
-        throw new error_1.FirebaseError(`The version you are trying to publish (${clc.bold(extensionSpec.version)}) already exists for the extension '${clc.bold(`${args.publisherId}/${args.extensionId}`)}'. Please increment the version inside of extension.yaml.\n`, { exit: 103 });
+    catch (err) {
+        publishSpinner.fail();
+        if (err.status === 404) {
+            throw getMissingPublisherError(args.publisherId);
+        }
+        throw err;
+    }
+    return res;
+}
+exports.publishExtensionVersionFromRemoteRepo = publishExtensionVersionFromRemoteRepo;
+async function publishExtensionVersionFromLocalSource(args) {
+    let extension;
+    try {
+        extension = await (0, extensionsApi_1.getExtension)(`${args.publisherId}/${args.extensionId}`);
     }
-    const ref = `${args.publisherId}/${args.extensionId}@${extensionSpec.version}`;
+    catch (err) {
+    }
+    const { extensionSpec, notes } = await validateExtensionSpec({
+        publisherId: args.publisherId,
+        extensionId: args.extensionId,
+        rootDirectory: args.rootDirectory,
+        latestVersion: extension === null || extension === void 0 ? void 0 : extension.latestVersion,
+        stage: args.stage,
+    });
+    const extensionRef = `${args.publisherId}/${args.extensionId}`;
+    displayReleaseNotes(extensionRef, extensionSpec.version, notes);
+    const confirmed = await confirm({
+        nonInteractive: args.nonInteractive,
+        force: args.force,
+        default: false,
+    });
+    if (!confirmed) {
+        return;
+    }
+    const extensionVersionRef = `${extensionRef}@${extensionSpec.version}`;
     let packageUri;
     let objectPath = "";
     const uploadSpinner = ora(" Archiving and uploading extension source code");
@@ -370,17 +559,17 @@ async function publishExtensionVersionFromLocalSource(args) {
             original: err,
         });
     }
-    const publishSpinner = ora(`Publishing ${clc.bold(ref)}`);
+    const publishSpinner = ora(`Publishing ${clc.bold(extensionVersionRef)}`);
     let res;
     try {
         publishSpinner.start();
-        res = await (0, extensionsApi_1.publishExtensionVersion)(ref, packageUri);
-        publishSpinner.succeed(` Successfully published ${clc.bold(ref)}`);
+        res = await (0, extensionsApi_1.publishExtensionVersion)({ extensionVersionRef, packageUri });
+        publishSpinner.succeed(` Successfully published ${clc.bold(extensionVersionRef)}`);
     }
     catch (err) {
         publishSpinner.fail();
         if (err.status === 404) {
-            throw new error_1.FirebaseError((0, marked_1.marked)(`Couldn't find publisher ID '${clc.bold(args.publisherId)}'. Please ensure that you have registered this ID. To register as a publisher, you can check out the [Firebase documentation](https://firebase.google.com/docs/extensions/alpha/share#register_as_an_extensions_publisher) for step-by-step instructions.`));
+            throw getMissingPublisherError(args.publisherId);
         }
         throw err;
     }
@@ -388,6 +577,9 @@ async function publishExtensionVersionFromLocalSource(args) {
     return res;
 }
 exports.publishExtensionVersionFromLocalSource = publishExtensionVersionFromLocalSource;
+function getMissingPublisherError(publisherId) {
+    return new error_1.FirebaseError((0, marked_1.marked)(`Couldn't find publisher ID '${clc.bold(publisherId)}'. Please ensure that you have registered this ID. To register as a publisher, you can check out the [Firebase documentation](https://firebase.google.com/docs/extensions/alpha/share#register_as_an_extensions_publisher) for step-by-step instructions.`));
+}
 async function createSourceFromLocation(projectId, sourceUri) {
     const extensionRoot = "/";
     let packageUri;
@@ -431,12 +623,18 @@ function getPublisherProjectFromName(publisherName) {
     throw new error_1.FirebaseError(`Could not find publisher with name '${publisherName}'.`);
 }
 exports.getPublisherProjectFromName = getPublisherProjectFromName;
-function displayReleaseNotes(publisherId, extensionId, versionId, releaseNotes) {
+function displayReleaseNotes(extensionRef, versionId, releaseNotes, sourceUri) {
+    const source = sourceUri || "local source";
     const releaseNotesMessage = releaseNotes
-        ? ` Release notes for this version:\n${(0, marked_1.marked)(releaseNotes)}\n`
-        : "\n";
-    const message = `You are about to publish version ${clc.green(versionId)} of ${clc.green(`${publisherId}/${extensionId}`)} to Firebase's registry of extensions.${releaseNotesMessage}` +
-        "Once an extension version is published, it cannot be changed. If you wish to make changes after publishing, you will need to publish a new version.\n\n";
+        ? `${clc.bold("Release notes:")}\n${(0, marked_1.marked)(releaseNotes)}`
+        : "";
+    const metadataMessage = `${clc.bold("Extension:")} ${extensionRef}\n` +
+        `${clc.bold("Version:")} ${clc.bold(clc.green(versionId))}\n` +
+        `${clc.bold("Source:")} ${source}\n`;
+    const message = `\nYou are about to publish a new version to Firebase's registry of Extensions.\n\n` +
+        metadataMessage +
+        releaseNotesMessage +
+        `\nOnce an Extension version is published, it cannot be changed. If you wish to make changes after publishing, you will need to publish a new version.\n`;
     logger_1.logger.info(message);
 }
 exports.displayReleaseNotes = displayReleaseNotes;

package/lib/extensions/localHelper.js

@@ -1,16 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isLocalExtension = exports.readFile = exports.findExtensionYaml = exports.getLocalExtensionSpec = void 0;
+exports.isLocalExtension = exports.readFile = exports.findExtensionYaml = exports.getLocalExtensionSpec = exports.EXTENSIONS_SPEC_FILE = void 0;
 const fs = require("fs-extra");
 const path = require("path");
 const yaml = require("js-yaml");
 const fsutils_1 = require("../fsutils");
 const error_1 = require("../error");
 const logger_1 = require("../logger");
-const EXTENSIONS_SPEC_FILE = "extension.yaml";
+exports.EXTENSIONS_SPEC_FILE = "extension.yaml";
 const EXTENSIONS_PREINSTALL_FILE = "PREINSTALL.md";
 async function getLocalExtensionSpec(directory) {
-    const spec = await parseYAML(readFile(path.resolve(directory, EXTENSIONS_SPEC_FILE)));
+    const spec = await parseYAML(readFile(path.resolve(directory, exports.EXTENSIONS_SPEC_FILE)));
     try {
         const preinstall = readFile(path.resolve(directory, EXTENSIONS_PREINSTALL_FILE));
         spec.preinstallContent = preinstall;
@@ -22,7 +22,7 @@ async function getLocalExtensionSpec(directory) {
 }
 exports.getLocalExtensionSpec = getLocalExtensionSpec;
 function findExtensionYaml(directory) {
-    while (!(0, fsutils_1.fileExistsSync)(path.resolve(directory, EXTENSIONS_SPEC_FILE))) {
+    while (!(0, fsutils_1.fileExistsSync)(path.resolve(directory, exports.EXTENSIONS_SPEC_FILE))) {
         const parentDir = path.dirname(directory);
         if (parentDir === directory) {
             throw new error_1.FirebaseError("Couldn't find an extension.yaml file. Check that you are in the root directory of your extension.");