feat: implement multi-builder switch example with dynamic builder swi…

[loriscabrini]

…tching

• Add complete multi-builder-switch-example project structure
• Implement dynamic switching between Email, Page, and Popup builders
• Add BeefreeMultiService for managing multiple builder types
• Create useBuilderManager hook for centralized state management
• Support builder-specific credentials and templates
• Fix template loading with JSON wrapper extraction logic
• Add comprehensive TypeScript types and error handling
• Include modern React 18 + TypeScript + Vite architecture
• Update secure-auth-example server to support builder-specific auth
• Enhance shared/auth.js to handle per-builder credentials
• Add detailed README with setup and usage instructions
• Update main project README with new example documentation

Features:

• Seamless switching between Email 📧, Page 📄, and Popup 🎯 builders
• Builder-specific authentication with individual client credentials
• Template loading with automatic JSON structure detection
• Professional UI with loading states and error handling
• CORS-compliant architecture using Vite proxy
• Production-ready with comprehensive documentation

[Copilot]

Pull Request Overview

This PR introduces a comprehensive multi-builder switch example that demonstrates dynamic switching between Email, Page, and Popup builders within a single application. The implementation includes a modern React 18 + TypeScript + Vite architecture with centralized state management and builder-specific authentication support.

Key Changes:

• Complete multi-builder-switch-example project with dynamic builder switching capabilities
• Enhanced shared auth service to support builder-specific credentials alongside default server credentials
• Updated secure-auth-example server to include CORS support for the new example on port 8083

Reviewed Changes

Copilot reviewed 22 out of 26 changed files in this pull request and generated no comments.

File	Description
shared/auth.js	Enhanced to support optional builder-specific client credentials in auth requests
secure-auth-example/server.ts	Added CORS origin for new example (port 8083)
multi-builder-switch-example/*	Complete new example project with React+TS architecture, services, components, and configuration
README.md	Updated with documentation for the new multi-builder switch example

Comments suppressed due to low confidence (1)

shared/auth.js:19

• There are duplicate JSDoc comments for the same function. The first comment (lines 6-12) should be removed to eliminate redundancy.

/**
 * Authenticates with Beefree SDK and returns a complete IToken
 * @param {string} clientId - Beefree client ID
 * @param {string} clientSecret - Beefree client secret  
 * @param {string} uid - User identifier
 * @returns {Promise<IToken>} Complete IToken object compatible with Beefree SDK
 */

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}