From c536445eec55c3f388c10cd2bca046f8fae2fe3b Mon Sep 17 00:00:00 2001
From: Hariom Balhara <1780212+hariombalhara@users.noreply.github.com>
Date: Thu, 29 Jan 2026 10:13:58 +0530
Subject: [PATCH] docs: clarify bookerReopened and bookerReloaded are for
 prerendered modals (#27348)

## What does this PR do?

Updates the embed lifecycle documentation to clarify that `bookerReopened` and `bookerReloaded` events are only applicable for prerendered modals that are now visible.

## Mandatory Tasks (DO NOT REMOVE)

- [x] I have self-reviewed the code (A decent size PR without self-review might be rejected).
- [x] I have updated the developer docs in /docs if this PR makes changes that would require a [documentation change](https://cal.com/docs). N/A - this PR is itself a documentation update.
- [x] I confirm automated tests are in place that prove my fix is effective or that my feature works. N/A - documentation only change.

## How should this be tested?

This is a documentation-only change. Review the accuracy of the added "Applicability" notes for both events.

## Checklist

- [x] I have read the [contributing guide](https://github.com/calcom/cal.com/blob/main/CONTRIBUTING.md)
- [x] My code follows the style guidelines of this project
- [x] I have checked if my changes generate no new warnings

---

### Reviewer Checklist
- [ ] Verify that the documentation accurately reflects when `bookerReopened` and `bookerReloaded` events fire (only for prerendered modals)

---

> [!NOTE]
> **Link to Devin run**: https://app.devin.ai/sessions/35a0c5d4d5fc4feb9a5af2d8d340b9c5
> **Requested by**: @hariombalhara
---
 packages/embeds/LIFECYCLE.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/embeds/LIFECYCLE.md b/packages/embeds/LIFECYCLE.md
index d241d0a6b9..5d5c71697d 100644
--- a/packages/embeds/LIFECYCLE.md
+++ b/packages/embeds/LIFECYCLE.md
@@ -122,12 +122,14 @@ The embed system carefully manages visibility to prevent visual glitches:
     - Indicates: Booker has been reopened after modal was closed
     - Triggers: On subsequent linkReady events (viewId > 1) when modal is reopened without reload
     - Note: Distinguishes between first view (bookerViewed) and reopen (bookerReopened). Uses viewId to determine if it's a reopen.
+    - Applicability: Only applicable for prerendered modals that are now visible.
 
 13. **bookerReloaded Event**
     - Fired by: Iframe
     - Indicates: Booker has been reloaded (full page reload within modal)
     - Triggers: On linkReady after fullReload action is taken (when reloadInitiated flag is set)
     - Note: Distinguishes between first view (bookerViewed), reopen (bookerReopened), and reload (bookerReloaded). Fires only once per reload.
+    - Applicability: Only applicable for prerendered modals that are now visible.
 
 14. **bookerReady Event**
     - Fired by: Iframe
@@ -223,4 +225,4 @@ The embed system tracks user interactions and page views:
 Page Load Errors:
    - System monitors CalComPageStatus
    - On non-200 status: fires linkFailed event
-   - Includes error code and URL information
\ No newline at end of file
+   - Includes error code and URL information