Skip to content

Conversation

@taeold
Copy link
Contributor

@taeold taeold commented Oct 21, 2025

Replace functions.config() implementation with an error that provides clear migration guidance to the params module. This removes the deprecated API as planned for the next major release while helping developers migrate.

The error message directs users to: https://firebase.google.com/docs/functions/config-env#migrate-config

BREAKING CHANGE: functions.config() now throws an error instead of returning configuration values. Migrate to environment parameters using the params module.

Replace functions.config() implementation with an error that provides
clear migration guidance to the params module. This removes the deprecated
API as planned for the next major release while helping developers migrate.

The error message directs users to:
https://firebase.google.com/docs/functions/config-env#migrate-config

BREAKING CHANGE: functions.config() now throws an error instead of
returning configuration values. Migrate to environment parameters using
the params module.
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @taeold, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request implements a significant breaking change by fully removing the functions.config() API, which was previously deprecated. The primary purpose of this change is to enforce the migration of users to the recommended params module for handling environment configurations. Now, any attempt to call functions.config() will result in an error that provides explicit guidance and a link to the migration documentation, ensuring developers can transition smoothly to the new approach.

Highlights

  • API Removal: The deprecated functions.config() API has been completely removed from the codebase.
  • Breaking Change: Calling functions.config() will now immediately throw an error instead of returning configuration values. This is a breaking change for the next major release.
  • Migration Guidance: The error message thrown by functions.config() includes clear instructions and a link to documentation for migrating to the params module for environment parameters.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request correctly implements a breaking change to remove the functionality of functions.config(), replacing it with a helpful error message to guide developers toward migration. The changes are clear, concise, and the updated test validates the new behavior. I have one suggestion to make the test assertion more precise, ensuring the error message is exactly as intended.

Copy link
Contributor

@egilmorez egilmorez left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here are a couple probably unhelpful things. Glad to see this going forward!

@taeold taeold merged commit dece9a9 into next Oct 21, 2025
17 checks passed
@github-project-automation github-project-automation bot moved this from Approved [PR] to Done in [Cloud] Extensions + Functions Oct 21, 2025
github-merge-queue bot pushed a commit that referenced this pull request Nov 4, 2025
* BREAKING: Upgrade TypeScript to v5.9.3 (#1746)

Upgrades from TypeScript v4.3.5 to v5.9.3. All tests pass successfully.

* BREAKING: Drop Node.js 14/16 support, require Node.js >=18 (#1747)

* BREAKING: Drop Node.js 14/16 support, require Node.js >=18

- Update package.json engines to require Node.js >=18.0.0
- Upgrade @types/node from v14 to v18
- Update TypeScript target from ES2019 to ES2022
- Add useDefineForClassFields: false for backward compatibility
- Update CI/CD workflows to test Node.js 18, 20, 22, and 24
- Set default CI/CD Node.js version to 24
- Update integration test documentation

* BREAKING: remove functions.config() implementation (#1748)

Replace functions.config() implementation with an error that provides
clear migration guidance to the params module. This removes the deprecated
API as planned for the next major release while helping developers migrate.

The error message directs users to:
https://firebase.google.com/docs/functions/config-env#migrate-config

* chore: migrate to ESLint v9 and Flat Config (#1753)

Upgraded eslint to v9 and replaced the legacy .eslintrc.js with the new eslint.config.js format.

Applied minor fixes to 4 files (renaming unused catch variables to _e and one small refactor) to satisfy slightly stricter baseline rules from updated plugins.

Mostly doing this due to our upgrade in TS to latest v5 version which the old versions of eslint ts plugins no longer support.

* chore: enable esModuleInterop (#1751)

* feat: add async error handling to onRequest (#1755)

BREAKING CHANGE: Unhandled errors in async onRequest handlers now immediately return a 500 Internal Server Error instead of hanging until timeout. This may affect clients relying on 504 Gateway Timeout for retry logic.

* BREAKING: Break TS build that uses functions.config() (#1757)

Type out `functions.config()` API. Use of `functions.config()` API should now cause a BUILD error at compile time.

```ts
import * as functions from "firebase-functions";
import {onRequest} from "firebase-functions/https";
import * as logger from "firebase-functions/logger";

const cfg = functions.config()

export const helloWorld = onRequest((request, response) => {
  logger.info("Hello logs!", cfg);
  response.send("Hello from Firebase!");
});
```
```bash
$ npm run build

> build
> tsc

src/index.ts:5:23 - error TS2349: This expression is not callable.
  Type 'never' has no call signatures.

5 const cfg = functions.config()
                        ~~~~~~


Found 1 error in src/index.ts:5
```

* Add Firebase Data Connect v2 support (#1727)

* Add Firebase Data Connect v2 support

* Export dataconnect

* Fix export

* Rename Extract to VarName, since Extract is a built in type

* Include auth context in event payload

* Stronger typing for data connect params

* Fix formatting and address comments

* Apply another suggestion

* Add region and fix bug in which event.service, event.connector, event.operation gets populated

* Remove locations/... segment

* Address comments

* Fix linter

* feat: enable ESM support via dual-publishing (#1750)

- Configure tsdown to build both CJS and ESM outputs.
- Update package.json exports to support both 'require' and 'import'.
- Fix type hygiene issues by using explicit 'export type'.
- Update protos/update.sh to generate ESM version of compiledFirestore and fix its imports for Node.js compatibility.
- Configure build aliases to handle relative paths to protos correctly in both CJS and ESM builds.
- Add packaging integration test to CI.

~Note: I enabled `esModuleInterop` in tsconfig.release.json to support default imports from CommonJS modules (like cors), which is required for proper ESM interop. This caused some chain-effect that required updating several unit tests and source files to use default imports for other CJS dependencies (e.g., fs, nock, jsonwebtoken) to align with the new compiler configuration.~ Fixed in #1751.

* lock down permission per GitHub alert.

* update lint rule to enforce prettier rules.

* chore: update CHANGELOG for v7.0.0

* format.

---------

Co-authored-by: Lisa Jian <ljian997@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants