Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
import { beforeEach, describe, expect, it, vi } from "vitest";
import { MIN_SECRET_LEN, signSession } from "./session";
// Cookies ignore ports and paths (RFC 6265 §8.5), so anything that can write a
// cookie on this host — a sibling port, a proxied page, document.cookie — can add
// a SECOND `session=` cookie ahead of the real one. Reading only the first match
// hands every request a forged value and locks the user out with the valid cookie
// still in the jar, unfixable from the UI.
const SECRET = "s".repeat(MIN_SECRET_LEN);
const jar: { name: string; value: string }[] = [];
const policy = vi.hoisted(() => ({ scope: "host", generation: 0 }));
const epoch = () => `epoch-${String(policy.generation).padStart(16, "0")}`;
vi.mock("next/headers", () => ({
cookies: async () => ({
getAll: (name: string) => jar.filter((cookie) => cookie.name === name),
}),
}));
vi.mock("./device-store", () => ({
currentSessionPolicy: async (scope: string) => {
if (policy.scope !== scope) { policy.scope = scope; policy.generation += 1; }
return { scope, epoch: epoch(), changedAt: policy.generation };
},
getApprovedDevice: async (id: string) => id === "dev-1"
? { label: "device", approvedAt: 1, role: "operator" }
: null,
}));
const valid = () => signSession({ issued_at: Date.now(), expires_at: Date.now() + 60_000, device_id: "dev-1", cookie_scope: "host", cookie_epoch: epoch() }, SECRET);
beforeEach(() => {
jar.length = 0;
policy.scope = "host"; policy.generation = 0;
process.env.OS_SESSION_SECRET = SECRET;
delete process.env.OS_SESSION_COOKIE_DOMAIN;
});
// The framework cookie read is registered by instrumentation.ts in production. The test
// does the same thing through the same seam, which is also the proof the seam works.
const { registerSessionCookieReader } = await import("./require-session");
registerSessionCookieReader(async () => {
const { cookies } = await import("next/headers");
return (await cookies()).getAll("session");
});
describe("getSession with a shadowed cookie", () => {
it("accepts the real session even when a forged one sorts first", async () => {
const { getSession } = await import("./require-session");
jar.push({ name: "session", value: "EVIL" }, { name: "session", value: valid() });
expect(await getSession()).toMatchObject({ device_id: "dev-1" });
});
it("still rejects when every candidate fails", async () => {
const { getSession } = await import("./require-session");
jar.push({ name: "session", value: "EVIL" }, { name: "session", value: "ALSO_EVIL" });
expect(await getSession()).toBeNull();
});
it("rejects a signed session whose device is not approved", async () => {
const { getSession } = await import("./require-session");
jar.push({
name: "session",
value: signSession({ issued_at: Date.now(), expires_at: Date.now() + 60_000, device_id: "revoked", cookie_scope: "host", cookie_epoch: epoch() }, SECRET),
});
expect(await getSession()).toBeNull();
});
it("never revives legacy Domain tokens even when the obsolete setting returns", async () => {
const { getSession } = await import("./require-session");
process.env.OS_SESSION_COOKIE_DOMAIN = "example.com";
policy.scope = "domain:example.com"; policy.generation = 1;
const retained = signSession({
issued_at: Date.now(), expires_at: Date.now() + 60_000, device_id: "dev-1",
cookie_scope: "domain:example.com", cookie_epoch: epoch(),
}, SECRET);
jar.push({ name: "session", value: retained });
expect(await getSession()).toBeNull();
delete process.env.OS_SESSION_COOKIE_DOMAIN;
expect(await getSession()).toBeNull();
process.env.OS_SESSION_COOKIE_DOMAIN = "example.com";
expect(await getSession()).toBeNull();
expect(policy.generation).toBe(2);
jar.push({ name: "session", value: valid() });
expect(await getSession()).toMatchObject({ device_id: "dev-1" });
});
it("rechecks the live device role for every authorization decision", async () => {
const { getSessionContext, requireSession } = await import("./require-session");
jar.push({ name: "session", value: valid() });
await expect(getSessionContext()).resolves.toMatchObject({ role: "operator" });
await expect(requireSession("viewer")).resolves.toBe(true);
await expect(requireSession("operator")).resolves.toBe(true);
await expect(requireSession("owner")).resolves.toBe(false);
});
});