Files
youtube-generator/worker/env.ts
T
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

56 lines
2.1 KiB
TypeScript

/**
* Bindings and constants for the Cloudflare Worker that fronts
* https://ytgenerator.stream.
*
* The Worker only uses standard Web APIs (fetch, Request, Response, Web
* Crypto), so it type-checks against the DOM lib and runs unchanged under
* Vitest in Node. The static-assets binding is described structurally rather
* than through `@cloudflare/workers-types`.
*/
/** The `ASSETS` binding from `wrangler.jsonc` — serves files out of `dist/`. */
export interface AssetsBinding {
fetch(request: Request): Promise<Response>;
}
export interface Env {
ASSETS: AssetsBinding;
/** Public Turnstile sitekey (`vars` in wrangler.jsonc). */
TURNSTILE_SITE_KEY: string;
/** Turnstile secret — a dashboard Secret, never committed. */
TURNSTILE_SECRET: string;
/** How long a passed check lasts, in seconds (string, from `vars`). */
GATE_TTL_SECONDS?: string;
}
/** Everything the router needs from the outside world, injectable in tests. */
export interface Deps {
/** Current time in milliseconds since the epoch. */
now(): number;
fetch: typeof fetch;
/** A fresh random string: CSP nonces and siteverify idempotency keys. */
randomId(): string;
}
export const GATE_COOKIE = "__Host-ytg_gate";
export const VERIFY_PATH = "/__gate/verify";
/** 204 when the request carries a valid gate cookie — lets the gate page
* detect a browser that silently refused to store it. */
export const STATUS_PATH = "/__gate/status";
export const TURNSTILE_ACTION = "enter";
export const SITEVERIFY_URL = "https://challenges.cloudflare.com/turnstile/v0/siteverify";
/** Turnstile tokens are valid for 300 s; anything older is refused. */
export const MAX_TOKEN_AGE_SECONDS = 300;
const DEFAULT_GATE_TTL_SECONDS = 86_400;
const MIN_GATE_TTL_SECONDS = 300;
const MAX_GATE_TTL_SECONDS = 30 * 86_400;
/** The configured gate lifetime, clamped to [5 min, 30 days]. */
export function gateTtlSeconds(env: Env): number {
const parsed = Number.parseInt(env.GATE_TTL_SECONDS ?? "", 10);
if (!Number.isFinite(parsed)) return DEFAULT_GATE_TTL_SECONDS;
return Math.min(MAX_GATE_TTL_SECONDS, Math.max(MIN_GATE_TTL_SECONDS, parsed));
}