Files
poli0981andClaude Opus 5.5 5ced6b4a86 feat(web): Turnstile gate, in-site legal pages and clean URLs on ytgenerator.stream
A Worker (worker/) now sits in front of the static build, configured from the
same wrangler.jsonc. Cloudflare builds and deploys it; nothing in GitHub
Actions does.

Gate
- First visit shows a branded check page (8 languages, Accept-Language) with
  Cloudflare Turnstile. The token is verified server-side against
  TURNSTILE_SECRET: success, hostname, action "enter", age <= 300 s. Only
  Cloudflare's own test-key results skip the hostname/action check, so
  `npm run cf:dev` works with the published test keys.
- Pass -> `__Host-ytg_gate` (HttpOnly, Secure, SameSite=Lax, 24 h): an HMAC
  over expiry + a user-agent hash, keyed from the Turnstile secret, so no
  second secret exists and a cookie copied into a scraper is useless.
- The page reloads in place instead of redirecting, so there is no `next`
  parameter to open-redirect with; /__gate/status lets the page tell a
  cookie-blocking browser what is wrong instead of looping; after one
  failure it waits for a click rather than resubmitting.
- Missing secret = deployment mistake: the site stays up without the gate and
  the Worker logs it, instead of locking every visitor out.
- The agree box on the gate records `ytg_terms`, which the app reads on boot
  so web visitors meet one blocking screen, not two.

Headers and static files
- worker/headers.ts sets CSP (nonce + strict-dynamic on the gate, no script
  at all on legal pages), nosniff, Referrer-Policy, Permissions-Policy, COOP,
  CORP, X-Frame-Options on everything the Worker returns; _headers covers
  the files served directly; a test keeps the two baselines identical.
- `not_found_handling: "404-page"` (a static 404.html) instead of the SPA
  fallback, which would have handed index.html past the gate for any
  excluded path. The Worker serves the shell itself by fetching "/" - not
  "/index.html", which html_handling would 307 back to the home page.
- security.txt (RFC 9116) is generated per build so Expires stays ~6 months
  ahead; the Web Analytics beacon is injected into the web build only.
- theme-init.js applies the saved theme before first paint (no inline script).

Legal in-site
- build-plugins/legal-docs.ts renders TERMS, PRIVACY, DISCLAIMER (+ vi),
  LICENSE, THIRD_PARTY_NOTICES, SECURITY, NOTICE and CODE_OF_CONDUCT at build
  time into static /legal pages (public, before the gate) and a lazy
  `virtual:legal-docs` module for the in-app Legal Center, which works
  offline on desktop and Android and never leaves the webview.
- PRIVACY, TERMS and SECURITY rewritten for Cloudflare hosting, Turnstile,
  Web Analytics and the two cookies; contacts moved to the poli0981.dev
  aliases (privacy@, legal@, dmca@, copyright@, security@, code@).
- CURRENT_TERMS_VERSION 1 -> 2: the Privacy Policy changed materially.

App
- Web uses BrowserRouter (real paths; analytics can count them), Tauri keeps
  HashRouter; old /#/x bookmarks are rewritten to /x before the router reads
  them. Consent is a layout route; /legal sits outside it.
- <html lang> follows the UI language; a stale chunk after a deploy triggers
  one reload instead of an error page.

.gitattributes pins LF everywhere so Windows checkouts stop failing Prettier.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 19:26:40 +07:00

106 lines
4.0 KiB
TypeScript

/**
* Security headers for every HTML response the Worker produces.
*
* `public/_headers` covers the static files Cloudflare serves directly, but
* Cloudflare does not apply `_headers` rules to responses generated by Worker
* code — so the app shell, the gate page and the static legal pages get their
* headers here. `tests/worker/headers.test.ts` keeps the shared baseline in
* step with `public/_headers`.
*
* HSTS is deliberately absent: the zone edge already sends
* `max-age=31536000; includeSubDomains; preload`, and a second copy from the
* origin risks a merged, malformed header.
*/
export const BASELINE_HEADERS: Readonly<Record<string, string>> = {
"X-Content-Type-Options": "nosniff",
"Referrer-Policy": "strict-origin-when-cross-origin",
"Permissions-Policy":
"accelerometer=(), camera=(), display-capture=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), usb=(), browsing-topics=()",
"Cross-Origin-Opener-Policy": "same-origin",
"Cross-Origin-Resource-Policy": "same-origin",
"X-Frame-Options": "DENY",
};
/** CSP for the React app shell (index.html). */
export const APP_CSP = [
"default-src 'self'",
// Cloudflare Web Analytics beacon (manual snippet, web build only).
"script-src 'self' https://static.cloudflareinsights.com",
"connect-src 'self' https://cloudflareinsights.com",
"img-src 'self' data: blob:",
// sonner / Radix / Motion set inline styles; no inline <script> is allowed.
"style-src 'self' 'unsafe-inline'",
"font-src 'self' data:",
"manifest-src 'self'",
"worker-src 'self'",
"object-src 'none'",
"base-uri 'none'",
"form-action 'self'",
"frame-ancestors 'none'",
"upgrade-insecure-requests",
].join("; ");
/** CSP for the Turnstile gate page — its one inline script carries a nonce. */
export function gateCsp(nonce: string): string {
return [
"default-src 'none'",
`script-src 'nonce-${nonce}' 'strict-dynamic' https://challenges.cloudflare.com`,
"frame-src https://challenges.cloudflare.com",
"connect-src 'self'",
"img-src 'self' data:",
"style-src 'unsafe-inline'",
"base-uri 'none'",
"form-action 'self'",
"frame-ancestors 'none'",
].join("; ");
}
/** CSP for the prerendered legal pages: no script at all. */
export const LEGAL_CSP = [
"default-src 'none'",
"img-src 'self' data:",
"style-src 'unsafe-inline'",
"base-uri 'none'",
"form-action 'none'",
"frame-ancestors 'none'",
].join("; ");
/**
* Copy a response with the baseline headers, a CSP and a cache policy.
* Responses from `env.ASSETS` have immutable headers, so this always rebuilds.
*/
export function withSecurityHeaders(
response: Response,
options: { csp: string; cacheControl: string; varyCookie?: boolean },
): Response {
const headers = new Headers(response.headers);
for (const [name, value] of Object.entries(BASELINE_HEADERS)) headers.set(name, value);
headers.set("Content-Security-Policy", options.csp);
headers.set("Cache-Control", options.cacheControl);
if (options.varyCookie) headers.append("Vary", "Cookie");
return new Response(response.body, {
status: response.status,
statusText: response.statusText,
headers,
});
}
/** A small plain-text response with the baseline headers. */
export function plainResponse(status: number, message: string, extra?: HeadersInit): Response {
const headers = new Headers(extra);
headers.set("Content-Type", "text/plain; charset=utf-8");
headers.set("Cache-Control", "no-store");
for (const [name, value] of Object.entries(BASELINE_HEADERS)) headers.set(name, value);
return new Response(message, { status, headers });
}
/** A JSON response for the verify endpoint. */
export function jsonResponse(status: number, body: unknown, extra?: HeadersInit): Response {
const headers = new Headers(extra);
headers.set("Content-Type", "application/json; charset=utf-8");
headers.set("Cache-Control", "no-store");
for (const [name, value] of Object.entries(BASELINE_HEADERS)) headers.set(name, value);
return new Response(JSON.stringify(body), { status, headers });
}