Fix float teaser delay from API embed settings being ignored

[LEVI-RIVKIN]

Problem

Dashboard embed settings for the float teaser delay (embedSettings.teaser.delay) had no effect on customer sites. Reported for research mype6y13 (embedded on greencountryhomebuyers.com): the delay was set to 30000ms and the config API returned it correctly, but the teaser always appeared after ~3 seconds.

Root cause

For script-tag embeds (data-perspective-float), the float bubble mounts immediately while the embed config is fetched asynchronously. createFloatBubble armed the welcome sequence (teaser + chime timers) at mount using the delay known at that moment — the hardcoded 3000ms default — and set welcomeSequenceStarted. When the API config arrived moments later via update() → syncTeaserState(), maybeStartWelcomeSequence() returned early because the sequence was already marked as started, so the configured delay was silently ignored.

Fix

• Defer arming while the config fetch is in flight. Script-tag float mounts set an internal _apiConfigPending flag; the welcome sequence does not arm until update({ _apiConfig }) clears it, so the teaser can never fire on the default delay while waiting for the API. fetchEmbedConfig never rejects (it resolves with the default theme on error/timeout), so the deferral always ends.
• Measure the delay from a persistent anchor. The anchor is set when the sequence first could have started (mount, or a re-enable after a disable) and survives deferred arms and reschedules — the teaser fires at the resolved delay measured from mount, crediting time already waited. Repeated delay changes on a still-pending teaser reschedule against the same anchor (not the latest reschedule), and a disable resets the anchor so a re-enable measures from the re-enable.
• A delivered or cancelled teaser (e.g. the visitor opened the chat) is never re-armed by a late config refresh.

Testing

• New regression tests: deferred arm with elapsed-time credit, immediate show when the config resolves past the default delay, delay reschedule on async config arrival, second delay change crediting from the first arm, re-enable measuring from the re-enable, no-op refresh with an unchanged delay, no re-arm after the teaser has shown, and no arming while the fetch is unresolved (browser auto-init).
• Full suite green: 449 SDK tests, 90 sdk-react tests, typecheck, lint, and format.
• Patch changeset added for @perspective-ai/sdk.

🤖 Generated with Claude Code

https://claude.ai/code/session_01U6W4LcRde56iDNCwCMj76Q

[github-actions]

📦 Snapshot Release

Published snapshot packages for this PR:

pnpm add @perspective-ai/sdk@1.14.1-pr-70-20260709215800
pnpm add @perspective-ai/sdk-react@1.14.1-pr-70-20260709215800

Or use the npm tag (always points to the latest snapshot from this PR):

pnpm add @perspective-ai/sdk@pr-70
pnpm add @perspective-ai/sdk-react@pr-70

[Copilot]

Pull request overview

Fixes float teaser delay being ignored when dashboard/API embed settings arrive asynchronously after the float bubble mounts, by rescheduling the welcome sequence timers to respect the resolved embedSettings.teaser.delay (crediting time already elapsed since mount).

Changes:

• Track which teaser delay the welcome sequence was armed with and when, so pending timers can be rescheduled when API config changes the delay.
• Reschedule teaser + chime timers on delay changes while the teaser is still pending, without re-arming after the teaser has already fired.
• Add regression tests covering async delay reschedule, unchanged-delay refresh behavior, and no re-arm after the teaser has shown; add a patch changeset for @perspective-ai/sdk.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
packages/sdk/src/float.ts	Adds arm-tracking and rescheduling logic so async API teaser delay updates take effect.
packages/sdk/src/float.test.ts	Adds regression tests for delay rescheduling and non-rearming scenarios.
.changeset/teaser-delay-reschedule.md	Patch changeset documenting the behavioral fix for @perspective-ai/sdk.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated no new comments.