Skip to content

Exclude browser-only types from @firebase/util public types #6088

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Mar 22, 2022

Conversation

hsubox76
Copy link
Contributor

Use api-extractor's dtsRollup functionality to exclude browser-only native IndexedDB types from util's public typings. These typings are used in methods needed by other firebase packages for internal development, but end users don't need them.

  • common/api-review/util.api.md is autogenerated by the api-extractor process. Since util isn't fully compliant yet, and we don't generate docs for it, it can be ignored for now.
  • Warnings are disabled in api-extractor.json for util, since we don't care about any of the end products except the public typings file. We may fix it to be tsdoc compliant later for better auditing of util but it's low priority since there's no public facing docs or API.
  • docgen.ts has been modified to prevent it generating devsite docs for util. It was also generating extraneous docs for app-compat, so that's been excluded too.

@changeset-bot
Copy link

changeset-bot bot commented Mar 21, 2022

🦋 Changeset detected

Latest commit: 930307d

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 28 packages
Name Type
@firebase/util Patch
@firebase/analytics-compat Patch
@firebase/analytics Patch
@firebase/app-check-compat Patch
@firebase/app-check Patch
@firebase/app-compat Patch
@firebase/app Patch
@firebase/auth-compat Patch
@firebase/auth Patch
@firebase/component Patch
@firebase/database-compat Patch
@firebase/database-types Patch
@firebase/database Patch
firebase Patch
@firebase/firestore-compat Patch
@firebase/firestore Patch
@firebase/functions-compat Patch
@firebase/functions Patch
@firebase/installations-compat Patch
@firebase/installations Patch
@firebase/messaging-compat Patch
@firebase/messaging Patch
@firebase/performance-compat Patch
@firebase/performance Patch
@firebase/remote-config-compat Patch
@firebase/remote-config Patch
@firebase/storage-compat Patch
@firebase/storage Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

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.

Looks like no public-facing strings here. LGTM.

Copy link

@allspain allspain left a comment

Choose a reason for hiding this comment

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

LGTM. Took a second to understand how api-extractor works, but this seems like the right level of fix for this.

@hsubox76 hsubox76 merged commit 3198d58 into master Mar 22, 2022
@hsubox76 hsubox76 deleted the ch-util-fix branch March 22, 2022 17:05
@google-oss-bot google-oss-bot mentioned this pull request Mar 22, 2022
@firebase firebase locked and limited conversation to collaborators Apr 22, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants