add preview flag for sf api to support multiple hasEmail #1000

[UcDust]

No description provided.

[Copilot]

Pull Request Overview

This PR adds preview flag support to the SiteFarm API to handle multiple hasEmail addresses for experts, addressing issue #1000. The implementation allows for backward compatibility by maintaining the existing API behavior while providing enhanced email support through a preview parameter.

• Extracts utility functions from the main API file to a dedicated utils.js module for better organization
• Implements preview format middleware that supports multiple email addresses for experts
• Updates OpenAPI documentation with both standard and preview schemas

Reviewed Changes

Copilot reviewed 4 out of 5 changed files in this pull request and generated 7 comments.

File	Description
services/base-service/models/sitefarm/utils.js	New utility module containing extracted SiteFarm formatting functions and preview middleware
services/base-service/models/sitefarm/swagger.json	Updated OpenAPI schema with cleaner structure and version bump
services/base-service/models/sitefarm/swagger-preview.json	New preview schema documenting multiple email support
services/base-service/models/sitefarm/api.js	Refactored to use extracted utilities and added preview parameter routing logic

---

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