Skip to content
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

Improve types and docs of {import,export}SecretsBundle #123

Merged
merged 2 commits into from
Jun 4, 2024

Conversation

richvdh
Copy link
Member

@richvdh richvdh commented Jun 3, 2024

Followup on #118

cf #110

@richvdh
Copy link
Member Author

richvdh commented Jun 3, 2024

cc @poljar since you wrote the original PR

@richvdh richvdh requested a review from poljar June 3, 2024 10:36
@richvdh richvdh changed the title Improve return types of {import,export}SecretsBundle Improve types and docs of {import,export}SecretsBundle Jun 3, 2024
Comment on lines +537 to +538
/// Export all the secrets we have in the store into a {@link
/// SecretsBundle}.
Copy link
Member Author

Choose a reason for hiding this comment

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

Since this documentation is used by typedoc, we have to use link formats that it understands.

(Note that currently the documentation at https://matrix-org.github.io/matrix-rust-sdk-crypto-wasm/classes/OlmMachine.html#importSecretsBundle doesn't link correctly).

Comment on lines +567 to +568
/// The provided `SecretsBundle` is freed by this method; be careful not to
/// use it once this method has been called.
Copy link
Member Author

Choose a reason for hiding this comment

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

invalidating an argument is a very non-JS thing to do, so let's call it out explicitly.

Copy link
Member

@BillCarsonFr BillCarsonFr left a comment

Choose a reason for hiding this comment

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

Very nice improvement!

@richvdh richvdh merged commit cd9fff5 into main Jun 4, 2024
3 checks passed
@richvdh richvdh deleted the rav/qr-login-types branch June 4, 2024 09:27
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.

2 participants