heygen-com__hyperframes

skills/heygen-com__hyperframes

Fork 0

mirror of https://github.com/heygen-com/hyperframes.git synced 2026-09-14 18:01:20 +08:00

Commit Graph

Author	SHA1	Message	Date
Miguel Ángel	eab61a2780	fix(studio): serve render files from disk instead of in-memory map The /api/render/:jobId/view route depended on an in-memory renderJobs map that's empty after server restart, causing 404s. Replace with a /api/projects/:id/renders/file/:filename route that reads directly from the renders directory on disk. Both view and download now use this path. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-03-31 02:01:22 +00:00
Miguel Ángel	1230657ed0	fix(studio,runtime,engine,compiler): 8 bug fixes — audio, render, timeline, Lottie, thumbnails, video render (#133 ) ## Summary Original 5 bugs fixed: - Bug 1 — Audio silent after seek: Added `Accept-Ranges` / `Content-Length` + `206 Partial Content` to the static asset server for byte-range seeking. - Bug 2 — Download 404 after restart: Render list endpoint now registers on-disk renders into the in-memory job map. - Bug 3 — Timeline stops at GSAP end: `resolveRootTimelineFromDocument` pads the GSAP timeline to match `data-duration` when the composition declares longer. - Bug 4 — Render stuck at 0%: Store `jobState` reference (not spread copy) so async progress mutations reach the SSE stream. - Bug 5 — Lottie missing in preview/render: Two fixes — (a) moved Lottie adapter before GSAP so `onUpdate` wins; (b) fixed bundler silently dropping external CDN `\<script src>` tags from sub-compositions (root cause: `$content(s).html()` returns `""` for external scripts). 3 additional bugs fixed: - Bug 6 — Blank thumbnails outside monorepo: Implemented `generateThumbnail` in the CLI adapter using Puppeteer. - Bug 7 — Video empty in rendered sub-compositions: Fixed `parseVideoElements` selector from `video[id][src]` to `video[src][data-start]` + auto-assign IDs. - Render errors: Failed renders now show their error message in the renders panel. ## Commits \| Commit \| Description \| \| --- \| --- \| \| `3951c6f` \| fix(studio): store render job reference instead of snapshot copy \| \| `f331c30` \| fix(studio): make previously-completed renders downloadable after restart \| \| `a5e2d04` \| fix(studio): add range request support for audio/video seeking in preview \| \| `f24317a` \| fix(runtime): pad GSAP timeline to data-duration when composition declares longer duration \| \| `7cf38ca` \| fix(runtime): fix Lottie adapter conflicting with GSAP-driven animations \| \| `bc99209` \| fix(studio): surface render error messages in the renders panel \| \| `8fc9e8b` \| fix(cli): implement generateThumbnail in studio adapter \| \| `90277ea` \| fix(engine): render videos inside sub-compositions that lack an explicit id \| \| `f5bb579` \| fix(compiler): preserve external CDN scripts from sub-compositions in bundle \| ## Test plan - [x] `golden-lyric-video`: seek → audio plays from seeked position - [x] Any project: render → progress advances past 0%, reaches 100% - [x] Any project: complete render, restart `hyperframes dev`, Download → works - [x] `intro-vid`: play → runs full 5s (not stopping at 3s) - [x] `hyperframe-build-up-demo`: play → rocket Lottie visible during 0-2s ✅ verified - [x] Outside monorepo: Compositions sidebar shows thumbnail images (not blank) - [x] `bug.zip` project: render → video in polaroid sub-composition appears in output - [x] Trigger a failed render → error message shown	2026-03-30 23:58:08 +02:00
Miguel Ángel	bd175b64a6	refactor(core): extract shared studio API module (#113 ) ## Summary Extracts all studio API routes into a shared Hono-based module at `@hyperframes/core/studio-api`. ### Architecture - `StudioApiAdapter` interface — consumers inject host-specific behavior (project resolution, bundling, rendering, thumbnails) - Shared route modules: projects, files, preview, lint, render, thumbnail - Shared helpers: `isSafePath`, `walkDir`, `getMimeType`, `buildSubCompositionHtml` ### What this PR does - Creates the shared module with all API routes extracted from both `vite.config.ts` and `studioServer.ts` - Both consumers will be refactored in follow-up commits to mount this module with their own adapter ### What stays in each consumer - Vite: SSR module loading, Puppeteer thumbnails, file watcher + HMR, producer HTTP proxy, multi-project scanning - CLI: in-process `executeRenderJob`, local runtime serving, browser management, SPA static file serving ### Follow-up needed - [ ] Refactor `packages/studio/vite.config.ts` to use `createStudioApi(adapter)` via `@hono/node-server`'s `getRequestListener` - [ ] Refactor `packages/cli/src/server/studioServer.ts` to use `createStudioApi(adapter)` - [ ] Add `./studio-api` export path to `packages/core/package.json` - [ ] Add `hono` as peer dependency of `@hyperframes/core` ## Test plan - [ ] Verify shared module compiles without type errors - [ ] After consumer refactoring: all studio features work identically via both vite dev and CLI embedded servers 🤖 Generated with [Claude Code](https://claude.com/claude-code)	2026-03-28 22:28:12 +01:00

Author

SHA1

Message

Date

Miguel Ángel

eab61a2780

fix(studio): serve render files from disk instead of in-memory map

The /api/render/:jobId/view route depended on an in-memory renderJobs
map that's empty after server restart, causing 404s. Replace with a
/api/projects/:id/renders/file/:filename route that reads directly from
the renders directory on disk. Both view and download now use this path.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-31 02:01:22 +00:00

Miguel Ángel

1230657ed0

fix(studio,runtime,engine,compiler): 8 bug fixes — audio, render, timeline, Lottie, thumbnails, video render (#133 )

## Summary

**Original 5 bugs fixed:**

- **Bug 1 — Audio silent after seek**: Added `Accept-Ranges` / `Content-Length` + `206 Partial Content` to the static asset server for byte-range seeking.
- **Bug 2 — Download 404 after restart**: Render list endpoint now registers on-disk renders into the in-memory job map.
- **Bug 3 — Timeline stops at GSAP end**: `resolveRootTimelineFromDocument` pads the GSAP timeline to match `data-duration` when the composition declares longer.
- **Bug 4 — Render stuck at 0%**: Store `jobState` reference (not spread copy) so async progress mutations reach the SSE stream.
- **Bug 5 — Lottie missing in preview/render**: Two fixes — (a) moved Lottie adapter before GSAP so `onUpdate` wins; (b) fixed bundler silently dropping external CDN `\<script src>` tags from sub-compositions (root cause: `$content(s).html()` returns `""` for external scripts).

**3 additional bugs fixed:**

- **Bug 6 — Blank thumbnails outside monorepo**: Implemented `generateThumbnail` in the CLI adapter using Puppeteer.
- **Bug 7 — Video empty in rendered sub-compositions**: Fixed `parseVideoElements` selector from `video[id][src]` to `video[src][data-start]` + auto-assign IDs.
- **Render errors**: Failed renders now show their error message in the renders panel.

## Commits

| Commit | Description |
| --- | --- |
| `3951c6f` | fix(studio): store render job reference instead of snapshot copy |
| `f331c30` | fix(studio): make previously-completed renders downloadable after restart |
| `a5e2d04` | fix(studio): add range request support for audio/video seeking in preview |
| `f24317a` | fix(runtime): pad GSAP timeline to data-duration when composition declares longer duration |
| `7cf38ca` | fix(runtime): fix Lottie adapter conflicting with GSAP-driven animations |
| `bc99209` | fix(studio): surface render error messages in the renders panel |
| `8fc9e8b` | fix(cli): implement generateThumbnail in studio adapter |
| `90277ea` | fix(engine): render videos inside sub-compositions that lack an explicit id |
| `f5bb579` | fix(compiler): preserve external CDN scripts from sub-compositions in bundle |

## Test plan

- [x] `golden-lyric-video`: seek → audio plays from seeked position
- [x] Any project: render → progress advances past 0%, reaches 100%
- [x] Any project: complete render, restart `hyperframes dev`, Download → works
- [x] `intro-vid`: play → runs full 5s (not stopping at 3s)
- [x] `hyperframe-build-up-demo`: play → rocket Lottie visible during 0-2s ✅ verified
- [x] Outside monorepo: Compositions sidebar shows thumbnail images (not blank)
- [x] `bug.zip` project: render → video in polaroid sub-composition appears in output
- [x] Trigger a failed render → error message shown

2026-03-30 23:58:08 +02:00

Miguel Ángel

bd175b64a6

refactor(core): extract shared studio API module (#113 )

## Summary
Extracts all studio API routes into a shared Hono-based module at `@hyperframes/core/studio-api`.

### Architecture
- **`StudioApiAdapter` interface** — consumers inject host-specific behavior (project resolution, bundling, rendering, thumbnails)
- **Shared route modules**: projects, files, preview, lint, render, thumbnail
- **Shared helpers**: `isSafePath`, `walkDir`, `getMimeType`, `buildSubCompositionHtml`

### What this PR does
- Creates the shared module with all API routes extracted from both `vite.config.ts` and `studioServer.ts`
- Both consumers will be refactored in follow-up commits to mount this module with their own adapter

### What stays in each consumer
- **Vite**: SSR module loading, Puppeteer thumbnails, file watcher + HMR, producer HTTP proxy, multi-project scanning
- **CLI**: in-process `executeRenderJob`, local runtime serving, browser management, SPA static file serving

### Follow-up needed
- [ ] Refactor `packages/studio/vite.config.ts` to use `createStudioApi(adapter)` via `@hono/node-server`'s `getRequestListener`
- [ ] Refactor `packages/cli/src/server/studioServer.ts` to use `createStudioApi(adapter)`
- [ ] Add `./studio-api` export path to `packages/core/package.json`
- [ ] Add `hono` as peer dependency of `@hyperframes/core`

## Test plan
- [ ] Verify shared module compiles without type errors
- [ ] After consumer refactoring: all studio features work identically via both vite dev and CLI embedded servers

🤖 Generated with [Claude Code](https://claude.com/claude-code)

2026-03-28 22:28:12 +01:00

3 Commits