fix(rybbit): queue custom events before script loads

[harlan-zw]

🔗 Linked issue

Resolves #461

❓ Type of change

• 📖 Documentation (updates to the documentation or readme)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality)
• ✨ New feature (a non-breaking change that adds functionality)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

Custom events (like proxy.event()) failed silently after page refresh but worked after SPA navigation. The root cause was that use() returned null when window.rybbit was undefined, breaking the proxy's ability to queue calls before the script loaded.

Added clientInit to create a stub that queues calls, and flushQueue() that replays them once the real script loads. This follows the same pattern used by Google Analytics and Plausible.

// Events now work immediately, even before script loads
const { proxy } = useScriptRybbitAnalytics({ siteId: '874' })
proxy.event('my_event', { data: 'value' }) // queued if script not ready, sent when loaded

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
scripts-docs	Error		Jan 18, 2026 2:55am
scripts-playground	Ready	Preview, Comment	Jan 18, 2026 2:55am

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/nuxt/scripts/@nuxt/scripts@585

commit: 6720a6a