Skip to content

fix(server): share stable dashboard asset snapshots #382

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
luvs01 wants to merge 10 commits into
base: Dev
Choose a base branch
from
Open

fix(server): share stable dashboard asset snapshots #382

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
d35592b
merge dev into main for the v2.32.1 release
lidge-jun Aug 25, 2026
71c57ea
release: v2.32.1
lidge-jun Aug 25, 2026
d560ac6
merge dev into main for the v2.33.0 release
lidge-jun Aug 25, 2026
08ada6f
Merge pull request #2553 from lidge-jun/codex/promote-main-2330
lidge-jun Aug 25, 2026
ec51e42
release: v2.33.0
lidge-jun Aug 25, 2026
e25b653
merge dev into main for the v2.34.0 release
lidge-jun Aug 27, 2026
80fff9a
Merge pull request #2760 from lidge-jun/codex/promote-main-2340
lidge-jun Aug 27, 2026
fc4de77
Merge pull request #2826 from lidge-jun/codex/promote-main-2350
lidge-jun Aug 28, 2026
c7d8407
Merge pull request #3002 from lidge-jun/codex/promote-main-2360
lidge-jun Aug 30, 2026
053e403
fix(server): share stable dashboard asset snapshots
luvs01 Aug 31, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 28 additions & 4 deletions src/server/gui-static.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,31 @@ const MIME_TYPES: Record<string, string> = {
".ico": "image/x-icon",
};

interface StaticAssetSnapshot {
fingerprint: string;
blob: Blob;
}

const staticAssetSnapshots = new Map<string, StaticAssetSnapshot>();

function staticAssetSnapshot(path: string, contentType: string): Blob | null {
try {
const stat = statSync(path);
if (!stat.isFile()) return null;
const fingerprint = `${stat.dev}:${stat.ino}:${stat.size}:${stat.mtimeMs}:${stat.ctimeMs}`;
const cached = staticAssetSnapshots.get(path);
if (cached?.fingerprint === fingerprint) return cached.blob;

// Blob owns one immutable copy that every response can share. This keeps a response
// stable across package replacement without allocating the asset again per request.
const blob = new Blob([readFileSync(path)], { type: contentType });
staticAssetSnapshots.set(path, { fingerprint, blob });

@chatgpt-codex-connector chatgpt-codex-connector Bot Aug 31, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Evict snapshots for obsolete asset paths

When a running source checkout rebuilds the dashboard—or a live package update replaces it—Vite gives changed JS/CSS bundles new content-hashed paths. Each subsequently requested bundle is retained by this process-wide map, while entries for the now-deleted paths are never removed and their full Blob contents remain reachable. Repeated dashboard rebuilds or updates therefore accumulate roughly one GUI bundle per version for the lifetime of the proxy, undermining the memory-amplification fix; bound the cache or purge entries that no longer belong to the current gui/dist snapshot.

Useful? React with 👍 / 👎.

return blob;
} catch {
return null;
}
}

function findGuiDist(): string | null {
const candidates = [
join(import.meta.dir, "..", "..", "gui", "dist"),
Expand Down Expand Up @@ -127,10 +152,9 @@ export function serveGuiFile(
const ext = extname(filePath);
const contentType = MIME_TYPES[ext] || "application/octet-stream";
if (ext === ".html") return htmlResponse(filePath, session);
// Snapshot bytes before returning the response. Bun.file is lazy: if gui/dist is replaced
// after Bun frames the response but before the stream finishes, its Content-Length can
// describe the old file while the body comes from the new one (#2792).
return new Response(readFileSync(filePath), {
const snapshot = staticAssetSnapshot(filePath, contentType);
if (!snapshot) return null;
return new Response(snapshot, {
headers: { "Content-Type": contentType, ...browserSecurityHeaders() },
});
}
Expand Down
6 changes: 5 additions & 1 deletion tests/gui-static.test.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ afterEach(() => {
}
});

test("#2792 snapshots a static asset before server framing can outlive the file", async () => {
test("#2792 shares a stable static asset snapshot and refreshes it after replacement", async () => {
const guiDist = mkdtempSync(join(tmpdir(), "ocx-gui-static-"));
temporaryDirectories.push(guiDist);
writeFileSync(join(guiDist, "index.html"), "<!doctype html>");
Expand All @@ -27,4 +27,8 @@ test("#2792 snapshots a static asset before server framing can outlive the file"
// body must retain the same byte snapshot the HTTP server uses for Content-Length.
writeFileSync(assetPath, "truncated");
expect(await response!.text()).toBe(originalAsset);

const replacementResponse = serveGuiFile("/index.js", guiDist);
expect(replacementResponse).not.toBeNull();
expect(await replacementResponse!.text()).toBe("truncated");
});
Loading