Add STATIC environment variable for browser-only deployment mode

Implement STATIC=1 environment variable to enable browser-only deployment
without proxy server infrastructure. Uses WS4KP_SERVER_AVAILABLE flag to
distinguish between server-backed and static deployments for proper URL
rewriting and User-Agent header handling.

- Add STATIC env var to skip proxy route registration at startup
- Inject WS4KP_SERVER_AVAILABLE flag via EJS template based on STATIC mode
- Update fetch.mjs to conditionally send User-Agent headers based on server availability
- Update url-rewrite.mjs to skip proxy rewriting when server is unavailable
- Use renderIndex helper for consistent template data across dev/prod modes
- Improve music playlist logging

Benefits of integrated approach:
- Single environment variable controls both server and client behavior
- Flag injection happens once at render time, not on every request
- No runtime HTML string manipulation overhead
- Clean separation between server-backed and static deployment logic
- Same codebase supports both deployment modes without duplication

Static mode (STATIC=1): Direct API calls to external services, no caching
Server mode (default): Local proxy with caching and API request observability
This commit is contained in:
Eddy G
2025-06-26 17:17:17 -04:00
parent bfd0c2b02d
commit 7f7cb96231
8 changed files with 100 additions and 35 deletions

View File

@@ -10,7 +10,7 @@ const safeJson = async (url, params) => {
}
// If caller didn't specify returnUrl, result is the raw API response
return result;
} catch (error) {
} catch (_error) {
// Error already logged in fetchAsync; return null to be "safe"
return null;
}
@@ -25,7 +25,7 @@ const safeText = async (url, params) => {
}
// If caller didn't specify returnUrl, result is the raw API response
return result;
} catch (error) {
} catch (_error) {
// Error already logged in fetchAsync; return null to be "safe"
return null;
}
@@ -40,7 +40,7 @@ const safeBlob = async (url, params) => {
}
// If caller didn't specify returnUrl, result is the raw API response
return result;
} catch (error) {
} catch (_error) {
// Error already logged in fetchAsync; return null to be "safe"
return null;
}
@@ -83,7 +83,11 @@ const fetchAsync = async (_url, responseType, _params = {}) => {
const checkUrl = new URL(_url, window.location.origin);
const shouldExcludeUserAgent = USER_AGENT_EXCLUDED_HOSTS.some((host) => checkUrl.hostname.includes(host));
if (!shouldExcludeUserAgent) {
// User-Agent handling:
// - Server mode (with caching proxy): Add User-Agent for all requests except excluded hosts
// - Static mode (direct requests): Only add User-Agent for api.weather.gov, avoiding CORS preflight issues with other services
const shouldAddUserAgent = !shouldExcludeUserAgent && (window.WS4KP_SERVER_AVAILABLE || _url.toString().match(/api\.weather\.gov/));
if (shouldAddUserAgent) {
headers['user-agent'] = 'Weatherstar 4000+; weatherstar@netbymatt.com';
}

View File

@@ -8,6 +8,10 @@ const rewriteUrl = (_url) => {
// Handle both string URLs and URL objects
const url = typeof _url === 'string' ? new URL(_url) : new URL(_url.toString());
if (!window.WS4KP_SERVER_AVAILABLE) {
return url;
}
// Rewrite the origin to use local proxy server
if (url.origin === 'https://api.weather.gov') {
url.protocol = window.location.protocol;