Skip to content
This repository was archived by the owner on Mar 4, 2026. It is now read-only.

chore: refactor reference.ts to one class per file#2037

Merged
MarkDuckworth merged 7 commits intomainfrom
markduckworth/refactor-reference
May 22, 2024
Merged

chore: refactor reference.ts to one class per file#2037
MarkDuckworth merged 7 commits intomainfrom
markduckworth/refactor-reference

Conversation

@MarkDuckworth
Copy link
Copy Markdown
Contributor

Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:

  • Make sure to open an issue as a bug/issue before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea
  • Ensure the tests and linter pass
  • Code coverage does not decrease (if any source code was changed)
  • Appropriate docs were updated (if necessary)

Fixes #<issue_number_goes_here> 🦕

@product-auto-label product-auto-label Bot added size: xl Pull request size is extra large. api: firestore Issues related to the googleapis/nodejs-firestore API. labels Apr 29, 2024
@MarkDuckworth MarkDuckworth marked this pull request as ready for review April 29, 2024 19:19
@MarkDuckworth MarkDuckworth requested review from a team April 29, 2024 19:19
@MarkDuckworth MarkDuckworth added the do not merge Indicates a pull request not ready for merge, due to either quality or timing. label Apr 29, 2024
@MarkDuckworth
Copy link
Copy Markdown
Contributor Author

Wait to merge until #2017 merges, so we don't force the community contribution to refactor.

@MarkDuckworth MarkDuckworth removed the do not merge Indicates a pull request not ready for merge, due to either quality or timing. label May 16, 2024
Comment on lines +62 to +81
/**
* onSnapshot() callback that receives a QuerySnapshot.
*
* @callback querySnapshotCallback
* @param {QuerySnapshot} snapshot A query snapshot.
*/

/**
* onSnapshot() callback that receives a DocumentSnapshot.
*
* @callback documentSnapshotCallback
* @param {DocumentSnapshot} snapshot A document snapshot.
*/

/**
* onSnapshot() callback that receives an error.
*
* @callback errorCallback
* @param {Error} err An error from a listen.
*/
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I see these in the original reference.ts, but it looks like we should remove them.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

These are being used by JSDoc to build the documentation at https://googleapis.dev/nodejs/firestore/latest/global.html#querySnapshotCallback. If we migrate the SDK to only use TSDoc, then we can remove these.

@MarkDuckworth MarkDuckworth merged commit 1e949b8 into main May 22, 2024
@MarkDuckworth MarkDuckworth deleted the markduckworth/refactor-reference branch May 22, 2024 18:38
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

api: firestore Issues related to the googleapis/nodejs-firestore API. size: xl Pull request size is extra large.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants