Skip to content

Improve emptyTimeout and departureTimeout JSDoc comments#626

Open
ctonneslan wants to merge 1 commit intolivekit:mainfrom
ctonneslan:improve-empty-timeout-docs
Open

Improve emptyTimeout and departureTimeout JSDoc comments#626
ctonneslan wants to merge 1 commit intolivekit:mainfrom
ctonneslan:improve-empty-timeout-docs

Conversation

@ctonneslan
Copy link

Fixes #126

The existing docs for emptyTimeout just said "number of seconds to keep the room open before any participant joins" which doesn't cover the full behavior. It actually applies after all participants leave too, and the timer resets when someone joins.

Updated both emptyTimeout and departureTimeout docs to be clearer about the lifecycle. Kept it concise since these are JSDoc comments, not a full guide.

Clarify the behavior of emptyTimeout: it applies both before any
participant joins and after all participants leave, with the timer
resetting when someone joins.

Also improve departureTimeout docs with a concrete use case.

Fixes livekit#126
@changeset-bot
Copy link

changeset-bot bot commented Mar 21, 2026

⚠️ No Changeset found

Latest commit: 6c7d181

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

Copy link

@devin-ai-integration devin-ai-integration bot left a comment

Choose a reason for hiding this comment

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

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Open in Devin Review

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.

Documentation Update: emptyTimeout in CreateOptions

1 participant