ext/hyperframes
2
0
Fork 0
mirror of https://github.com/heygen-com/hyperframes.git synced 2026-09-11 23:00:03 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(studio-server): preview variable injection + render variables forwarding

Browse Source 
Fourth PR of the template-variables Studio stack — the HTTP plumbing.

- preview routes (/preview and /preview/comp/*) accept
  ?variables=<url-encoded json> and inject
  `window.__hfVariables = {...}` into <head>, before the runtime and any
  composition script — the exact global the engine sets via
  evaluateOnNewDocument at render time, so preview-with-values cannot
  diverge from render output. Values are escaped against </script>
  breakout, malformed payloads 400 instead of silently previewing
  defaults, and the ETag is salted with a hash of the payload so cached
  previews revalidate when values change.
- POST /projects/:id/render accepts variables ({variableId: value}) and
  forwards them through StudioApiAdapter.startRender into the producer's
  RenderConfig.variables — the same channel `hyperframes render
  --variables` uses. Wired in both adapters (CLI embedded server + vite
  dev adapter).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
James
2026-07-09 13:31:03 -07:00
co-authored by Claude Fable 5
parent 91831f3f8e
commit 2e0b884521
8 changed files with 269 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packages/studio-server/src/helpers/variablesPayload.ts
+11
View File
@@ -0,0 +1,11 @@
/**
* Shared shape check for composition-variable payloads (`?variables=` on the
* preview routes, `body.variables` on the render route) — one contract, one
* error string, so the routes can't drift.
*/
export const VARIABLES_PAYLOAD_ERROR = "variables must be a JSON object of {variableId: value}";
export function isVariablesPayload(value: unknown): value is Record<string, unknown> {
return typeof value === "object" && value !== null && !Array.isArray(value);
}