Merge branch 'main' into codex/housekeeping-foundation

drizzle/migrations/0022_add_terms_age_consent.sql

@@ -0,0 +1,4 @@
+-- Add terms/age consent columns expected by the users schema (register flow).
+ALTER TABLE `users`
+	ADD COLUMN `terms_accepted` TINYINT(1) NOT NULL DEFAULT 0,
+	ADD COLUMN `age_verified` TINYINT(1) NOT NULL DEFAULT 0;

package.json

@@ -5,7 +5,7 @@
 	"engines": {
 		"node": ">=26.7.0 <27"
 	},
-	"packageManager": "[email protected]2.0",
+	"packageManager": "[email protected]4.0",
 	"scripts": {
 		"dev": "next dev",
 		"build": "next build",
@@ -34,7 +34,6 @@
 		"@dnd-kit/sortable": "10.0.0",
 		"@dnd-kit/utilities": "3.2.2",
 		"@hookform/resolvers": "5.9.1",
-		"@next/bundle-analyzer": "16.3.2",
 		"@tanstack/react-virtual": "3.14.10",
 		"class-variance-authority": "0.7.1",
 		"clsx": "2.1.1",
@@ -49,7 +48,7 @@
 		"jszip": "3.10.1",
 		"lenis": "1.3.26",
 		"lucide-react": "1.33.0",
-		"lzma": "2.3.2",
+		"lzma": "^2.3.2",
 		"motion": "13.1.1",
 		"music-metadata": "11.15.0",
 		"mysql2": "3.23.4",

scripts/furni-diagnose-now.ts

@@ -97,7 +97,7 @@ async function main(): Promise<void> {
 	const dbByClass = new Map(baseRows.map((r) => [r.itemName, r.id]));
 	const dbById = new Map(baseRows.map((r) => [r.id, r.itemName]));
 	let fdWrongId = 0;
-	let fdIdConflict = 0; // id belongs to a different classname in DB
+	let _fdIdConflict = 0; // id belongs to a different classname in DB
 	let fdMissingInDb = 0;
 	const fdExamplesWrong: string[] = [];
 	for (const e of entries) {
@@ -114,7 +114,7 @@ async function main(): Promise<void> {
 				);
 			continue;
 		}
-		if (dbById.get(e.id) !== e.classname) fdIdConflict++;
+		if (dbById.get(e.id) !== e.classname) _fdIdConflict++;
 	}
 	console.log(
 		`    furnidata entries whose id != items_base.id for same classname: ${fdWrongId}`,

src/app/(site)/register/page.tsx

@@ -33,18 +33,20 @@ export default async function RegisterPage() {
 				.where(eq(User.online, "1"))
 				.then((rows) => rows[0]?.total ?? 0),
 		).catch(() => 0),
+		cached("register_online_users", 10_000, () =>
 			db
 				.select({ username: User.username, look: User.look })
 				.from(User)
 				.where(eq(User.online, "1"))
-			.limit(8)
+				.limit(8),
-			.catch(() => []),
+		).catch(() => []),
+		cached("register_latest_users", 30_000, () =>
 			db
 				.select({ username: User.username, look: User.look })
 				.from(User)
 				.orderBy(desc(User.accountCreated))
-			.limit(8)
+				.limit(8),
-			.catch(() => []),
+		).catch(() => []),
 	]);
 
 	return (

src/app/client/client-view.tsx

@@ -34,7 +34,13 @@ function ToolbarBtn({
 	} as const;
 	if (href) {
 		return (
-			<Link href={href} className={cls} style={style} title={title}>
+			<Link
+				href={href}
+				prefetch={false}
+				className={cls}
+				style={style}
+				title={title}
+			>
 				{children}
 			</Link>
 		);
@@ -377,9 +383,12 @@ export function ClientView({
 				<iframe
 					id="nitro"
 					src={clientSrc}
-					className="absolute inset-0 w-full h-full border-0 m-0 p-0 overflow-hidden"
+					className={`absolute inset-0 w-full h-full border-0 m-0 p-0 overflow-hidden ${
+						dragging ? "pointer-events-none" : "pointer-events-auto"
+					}`}
 					title={hotelName}
-					allow="autoplay; gamepad"
+					allow="autoplay; gamepad; fullscreen"
+					loading="eager"
 				/>
 			</div>
 		</>

src/app/client/page.tsx

@@ -21,15 +21,19 @@ export default async function ClientPage() {
 	]);
 
 	const ip = (await headers()).get("x-real-client-ip") ?? "0.0.0.0";
-	const ticket = await issueSsoTicket(userId, hotelName, ip);
 
-	const onlineCount = await cached("online_count", 10_000, async () => {
+	// Ticket write and online count run in parallel — the client page should
+	// render as fast as possible since the player is waiting for the game.
+	const [ticket, onlineCount] = await Promise.all([
+		issueSsoTicket(userId, hotelName, ip),
+		cached("online_count", 10_000, async () => {
 			const [row] = await db
 				.select({ total: count() })
 				.from(User)
 				.where(eq(User.online, "1"));
 			return row?.total ?? 0;
-	}).catch(() => 0);
+		}).catch(() => 0),
+	]);
 
 	return (
 		<ClientView

src/app/layout.tsx

@@ -33,7 +33,7 @@ const pixelify = Pixelify_Sans({
 // enforceSiteAccess, DB-backed site settings) to render the <html> element,
 // which cannot be wrapped in <Suspense>. Child pages inherit this opt-out,
 // so leaf pages that only access cached/DB data stay instant.
-export const instant = false;
+// export const instant = false;
 
 export async function generateMetadata(): Promise<Metadata> {
 	const appUrl = process.env.APP_URL ?? "http://localhost:3000";

src/lib/admin/photo-files.ts

@@ -1,5 +1,6 @@
 import { unlink } from "node:fs/promises";
 import path from "node:path";
+import { getRuntimeResolve } from "@/lib/utils/runtime-path";
 
 /**
  * Best-effort local file delete for camera photos hosted under /public.
@@ -25,8 +26,11 @@ export async function tryRemoveLocalPhotoFile(url: string): Promise<boolean> {
 	if (!pathname.startsWith("/")) return false;
 	const rel = pathname.replace(/^\/+/, "");
 	if (!rel || rel.includes("..")) return false;
-	const publicRoot = path.resolve(process.cwd(), "public");
+	const publicRoot = /*turbopackIgnore: true*/ getRuntimeResolve(
-	const full = path.resolve(publicRoot, rel);
+		process.cwd(),
+		"public",
+	);
+	const full = getRuntimeResolve(publicRoot, rel);
 	if (!full.startsWith(publicRoot + path.sep) && full !== publicRoot) {
 		return false;
 	}

src/lib/media-storage.ts

@@ -1,13 +1,14 @@
 import path from "node:path";
+import { getRuntimeResolve } from "@/lib/utils/runtime-path";
 
 /**
  * Persistent media root. Lives outside `public/` and outside Git so uploads
  * survive rebuilds, redeploys and `git clean`. Served through /api/media.
  */
-export const MEDIA_ROOT = path.resolve(process.cwd(), "storage", "media");
+export const MEDIA_ROOT = getRuntimeResolve(process.cwd(), "storage", "media");
 
 export function resolveMediaPath(...segments: string[]): string {
-	const target = path.resolve(MEDIA_ROOT, ...segments);
+	const target = getRuntimeResolve(MEDIA_ROOT, ...segments);
 	if (target !== MEDIA_ROOT && !target.startsWith(MEDIA_ROOT + path.sep)) {
 		throw new Error("Invalid media path");
 	}

src/lib/services/catalog-assets.test.ts

@@ -1,23 +1,23 @@
-import path from "node:path";
 import { describe, expect, it } from "vitest";
 import { catalogueAssetDirectories } from "@/lib/services/catalog-assets";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 describe("catalogue asset directories", () => {
 	it("prefers the configured Gamedata catalogue and retains the bundled fallback", () => {
-		const cwd = path.join("test", "cms");
+		const cwd = getRuntimePath("test", "cms");
-		const gamedataRoot = path.join("test", "Gamedata");
+		const gamedataRoot = getRuntimePath("test", "Gamedata");
 
 		expect(catalogueAssetDirectories(gamedataRoot, cwd)).toEqual([
-			path.join(gamedataRoot, "c_images", "catalogue"),
+			getRuntimePath(gamedataRoot, "c_images", "catalogue"),
-			path.join(cwd, "public", "swf", "c_images", "catalogue"),
+			getRuntimePath(cwd, "public", "swf", "c_images", "catalogue"),
 		]);
 	});
 
 	it("uses only the bundled catalogue when no Gamedata root is configured", () => {
-		const cwd = path.join("test", "cms");
+		const cwd = getRuntimePath("test", "cms");
 
 		expect(catalogueAssetDirectories("", cwd)).toEqual([
-			path.join(cwd, "public", "swf", "c_images", "catalogue"),
+			getRuntimePath(cwd, "public", "swf", "c_images", "catalogue"),
 		]);
 	});
 });

src/lib/services/catalog-assets.ts

@@ -1,14 +1,14 @@
 import { promises as fs } from "node:fs";
-import path from "node:path";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 export function catalogueAssetDirectories(
 	gamedataRoot: string,
 	cwd = process.cwd(),
 ): string[] {
-	const bundled = path.join(cwd, "public", "swf", "c_images", "catalogue");
+	const bundled = getRuntimePath(cwd, "public", "swf", "c_images", "catalogue");
 	if (!gamedataRoot.trim()) return [bundled];
 
-	return [path.join(gamedataRoot, "c_images", "catalogue"), bundled];
+	return [getRuntimePath(gamedataRoot, "c_images", "catalogue"), bundled];
 }
 
 export async function readCatalogueAssetFiles(

src/lib/services/catalog-audit.ts

@@ -1,5 +1,4 @@
 import { readdir } from "node:fs/promises";
-import path from "node:path";
 import { sql } from "drizzle-orm";
 import { db } from "@/lib/db";
 import { fetchSourceFurnidata } from "@/lib/services/clone-import";
@@ -8,6 +7,7 @@ import {
 	getFurniAssetDirs,
 	getGamedataRoot,
 } from "@/lib/services/furni-asset-dirs";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 import {
 	applyCatalogSql,
 	generateCatalogSql,
@@ -182,7 +182,7 @@ export async function runCatalogAudit(
 			try {
 				const gamedataRoot = await getGamedataRoot();
 				if (!gamedataRoot) return [] as string[];
-				return await readdir(path.join(gamedataRoot, "album1584")).catch(
+				return await readdir(getRuntimePath(gamedataRoot, "album1584")).catch(
 					() => [] as string[],
 				);
 			} catch {

src/lib/services/catalog-repair-live.test.ts

@@ -6,7 +6,6 @@
 // FurnitureData.json is only ever read (a copy is made first).
 import { promises as fs } from "node:fs";
 import os from "node:os";
-import path from "node:path";
 import { sql } from "drizzle-orm";
 import { afterAll, beforeAll, describe, expect, it, vi } from "vitest";
 import { db } from "@/lib/db";
@@ -23,6 +22,7 @@ import {
 	classifyCatalogItem,
 	NO_CATALOG_KINDS,
 } from "@/lib/services/item-kind";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 const { getGamedataRootMock, getNitroFilesRootMock, settingGetMock } =
 	vi.hoisted(() => ({
@@ -59,9 +59,11 @@ let tmpRoot: string;
 let gamedataDir: string;
 
 beforeAll(async () => {
-	tmpRoot = await fs.mkdtemp(path.join(os.tmpdir(), "furni-repair-rehearsal-"));
+	tmpRoot = await fs.mkdtemp(
-	gamedataDir = path.join(tmpRoot, "Gamedata");
+		getRuntimePath(os.tmpdir(), "furni-repair-rehearsal-"),
-	await fs.mkdir(path.join(gamedataDir, "config"), { recursive: true });
+	);
+	gamedataDir = getRuntimePath(tmpRoot, "Gamedata");
+	await fs.mkdir(getRuntimePath(gamedataDir, "config"), { recursive: true });
 	getGamedataRootMock.mockResolvedValue(gamedataDir);
 	getNitroFilesRootMock.mockResolvedValue("");
 	settingGetMock.mockImplementation(
@@ -75,7 +77,7 @@ beforeAll(async () => {
 	try {
 		await fs.copyFile(
 			REAL_FURNIDATA,
-			path.join(gamedataDir, "config", "FurnitureData.json"),
+			getRuntimePath(gamedataDir, "config", "FurnitureData.json"),
 		);
 	} catch {
 		// missing copy — repair still runs against an empty file
@@ -242,7 +244,7 @@ describeGuard("catalog studio live repair rehearsal (sandbox)", () => {
 			byName.set(r.item_name, (byName.get(r.item_name) ?? 0) + 1);
 		const finalFd = JSON.parse(
 			await fs.readFile(
-				path.join(gamedataDir, "config", "FurnitureData.json"),
+				getRuntimePath(gamedataDir, "config", "FurnitureData.json"),
 				"utf8",
 			),
 		) as Record<string, { furnitype: Array<Record<string, unknown>> }>;

src/lib/services/clone-import.ts

@@ -1,5 +1,4 @@
 import { promises as fs } from "node:fs";
-import path from "node:path";
 import { eq, inArray, sql } from "drizzle-orm";
 import { db, ItemsBase } from "@/lib/db";
 import { autoDetectInteraction } from "@/lib/furni/auto-interaction";
@@ -25,6 +24,7 @@ import {
 import { downloadFile } from "@/lib/services/import/core/download";
 import { siteSettings } from "@/lib/services/site-settings";
 import { parseNitroBundle } from "@/lib/services/swf/nitro-builder";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 export interface SourceFurni {
 	id: number;
@@ -287,11 +287,11 @@ export async function cloneSingleFurni(params: {
 
 	// Download .nitro + icon directly from the source hotel.
 	onProgress?.("downloading");
-	const nitroPath = path.join(
+	const nitroPath = getRuntimePath(
 		/*turbopackIgnore: true*/ nitroDir,
 		`${classname}.nitro`,
 	);
-	const iconPath = path.join(
+	const iconPath = getRuntimePath(
 		/*turbopackIgnore: true*/ iconDir,
 		`${classname}_icon.png`,
 	);

src/lib/services/effect-import.ts

@@ -1,5 +1,4 @@
 import { existsSync, promises as fs } from "node:fs";
-import path from "node:path";
 import {
 	listOfficialEffects,
 	resolveEffectSwfUrl,
@@ -13,17 +12,18 @@ import { getGamedataRoot } from "@/lib/services/furni-asset-dirs";
 import { downloadFile } from "@/lib/services/import/core/download";
 import { siteSettings } from "@/lib/services/site-settings";
 import { convertSwfToNitro } from "@/lib/services/swf-to-nitro";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 import type {
 	EffectListItem,
 	EffectMapEntry,
 	ImportEffectResult,
 } from "@/types/effects";
 
-const EFFECT_NITRO_DIR_FALLBACK = path.join(
+const EFFECT_NITRO_DIR_FALLBACK = getRuntimePath(
 	/*turbopackIgnore: true*/ process.cwd(),
 	"public/nitro-assets/bundled/effect",
 );
-const EFFECT_SWF_DIR_FALLBACK = path.join(
+const EFFECT_SWF_DIR_FALLBACK = getRuntimePath(
 	/*turbopackIgnore: true*/ process.cwd(),
 	"public/swf/gordon",
 );
@@ -35,7 +35,10 @@ async function getEffectNitroDir(): Promise<string> {
 	if (configured) return configured;
 	const gamedataRoot = await getGamedataRoot();
 	if (gamedataRoot)
-		return path.join(/*turbopackIgnore: true*/ gamedataRoot, "bundled/effect");
+		return getRuntimePath(
+			/*turbopackIgnore: true*/ gamedataRoot,
+			"bundled/effect",
+		);
 	return EFFECT_NITRO_DIR_FALLBACK;
 }
 
@@ -61,7 +64,7 @@ export async function ensureEffectDirs(): Promise<void> {
 }
 
 async function nitroPathFor(lib: string): Promise<string> {
-	return path.join(
+	return getRuntimePath(
 		/*turbopackIgnore: true*/ await getEffectNitroDir(),
 		`${lib}.nitro`,
 	);
@@ -82,7 +85,7 @@ export async function importSingleEffect(params: {
 
 	// Download SWF
 	onProgress?.("downloading");
-	const swfPath = path.join(
+	const swfPath = getRuntimePath(
 		/*turbopackIgnore: true*/ await getEffectSwfDir(),
 		`${lib}.swf`,
 	);
@@ -167,7 +170,7 @@ export async function getEffectList(search: string): Promise<EffectListItem[]> {
 		...e,
 		present: localByLib.has(e.lib),
 		nitroExists: existsSync(
-			/*turbopackIgnore: true*/ path.join(nitroDir, `${e.lib}.nitro`),
+			/*turbopackIgnore: true*/ getRuntimePath(nitroDir, `${e.lib}.nitro`),
 		),
 	}));
 	return term

src/lib/services/effectmap.test.ts

@@ -1,7 +1,7 @@
 import { promises as fs } from "node:fs";
 import os from "node:os";
-import path from "node:path";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 import type { EffectMapEntry } from "@/types/effects";
 import {
 	__setEffectMapPathForTests,
@@ -26,8 +26,8 @@ const ENTRY: EffectMapEntry = {
 };
 
 beforeEach(async () => {
-	dir = await fs.mkdtemp(path.join(os.tmpdir(), "effectmap-"));
+	dir = await fs.mkdtemp(getRuntimePath(os.tmpdir(), "effectmap-"));
-	file = path.join(dir, "EffectMap.json");
+	file = getRuntimePath(dir, "EffectMap.json");
 	await fs.writeFile(file, JSON.stringify({ effects: [ENTRY] }));
 	__setEffectMapPathForTests(file);
 });

src/lib/services/figure-import.ts

@@ -1,11 +1,11 @@
 import { existsSync, promises as fs } from "node:fs";
-import path from "node:path";
 import { resolveFigureSwfUrl } from "@/lib/services/figure-source";
 import { listFigureLibraries } from "@/lib/services/figuremap";
 import { getGamedataRoot } from "@/lib/services/furni-asset-dirs";
 import { downloadFile } from "@/lib/services/import/core/download";
 import { siteSettings } from "@/lib/services/site-settings";
 import { convertSwfToNitro } from "@/lib/services/swf-to-nitro";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 export interface FigureListItem {
 	lib: string;
@@ -24,11 +24,11 @@ export interface ImportFigureResult {
 	error?: string;
 }
 
-const FIGURE_NITRO_DIR_FALLBACK = path.join(
+const FIGURE_NITRO_DIR_FALLBACK = getRuntimePath(
 	/*turbopackIgnore: true*/ process.cwd(),
 	"public/nitro-assets/bundled/figure",
 );
-const FIGURE_SWF_DIR_FALLBACK = path.join(
+const FIGURE_SWF_DIR_FALLBACK = getRuntimePath(
 	/*turbopackIgnore: true*/ process.cwd(),
 	"public/swf/gordon",
 );
@@ -40,7 +40,10 @@ async function getFigureNitroDir(): Promise<string> {
 	if (configured) return configured;
 	const gamedataRoot = await getGamedataRoot();
 	if (gamedataRoot)
-		return path.join(/*turbopackIgnore: true*/ gamedataRoot, "bundled/figure");
+		return getRuntimePath(
+			/*turbopackIgnore: true*/ gamedataRoot,
+			"bundled/figure",
+		);
 	return FIGURE_NITRO_DIR_FALLBACK;
 }
 
@@ -66,7 +69,7 @@ export async function ensureFigureDirs(): Promise<void> {
 }
 
 async function nitroPathFor(lib: string): Promise<string> {
-	return path.join(
+	return getRuntimePath(
 		/*turbopackIgnore: true*/ await getFigureNitroDir(),
 		`${lib}.nitro`,
 	);
@@ -81,7 +84,7 @@ export async function importSingleFigure(params: {
 	await ensureFigureDirs();
 
 	onProgress?.("downloading");
-	const swfPath = path.join(
+	const swfPath = getRuntimePath(
 		/*turbopackIgnore: true*/ await getFigureSwfDir(),
 		`${lib}.swf`,
 	);
@@ -158,7 +161,7 @@ export async function getFigureList(params: {
 		lib: l.id,
 		revision: l.revision,
 		nitroExists: existsSync(
-			/*turbopackIgnore: true*/ path.join(nitroDir, `${l.id}.nitro`),
+			/*turbopackIgnore: true*/ getRuntimePath(nitroDir, `${l.id}.nitro`),
 		),
 		previewType: l.parts?.[0]?.type,
 		previewId: l.parts?.[0]?.id,
@@ -176,7 +179,9 @@ export async function getFigureStats(): Promise<{
 		getFigureNitroDir(),
 	]);
 	const imported = libs.filter((l) =>
-		existsSync(/*turbopackIgnore: true*/ path.join(nitroDir, `${l.id}.nitro`)),
+		existsSync(
+			/*turbopackIgnore: true*/ getRuntimePath(nitroDir, `${l.id}.nitro`),
+		),
 	).length;
 	return { total: libs.length, imported, missing: libs.length - imported };
 }

src/lib/services/figuremap.test.ts

@@ -1,7 +1,7 @@
 import { promises as fs } from "node:fs";
 import os from "node:os";
-import path from "node:path";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 import type { FigureLibrary } from "./figuremap";
 import {
 	__setFigureMapPathForTests,
@@ -23,8 +23,8 @@ const LIB: FigureLibrary = {
 };
 
 beforeEach(async () => {
-	dir = await fs.mkdtemp(path.join(os.tmpdir(), "figuremap-"));
+	dir = await fs.mkdtemp(getRuntimePath(os.tmpdir(), "figuremap-"));
-	file = path.join(dir, "FigureMap.json");
+	file = getRuntimePath(dir, "FigureMap.json");
 	await fs.writeFile(file, JSON.stringify({ libraries: [LIB] }));
 	__setFigureMapPathForTests(file);
 });

src/lib/services/furni-asset-dirs.test.ts

@@ -1,6 +1,6 @@
 // @vitest-environment node
-import path from "node:path";
 import { beforeEach, describe, expect, it, vi } from "vitest";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 const { existsSyncMock, settingGetMock } = vi.hoisted(() => ({
 	existsSyncMock: vi.fn(),
@@ -19,9 +19,9 @@ vi.mock("@/lib/services/site-settings", () => ({
 import { getFurniAssetWriteTargets } from "./furni-asset-dirs";
 
 const primary = {
-	swfDir: path.join("test-assets", "primary", "swf"),
+	swfDir: getRuntimePath("test-assets", "primary", "swf"),
-	iconDir: path.join("test-assets", "primary", "icons"),
+	iconDir: getRuntimePath("test-assets", "primary", "icons"),
-	nitroDir: path.join("test-assets", "primary", "furniture"),
+	nitroDir: getRuntimePath("test-assets", "primary", "furniture"),
 };
 
 function configureSettings(values: Record<string, string>): void {
@@ -38,7 +38,7 @@ describe("getFurniAssetWriteTargets", () => {
 	});
 
 	it("maps a configured production Gamedata root to the directories served by Nitro", async () => {
-		const gamedataRoot = path.join("test-assets", "Gamedata");
+		const gamedataRoot = getRuntimePath("test-assets", "Gamedata");
 		configureSettings({
 			furni_swf_dir: primary.swfDir,
 			furni_icon_dir: primary.iconDir,
@@ -51,8 +51,8 @@ describe("getFurniAssetWriteTargets", () => {
 
 		expect(targets.mirrorDirs).toContainEqual({
 			swfDir: primary.swfDir,
-			iconDir: path.join(gamedataRoot, "icons"),
+			iconDir: getRuntimePath(gamedataRoot, "icons"),
-			nitroDir: path.join(gamedataRoot, "bundled", "furniture"),
+			nitroDir: getRuntimePath(gamedataRoot, "bundled", "furniture"),
 		});
 	});
 
@@ -71,11 +71,11 @@ describe("getFurniAssetWriteTargets", () => {
 	});
 
 	it("does not duplicate a Gamedata layout already used as the primary target", async () => {
-		const gamedataRoot = path.join("test-assets", "Gamedata");
+		const gamedataRoot = getRuntimePath("test-assets", "Gamedata");
 		configureSettings({
 			furni_swf_dir: primary.swfDir,
-			furni_icon_dir: path.join(gamedataRoot, "icons"),
+			furni_icon_dir: getRuntimePath(gamedataRoot, "icons"),
-			furni_nitro_dir: path.join(gamedataRoot, "bundled", "furniture"),
+			furni_nitro_dir: getRuntimePath(gamedataRoot, "bundled", "furniture"),
 			nitro_files_root: "",
 			gamedata_root: gamedataRoot,
 		});

src/lib/services/furni-asset-dirs.ts

@@ -1,23 +1,24 @@
 import { existsSync } from "node:fs";
 import path from "node:path";
 import { siteSettings } from "@/lib/services/site-settings";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
-export const DEFAULT_NITRO_FILES_ROOT = path.join(
+export const DEFAULT_NITRO_FILES_ROOT = getRuntimePath(
 	/*turbopackIgnore: true*/ path.dirname(process.cwd()),
 	"DEV",
 	"Nitro-Files",
 );
 export const DEFAULT_GAMEDATA_ROOT =
 	process.platform === "win32" ? "" : "/var/www/Gamedata";
-export const DEFAULT_FURNI_ICON_DIR = path.join(
+export const DEFAULT_FURNI_ICON_DIR = getRuntimePath(
 	/*turbopackIgnore: true*/ process.cwd(),
 	"public/swf/dcr/hof_furni/icons",
 );
-export const DEFAULT_FURNI_SWF_DIR = path.join(
+export const DEFAULT_FURNI_SWF_DIR = getRuntimePath(
 	/*turbopackIgnore: true*/ process.cwd(),
 	"public/swf/dcr/hof_furni/swf",
 );
-export const DEFAULT_FURNI_NITRO_DIR = path.join(
+export const DEFAULT_FURNI_NITRO_DIR = getRuntimePath(
 	/*turbopackIgnore: true*/ process.cwd(),
 	"public/nitro-assets/bundled/furniture",
 );
@@ -77,12 +78,12 @@ export async function getGamedataRoot(): Promise<string> {
 
 function dirsFromNitroFilesRoot(root: string): FurniAssetDirs {
 	return {
-		swfDir: path.join(/*turbopackIgnore: true*/ root, "swf/dcr/hof_furni"),
+		swfDir: getRuntimePath(/*turbopackIgnore: true*/ root, "swf/dcr/hof_furni"),
-		iconDir: path.join(
+		iconDir: getRuntimePath(
 			/*turbopackIgnore: true*/ root,
 			"swf/dcr/hof_furni/icons",
 		),
-		nitroDir: path.join(
+		nitroDir: getRuntimePath(
 			/*turbopackIgnore: true*/ root,
 			"nitro-assets/bundled/furniture",
 		),
@@ -95,8 +96,11 @@ function dirsFromGamedataRoot(
 ): FurniAssetDirs {
 	return {
 		swfDir: primarySwfDir,
-		iconDir: path.join(/*turbopackIgnore: true*/ root, "icons"),
+		iconDir: getRuntimePath(/*turbopackIgnore: true*/ root, "icons"),
-		nitroDir: path.join(/*turbopackIgnore: true*/ root, "bundled/furniture"),
+		nitroDir: getRuntimePath(
+			/*turbopackIgnore: true*/ root,
+			"bundled/furniture",
+		),
 	};
 }
 

src/lib/services/furni-data-i18n.ts

@@ -1,3 +1,5 @@
+import path from "node:path";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 /**
  * Localized furnidata builder — generates FurnitureData_<lang>.json files
  * (nl/en/de/fr/es/tr/it/pt/fi/pl/ru/ar/ja) from the master FurnitureData.json
@@ -10,7 +12,6 @@
  */
 
 import { existsSync, promises as fs } from "node:fs";
-import path from "node:path";
 import type { HabboGamedataHotel } from "@/lib/habbo-gamedata-hotel";
 import { habboFurnidataUrl } from "@/lib/habbo-gamedata-hotel";
 import { logger } from "@/lib/logger";
@@ -105,8 +106,8 @@ async function loadLibreCache(): Promise<Map<string, string>> {
 	try {
 		const gamedataRoot = await getGamedataRoot();
 		const cachePath = gamedataRoot
-			? path.join(gamedataRoot, "config", LIBRE_CACHE_FILE)
+			? getRuntimePath(gamedataRoot, "config", LIBRE_CACHE_FILE)
-			: path.join(process.cwd(), LIBRE_CACHE_FILE);
+			: getRuntimePath(process.cwd(), LIBRE_CACHE_FILE);
 		if (existsSync(cachePath)) {
 			const raw = await fs.readFile(cachePath, "utf-8");
 			const obj = JSON.parse(raw) as LibreCache;
@@ -126,8 +127,8 @@ async function saveLibreCache(): Promise<void> {
 	try {
 		const gamedataRoot = await getGamedataRoot();
 		const cachePath = gamedataRoot
-			? path.join(gamedataRoot, "config", LIBRE_CACHE_FILE)
+			? getRuntimePath(gamedataRoot, "config", LIBRE_CACHE_FILE)
-			: path.join(process.cwd(), LIBRE_CACHE_FILE);
+			: getRuntimePath(process.cwd(), LIBRE_CACHE_FILE);
 		const obj: LibreCache = Object.fromEntries(libreMemoryCache.entries());
 		await fs.mkdir(path.dirname(cachePath), { recursive: true });
 		await fs.writeFile(cachePath, JSON.stringify(obj), "utf-8");
@@ -363,7 +364,7 @@ async function getLocalizedWritePaths(lang: string): Promise<string[]> {
 	for (const base of bases) {
 		const dir = path.dirname(base);
 		const langFile = `FurnitureData_${lang}.json`;
-		out.push(path.join(dir, langFile));
+		out.push(getRuntimePath(dir, langFile));
 	}
 	// Deduplicate same normalized path.
 	const seen = new Set<string>();

src/lib/services/furni-data-paths.test.ts

@@ -1,8 +1,8 @@
 // @vitest-environment node
 import { promises as fs } from "node:fs";
 import os from "node:os";
-import path from "node:path";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 const { getGamedataRootMock, getNitroFilesRootMock, settingGetMock } =
 	vi.hoisted(() => ({
@@ -26,13 +26,15 @@ describe("writeFurniData production mirror", () => {
 	let tempDir: string;
 
 	beforeEach(async () => {
-		tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "furni-data-paths-"));
+		tempDir = await fs.mkdtemp(
+			getRuntimePath(os.tmpdir(), "furni-data-paths-"),
+		);
 		getNitroFilesRootMock.mockResolvedValue("");
-		getGamedataRootMock.mockResolvedValue(path.join(tempDir, "Gamedata"));
+		getGamedataRootMock.mockResolvedValue(getRuntimePath(tempDir, "Gamedata"));
 		settingGetMock.mockImplementation(
 			async (key: string, fallback: string | null = null) => {
 				if (key === "furni_data_url") {
-					return path.join(tempDir, "cms", "FurnitureData.json");
+					return getRuntimePath(tempDir, "cms", "FurnitureData.json");
 				}
 				if (key === "furni_data_mirror_path") return "";
 				return fallback;
@@ -50,7 +52,7 @@ describe("writeFurniData production mirror", () => {
 
 		await writeFurniData(data);
 
-		const livePath = path.join(
+		const livePath = getRuntimePath(
 			tempDir,
 			"Gamedata",
 			"config",
@@ -67,7 +69,7 @@ describe("writeFurniData production mirror", () => {
 		);
 
 		await expect(getFurnitureDataPath()).resolves.toBe(
-			path.join(tempDir, "Gamedata", "config", "FurnitureData.json"),
+			getRuntimePath(tempDir, "Gamedata", "config", "FurnitureData.json"),
 		);
 	});
 });

src/lib/services/furni-data.ts

@@ -9,6 +9,7 @@ import {
 import type { OfficialHabboFurniEntry } from "@/lib/services/habbo-furnidata-cache";
 import { siteSettings } from "@/lib/services/site-settings";
 import type { FurniMetadata } from "@/lib/services/swf-to-nitro";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 const LOCK_STALE_MS = 60_000;
 const DEFAULT_FURNI_DATA_URL = "/gamedata/config/FurnitureData.json";
@@ -27,14 +28,18 @@ export async function getFurnitureDataPath(): Promise<string> {
 		const gamedataRoot = await getGamedataRoot();
 		if (gamedataRoot) {
 			const relative = url.replace(/^\/gamedata\/?/, "");
-			return path.join(/*turbopackIgnore: true*/ gamedataRoot, relative);
+			return getRuntimePath(/*turbopackIgnore: true*/ gamedataRoot, relative);
 		}
 	}
 	const relative = url.replace(/^\/+/, "");
 	// The `relative` segment is admin-configurable so its concrete value is
 	// unknown at build time; without the hint Turbopack traces the entire
 	// public/ tree (~400k files) into the route's NFT.
-	return path.join(/*turbopackIgnore: true*/ process.cwd(), "public", relative);
+	return getRuntimePath(
+		/*turbopackIgnore: true*/ process.cwd(),
+		"public",
+		relative,
+	);
 }
 
 export async function getFurnitureDataWritePaths(): Promise<string[]> {
@@ -48,14 +53,14 @@ export async function getFurnitureDataWritePaths(): Promise<string[]> {
 	const mirror = configuredMirror.trim()
 		? configuredMirror
 		: nitroFilesRoot
-			? path.join(
+			? getRuntimePath(
 					/*turbopackIgnore: true*/ nitroFilesRoot,
 					"nitro-assets/gamedata/FurnitureData.json",
 				)
 			: "";
 
 	const gamedataPath = gamedataRoot
-		? path.join(
+		? getRuntimePath(
 				/*turbopackIgnore: true*/ gamedataRoot,
 				"config/FurnitureData.json",
 			)

src/lib/services/import-badge.ts

@@ -2,13 +2,14 @@ import { promises as fs } from "node:fs";
 import path from "node:path";
 import { db, WebsiteBadges } from "@/lib/db";
 import { getGamedataRoot } from "@/lib/services/furni-asset-dirs";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 export type ImportBadgeResult =
 	| { ok: true }
 	| { ok: false; error: string; status: number };
 
 function externalTextsPath(gamedataRoot: string): string {
-	return path.join(gamedataRoot, "config", "ExternalTexts.json");
+	return getRuntimePath(gamedataRoot, "config", "ExternalTexts.json");
 }
 
 /** Write badge name/desc into ExternalTexts.json (409 if already present). */

src/lib/services/import-live.test.ts

@@ -7,8 +7,8 @@
 // production FurnitureData.json, so production files are never touched.
 import { promises as fs } from "node:fs";
 import os from "node:os";
-import path from "node:path";
 import { afterAll, beforeAll, describe, expect, it, vi } from "vitest";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 const { getGamedataRootMock, getNitroFilesRootMock, settingGetMock } =
 	vi.hoisted(() => ({
@@ -126,9 +126,9 @@ beforeAll(async () => {
 		// ignore cleanup failures; the assertions will surface real problems
 	}
 
-	tmpRoot = await fs.mkdtemp(path.join(os.tmpdir(), "furni-live-audit-"));
+	tmpRoot = await fs.mkdtemp(getRuntimePath(os.tmpdir(), "furni-live-audit-"));
-	gamedataDir = path.join(tmpRoot, "Gamedata");
+	gamedataDir = getRuntimePath(tmpRoot, "Gamedata");
-	await fs.mkdir(path.join(gamedataDir, "config"), { recursive: true });
+	await fs.mkdir(getRuntimePath(gamedataDir, "config"), { recursive: true });
 	getGamedataRootMock.mockResolvedValue(gamedataDir);
 	getNitroFilesRootMock.mockResolvedValue("");
 	settingGetMock.mockImplementation(
@@ -146,7 +146,7 @@ beforeAll(async () => {
 	try {
 		await fs.copyFile(
 			productionFile,
-			path.join(gamedataDir, "config", "FurnitureData.json"),
+			getRuntimePath(gamedataDir, "config", "FurnitureData.json"),
 		);
 	} catch {
 		// file unavailable — reconcile test still runs against an empty file

src/lib/services/import/core/asset-paths.ts

@@ -1,6 +1,7 @@
 import { existsSync } from "node:fs";
 import path from "node:path";
 import { getGamedataRoot } from "@/lib/services/furni-asset-dirs";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 // The CMS default gamedata JSON paths point under public/nitro-assets/gamedata/,
 // but this deployment keeps the gamedata JSON (FigureMap/FigureData/EffectMap…)
@@ -11,7 +12,11 @@ import { getGamedataRoot } from "@/lib/services/furni-asset-dirs";
 // `bundled/` dir, the location the Nitro client loads from.)
 
 function pub(...segs: string[]): string {
-	return path.join(/*turbopackIgnore: true*/ process.cwd(), "public", ...segs);
+	return getRuntimePath(
+		/*turbopackIgnore: true*/ process.cwd(),
+		"public",
+		...segs,
+	);
 }
 
 /**
@@ -41,7 +46,7 @@ export async function resolveGamedataFile(
 	// Deployment gamedata root (e.g. /var/www/Gamedata/config/…).
 	const gamedataRoot = await getGamedataRoot();
 	if (gamedataRoot) {
-		const rootConfig = path.join(
+		const rootConfig = getRuntimePath(
 			/*turbopackIgnore: true*/ gamedataRoot,
 			"config",
 			fallbackName,

src/lib/services/import/core/gamedata-json.test.ts

@@ -1,7 +1,7 @@
 import { promises as fs } from "node:fs";
 import os from "node:os";
-import path from "node:path";
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 import {
 	readGamedataJson,
 	withGamedataLock,
@@ -12,8 +12,8 @@ let dir: string;
 let file: string;
 
 beforeEach(async () => {
-	dir = await fs.mkdtemp(path.join(os.tmpdir(), "gamedata-"));
+	dir = await fs.mkdtemp(getRuntimePath(os.tmpdir(), "gamedata-"));
-	file = path.join(dir, "EffectMap.json");
+	file = getRuntimePath(dir, "EffectMap.json");
 	await fs.writeFile(
 		file,
 		JSON.stringify({ effects: [{ id: "1", lib: "A" }] }),

src/lib/services/pet-icon.ts

@@ -1,15 +1,15 @@
 import { existsSync, readFileSync } from "node:fs";
-import path from "node:path";
 import { cropRgba, decodePng } from "@/lib/services/imager/png-decode";
 import { encodePng, parseNitroBundle } from "@/lib/services/swf/nitro-builder";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 // Pet .nitro can live in the CMS import target or the bundled asset set.
 const PET_DIRS = [
-	path.join(
+	getRuntimePath(
 		/*turbopackIgnore: true*/ process.cwd(),
 		"public/nitro-assets/bundled/pet",
 	),
-	path.join(
+	getRuntimePath(
 		/*turbopackIgnore: true*/ process.cwd(),
 		"public/Gamedata/bundled/pet",
 	),
@@ -54,7 +54,7 @@ const iconCache = new Map<string, Buffer | null>();
 
 function findNitro(lib: string): string | null {
 	for (const dir of PET_DIRS) {
-		const p = path.join(/*turbopackIgnore: true*/ dir, `${lib}.nitro`);
+		const p = getRuntimePath(/*turbopackIgnore: true*/ dir, `${lib}.nitro`);
 		if (existsSync(/*turbopackIgnore: true*/ p)) return p;
 	}
 	return null;

src/lib/services/pet-import.ts

@@ -1,8 +1,8 @@
 import { existsSync, promises as fs } from "node:fs";
-import path from "node:path";
 import { downloadFile } from "@/lib/services/import/core/download";
 import { CANONICAL_PETS, resolvePetSwfUrl } from "@/lib/services/pet-source";
 import { convertSwfToNitro } from "@/lib/services/swf-to-nitro";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 export interface PetListItem {
 	lib: string;
@@ -16,11 +16,11 @@ export interface ImportPetResult {
 	error?: string;
 }
 
-export const PET_NITRO_DIR = path.join(
+export const PET_NITRO_DIR = getRuntimePath(
 	/*turbopackIgnore: true*/ process.cwd(),
 	"public/nitro-assets/bundled/pet",
 );
-export const PET_SWF_DIR = path.join(
+export const PET_SWF_DIR = getRuntimePath(
 	/*turbopackIgnore: true*/ process.cwd(),
 	"public/swf/gordon",
 );
@@ -36,7 +36,10 @@ export async function ensurePetDirs(): Promise<void> {
 }
 
 function nitroPathFor(lib: string): string {
-	return path.join(/*turbopackIgnore: true*/ PET_NITRO_DIR, `${lib}.nitro`);
+	return getRuntimePath(
+		/*turbopackIgnore: true*/ PET_NITRO_DIR,
+		`${lib}.nitro`,
+	);
 }
 
 export async function importSinglePet(params: {
@@ -48,7 +51,7 @@ export async function importSinglePet(params: {
 	await ensurePetDirs();
 
 	onProgress?.("downloading");
-	const swfPath = path.join(
+	const swfPath = getRuntimePath(
 		/*turbopackIgnore: true*/ PET_SWF_DIR,
 		`${lib}.swf`,
 	);

src/lib/services/repair-icons.ts

@@ -1,6 +1,5 @@
 import { existsSync, promises as fs } from "node:fs";
 import os from "node:os";
-import path from "node:path";
 import { sql } from "drizzle-orm";
 import { db } from "@/lib/db";
 import { extractFurniIconPng } from "@/lib/services/clone-icon";
@@ -16,6 +15,7 @@ import {
 } from "@/lib/services/furni-asset-dirs";
 import { downloadFile } from "@/lib/services/import/core/download";
 import { classifyCatalogItem, NO_ASSET_KINDS } from "@/lib/services/item-kind";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 import { ensureDirectories } from "./furni-import";
 
 const REPAIR_CONCURRENCY = 6;
@@ -61,7 +61,7 @@ async function writeIconToDirs(
 	for (const dir of dirs) {
 		try {
 			await fs.mkdir(dir, { recursive: true });
-			await fs.writeFile(path.join(dir, fileName), icon);
+			await fs.writeFile(getRuntimePath(dir, fileName), icon);
 		} catch (err) {
 			errors.push(`write icon to ${dir} failed: ${(err as Error).message}`);
 		}
@@ -75,12 +75,12 @@ async function copyIconAcrossDirs(
 	fileName: string,
 ): Promise<string[]> {
 	const errors: string[] = [];
-	const src = path.join(srcDir, fileName);
+	const src = getRuntimePath(srcDir, fileName);
 	for (const dir of destDirs) {
 		if (dir === srcDir) continue;
 		try {
 			await fs.mkdir(dir, { recursive: true });
-			await fs.copyFile(src, path.join(dir, fileName));
+			await fs.copyFile(src, getRuntimePath(dir, fileName));
 		} catch (err) {
 			errors.push(`copy icon to ${dir} failed: ${(err as Error).message}`);
 		}
@@ -151,7 +151,7 @@ export async function repairMissingIcons(
 		const gamedataRoot = await getGamedataRoot();
 		if (gamedataRoot) {
 			const badgeFiles = await fs
-				.readdir(path.join(gamedataRoot, "album1584"))
+				.readdir(getRuntimePath(gamedataRoot, "album1584"))
 				.catch(() => [] as string[]);
 			const albumBadgeSet = new Set(
 				badgeFiles.filter((f) => f.endsWith(".gif")).map((f) => f.slice(0, -4)),
@@ -214,7 +214,7 @@ export async function repairMissingIcons(
 		// Badge items store icons as badge_<code>_icon.png (the classname already
 		// includes the `badge_` prefix, so fileName matches correctly).
 		const presentDirs = iconDirs.filter((dir) =>
-			existsSync(path.join(dir, fileName)),
+			existsSync(getRuntimePath(dir, fileName)),
 		);
 		const missingDirs = iconDirs.filter((dir) => !presentDirs.includes(dir));
 
@@ -247,7 +247,7 @@ export async function repairMissingIcons(
 		if (!ok) {
 			let foundNitro = false;
 			for (const dir of nitroDirs) {
-				const nitroPath = path.join(dir, `${classname}.nitro`);
+				const nitroPath = getRuntimePath(dir, `${classname}.nitro`);
 				if (!existsSync(nitroPath)) continue;
 				foundNitro = true;
 				try {
@@ -308,12 +308,18 @@ export async function repairMissingIcons(
 					try {
 						const dl = await downloadFile(
 							`${source.iconBaseUrl}/${iconName}`,
-							path.join(targets.iconDir, fileName),
+							/*turbopackIgnore: true*/ getRuntimePath(
+								targets.iconDir,
+								fileName,
+							),
 							{ maxRetries: 1, validate: "png" },
 						);
 						if (dl.ok) {
 							const icon = await fs.readFile(
-								path.join(targets.iconDir, fileName),
+								/*turbopackIgnore: true*/ getRuntimePath(
+									targets.iconDir,
+									fileName,
+								),
 							);
 							const writeErrors = await writeIconToDirs(
 								icon,
@@ -336,7 +342,10 @@ export async function repairMissingIcons(
 				// Some sources only ship icons embedded in their `.nitro` bundles —
 				// grab the bundle and extract the catalog icon from it.
 				if (source.nitroBaseUrl) {
-					const nitroTmp = path.join(os.tmpdir(), `.repair_${classname}.nitro`);
+					const nitroTmp = getRuntimePath(
+						os.tmpdir(),
+						`.repair_${classname}.nitro`,
+					);
 					try {
 						const dl = await downloadFile(
 							`${source.nitroBaseUrl}/${classname}.nitro`,

src/lib/services/repair-nitros.ts

@@ -1,6 +1,5 @@
 import { existsSync, promises as fs } from "node:fs";
 import os from "node:os";
-import path from "node:path";
 import { sql } from "drizzle-orm";
 import { db } from "@/lib/db";
 import {
@@ -16,6 +15,7 @@ import {
 import { downloadFile } from "@/lib/services/import/core/download";
 import { classifyCatalogItem, NO_ASSET_KINDS } from "@/lib/services/item-kind";
 import { parseNitroBundle } from "@/lib/services/swf/nitro-builder";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 import { ensureDirectories } from "./furni-import";
 import { convertSwfToNitro } from "./swf";
 import { addSize32ToBundle } from "./swf/add-size32";
@@ -63,7 +63,7 @@ async function writeNitroToDirs(
 	for (const dir of dirs) {
 		try {
 			await fs.mkdir(dir, { recursive: true });
-			await fs.writeFile(path.join(dir, fileName), nitro);
+			await fs.writeFile(getRuntimePath(dir, fileName), nitro);
 		} catch (err) {
 			errors.push(`write .nitro to ${dir} failed: ${(err as Error).message}`);
 		}
@@ -77,12 +77,12 @@ async function copyNitroAcrossDirs(
 	fileName: string,
 ): Promise<string[]> {
 	const errors: string[] = [];
-	const src = path.join(srcDir, fileName);
+	const src = getRuntimePath(srcDir, fileName);
 	for (const dir of destDirs) {
 		if (dir === srcDir) continue;
 		try {
 			await fs.mkdir(dir, { recursive: true });
-			await fs.copyFile(src, path.join(dir, fileName));
+			await fs.copyFile(src, getRuntimePath(dir, fileName));
 		} catch (err) {
 			errors.push(`copy .nitro to ${dir} failed: ${(err as Error).message}`);
 		}
@@ -150,7 +150,7 @@ export async function repairMissingNitros(
 		const gamedataRoot = await getGamedataRoot();
 		if (gamedataRoot) {
 			const badgeFiles = await fs
-				.readdir(path.join(gamedataRoot, "album1584"))
+				.readdir(getRuntimePath(gamedataRoot, "album1584"))
 				.catch(() => [] as string[]);
 			albumBadgeSet = new Set(
 				badgeFiles.filter((f) => f.endsWith(".gif")).map((f) => f.slice(0, -4)),
@@ -210,7 +210,7 @@ export async function repairMissingNitros(
 		const fileName = `${classname}.nitro`;
 
 		const presentDirs = nitroDirs.filter((dir) =>
-			existsSync(path.join(dir, fileName)),
+			existsSync(getRuntimePath(dir, fileName)),
 		);
 		const missingDirs = nitroDirs.filter((dir) => !presentDirs.includes(dir));
 
@@ -269,7 +269,7 @@ export async function repairMissingNitros(
 
 			for (const source of sources) {
 				for (const nitroName of nitroCandidates) {
-					const tmpPath = path.join(
+					const tmpPath = getRuntimePath(
 						os.tmpdir(),
 						`.repair_nitro_${classname}_${Math.random().toString(36).slice(2, 8)}.nitro`,
 					);
@@ -469,7 +469,7 @@ export async function reconvertAllNitros(
 
 	const basesToProcess: string[] = [];
 	for (const base of existingBases) {
-		if (existsSync(path.join(targets.swfDir, `${base}.swf`))) {
+		if (existsSync(getRuntimePath(targets.swfDir, `${base}.swf`))) {
 			basesToProcess.push(base);
 		}
 	}
@@ -492,7 +492,7 @@ export async function reconvertAllNitros(
 			return;
 		}
 
-		const swfPath = path.join(targets.swfDir, `${base}.swf`);
+		const swfPath = getRuntimePath(targets.swfDir, `${base}.swf`);
 		let swf: Buffer;
 		try {
 			swf = await fs.readFile(swfPath);
@@ -636,7 +636,7 @@ export async function addSize32AllNitros(
 			let buf: Buffer | null = null;
 			for (const dir of nitroDirs) {
 				try {
-					buf = await fs.readFile(path.join(dir, fileName));
+					buf = await fs.readFile(getRuntimePath(dir, fileName));
 					break;
 				} catch {
 					/* try next dir */

src/lib/services/soundtracks.ts

@@ -14,14 +14,14 @@
  * `soundtrack_base_url` — see site-settings.ts defaults.
  */
 import { promises as fs } from "node:fs";
-import path from "node:path";
 import { parseBuffer } from "music-metadata";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 // ── Constants ──────────────────────────────────────────────────────
 
 /** On-disk directory where MP3s live. Fixed (not configurable from UI to
  *  avoid any path traversal risk). */
-export const SOUNDTRACK_DIR = path.join(
+export const SOUNDTRACK_DIR = getRuntimePath(
 	process.cwd(),
 	"public",
 	"swf",
@@ -48,7 +48,7 @@ export function getSoundtrackPath(code: string): string {
 	if (!isSafeSoundtrackCode(code)) {
 		throw new Error(`Unsafe soundtrack code: ${code}`);
 	}
-	return path.join(SOUNDTRACK_DIR, `${code}.mp3`);
+	return getRuntimePath(SOUNDTRACK_DIR, `${code}.mp3`);
 }
 
 /** Ensure the sounds directory exists (mkdir -p). */

src/lib/services/swf/conversion-worker.ts

@@ -31,21 +31,21 @@ if (parentPort) {
 		try {
 			if (msg.type === "convert") {
 				const result = convertSwfToNitro(msg.buffer, msg.classname);
-				parentPort!.postMessage({
+				parentPort?.postMessage({
 					id: msg.id,
 					ok: true,
 					result,
 				} satisfies WorkerResponse);
 			} else {
 				const icon = extractIconFromSwf(msg.buffer, msg.classname);
-				parentPort!.postMessage({
+				parentPort?.postMessage({
 					id: msg.id,
 					ok: true,
 					icon: icon ?? null,
 				} satisfies WorkerResponse);
 			}
 		} catch (err) {
-			parentPort!.postMessage({
+			parentPort?.postMessage({
 				id: msg.id,
 				ok: false,
 				error: (err as Error).message,

src/lib/services/swf/swf-parser.ts

@@ -3,7 +3,8 @@
  */
 
 import { inflateSync } from "node:zlib";
-import LZMA from "lzma";
+
+const LZMA = require("lzma/src/lzma_worker").LZMA_WORKER;
 
 // ── SWF Tag Types ──────────────────────────────────────────────────
 export const TAG_END = 0;

src/lib/services/upload-import.test.ts

@@ -1,8 +1,8 @@
 // @vitest-environment node
 import { promises as fs } from "node:fs";
 import os from "node:os";
-import path from "node:path";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { getRuntimePath } from "@/lib/utils/runtime-path";
 
 const {
 	appendFurniEntryMock,
@@ -96,15 +96,15 @@ describe("uploadSingleFurni live asset mirrors", () => {
 
 	beforeEach(async () => {
 		__resetUploadItemsBaseAllocatorForTests();
-		tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "upload-furni-"));
+		tempDir = await fs.mkdtemp(getRuntimePath(os.tmpdir(), "upload-furni-"));
-		assetTargets.swfDir = path.join(tempDir, "cms", "swf");
+		assetTargets.swfDir = getRuntimePath(tempDir, "cms", "swf");
-		assetTargets.iconDir = path.join(tempDir, "cms", "icons");
+		assetTargets.iconDir = getRuntimePath(tempDir, "cms", "icons");
-		assetTargets.nitroDir = path.join(tempDir, "cms", "furniture");
+		assetTargets.nitroDir = getRuntimePath(tempDir, "cms", "furniture");
 		assetTargets.mirrorDirs = [
 			{
 				swfDir: assetTargets.swfDir,
-				iconDir: path.join(tempDir, "Gamedata", "icons"),
+				iconDir: getRuntimePath(tempDir, "Gamedata", "icons"),
-				nitroDir: path.join(tempDir, "Gamedata", "bundled", "furniture"),
+				nitroDir: getRuntimePath(tempDir, "Gamedata", "bundled", "furniture"),
 			},
 		];
 		dbExecuteMock.mockReset();
@@ -135,12 +135,12 @@ describe("uploadSingleFurni live asset mirrors", () => {
 		expect(result.ok).toBe(true);
 		await expect(
 			fs.readFile(
-				path.join(assetTargets.mirrorDirs[0].nitroDir, "chair.nitro"),
+				getRuntimePath(assetTargets.mirrorDirs[0].nitroDir, "chair.nitro"),
 			),
 		).resolves.toEqual(nitroBuffer);
 		await expect(
 			fs.readFile(
-				path.join(assetTargets.mirrorDirs[0].iconDir, "chair_icon.png"),
+				getRuntimePath(assetTargets.mirrorDirs[0].iconDir, "chair_icon.png"),
 			),
 		).resolves.toEqual(iconBuffer);
 	});

src/lib/services/upload-import.ts

@@ -17,6 +17,7 @@ import {
 } from "@/lib/services/furni-import";
 import { nitroAnimationStatesCount } from "@/lib/services/furni-real-interaction";
 import { parseNitroBundle } from "@/lib/services/swf/nitro-builder";
+import { getRuntimePath, getRuntimeResolve } from "@/lib/utils/runtime-path";
 
 export interface UploadResult {
 	ok: boolean;
@@ -42,7 +43,7 @@ export interface UploadParams {
 	customparams?: string;
 }
 
-const MIGRATIONS_DIR = path.resolve(
+const MIGRATIONS_DIR = getRuntimeResolve(
 	/*turbopackIgnore: true*/ process.cwd(),
 	"drizzle/migrations",
 );
@@ -67,7 +68,7 @@ async function mirrorUploadedAsset(
 	const sourceKey = pathKey(sourcePath);
 	const seen = new Set<string>();
 	for (const dir of dirs) {
-		const targetPath = path.join(/*turbopackIgnore: true*/ dir, fileName);
+		const targetPath = getRuntimePath(/*turbopackIgnore: true*/ dir, fileName);
 		const targetKey = pathKey(targetPath);
 		if (targetKey === sourceKey || seen.has(targetKey)) continue;
 		seen.add(targetKey);
@@ -166,7 +167,7 @@ async function writeSqlMigration(params: {
 	const padded = String(num).padStart(4, "0");
 	const className = params.classname.replace(/[^a-zA-Z0-9_-]/g, "_");
 	const fileName = `${padded}_import_furni_${className}.sql`;
-	const filePath = path.join(
+	const filePath = getRuntimePath(
 		/*turbopackIgnore: true*/ MIGRATIONS_DIR,
 		fileName,
 	);
@@ -283,7 +284,7 @@ export async function uploadSingleFurni(params: {
 	const { iconDir, nitroDir } = assetTargets;
 
 	const nitroFileName = `${classname}.nitro`;
-	const nitroPath = path.join(
+	const nitroPath = getRuntimePath(
 		/*turbopackIgnore: true*/ nitroDir,
 		nitroFileName,
 	);
@@ -301,7 +302,7 @@ export async function uploadSingleFurni(params: {
 	let iconPath: string | null = null;
 	if (iconBuffer && iconBuffer.length > 0) {
 		iconFileName = `${classname}_icon.png`;
-		iconPath = path.join(/*turbopackIgnore: true*/ iconDir, iconFileName);
+		iconPath = getRuntimePath(/*turbopackIgnore: true*/ iconDir, iconFileName);
 		await fs.writeFile(iconPath, iconBuffer);
 	}
 

src/lib/utils/runtime-path.ts

@@ -0,0 +1,11 @@
+import path from "node:path";
+
+export function getRuntimePath(...segments: string[]): string {
+	const resolvePath = new Function("p", "segs", "return p.join(...segs)");
+	return resolvePath(path, segments);
+}
+
+export function getRuntimeResolve(...segments: string[]): string {
+	const resolvePath = new Function("p", "segs", "return p.resolve(...segs)");
+	return resolvePath(path, segments);
+}

src/messages/bg.json

@@ -754,6 +754,7 @@
 			"termsAccept": "Аз съм на 18+ и приемам условията и правилата на {hotel}.",
 			"createAccount": "Създаване на акаунт",
 			"creatingAccount": "Създаване на акаунт...",
+			"redirecting": "Прехвърляне към вашия акаунт...",
 			"alreadyHaveAccount": "Вече имате акаунт? Вход!",
 			"register": "Регистрирайте се",
 			"termsError": "Трябва да приемете условията и правилата, за да се регистрирате.",

src/messages/cs.json

@@ -754,6 +754,7 @@
 			"termsAccept": "Je mi 18+ a souhlasím s podmínkami a pravidly {hotel}.",
 			"createAccount": "Vytvořit účet",
 			"creatingAccount": "Vytváření účtu...",
+			"redirecting": "Přesměrovávám na váš účet...",
 			"alreadyHaveAccount": "Už máte účet? Přihlášení!",
 			"register": "Zaregistrujte se",
 			"termsError": "Chcete-li se zaregistrovat, musíte přijmout podmínky a pravidla.",

src/messages/da.json

@@ -754,6 +754,7 @@
 			"termsAccept": "Jeg er 18+ og accepterer vilkårene og reglerne for {hotel}.",
 			"createAccount": "Opret konto",
 			"creatingAccount": "Opretter konto...",
+			"redirecting": "Omdirigerer til din konto...",
 			"alreadyHaveAccount": "Har du allerede en konto? Log ind!",
 			"register": "Tilmeld dig",
 			"termsError": "Du skal acceptere vilkårene og reglerne for at registrere dig.",

src/messages/de.json

@@ -724,6 +724,7 @@
 			"termsAccept": "Ich bin 18+ und akzeptiere die {hotel} AGB & Regeln.",
 			"createAccount": "Konto erstellen",
 			"creatingAccount": "Konto wird erstellt...",
+			"redirecting": "Weiterleitung zu deinem Account...",
 			"alreadyHaveAccount": "Bereits ein Konto? Anmelden!",
 			"register": "Registrieren",
 			"termsError": "Du musst die AGB & Regeln akzeptieren, um dich zu registrieren.",

src/messages/el.json

@@ -754,6 +754,7 @@
 			"termsAccept": "Είμαι 18+ και αποδέχομαι τους όρους και τους κανόνες του {hotel}.",
 			"createAccount": "Δημιουργία λογαριασμού",
 			"creatingAccount": "Δημιουργία λογαριασμού...",
+			"redirecting": "Ανακατεύθυνση στον λογαριασμό σας...",
 			"alreadyHaveAccount": "Έχετε ήδη λογαριασμό; Σύνδεση!",
 			"register": "Εγγραφή",
 			"termsError": "Πρέπει να αποδεχτείτε τους όρους και τους κανόνες για να εγγραφείτε.",

src/messages/en.json

@@ -903,6 +903,7 @@
 			"termsAccept": "I am 18+ and accept the {hotel} terms & rules.",
 			"createAccount": "Create account",
 			"creatingAccount": "Creating account...",
+			"redirecting": "Redirecting to your account...",
 			"alreadyHaveAccount": "Already have an account? Login!",
 			"alreadyHaveAccountPre": "Already have an account?",
 			"alreadyHaveAccountLink": "Sign in",

src/messages/es.json

@@ -724,6 +724,7 @@
 			"termsAccept": "Soy mayor de 18 años y acepto los términos y reglas de {hotel}.",
 			"createAccount": "Crear cuenta",
 			"creatingAccount": "Creando cuenta...",
+			"redirecting": "Redirigiendo a tu cuenta...",
 			"alreadyHaveAccount": "¿Ya tienes una cuenta? ¡Inicia sesión!",
 			"register": "Registrarse",
 			"termsError": "Debes aceptar los términos y reglas para registrarte.",

src/messages/fr.json

@@ -724,6 +724,7 @@
 			"termsAccept": "J'ai 18 ans ou plus et j'accepte les conditions et règles de {hotel}.",
 			"createAccount": "Créer un compte",
 			"creatingAccount": "Création du compte...",
+			"redirecting": "Redirection vers votre compte...",
 			"alreadyHaveAccount": "Vous avez déjà un compte ? Connectez-vous !",
 			"register": "S'inscrire",
 			"termsError": "Vous devez accepter les conditions et règles pour vous inscrire.",

src/messages/hr.json

@@ -754,6 +754,7 @@
 			"termsAccept": "Imam 18+ godina i prihvaćam odredbe i pravila hotela {hotel}.",
 			"createAccount": "Napravi račun",
 			"creatingAccount": "Izrada računa...",
+			"redirecting": "Preusmjeravanje na vaš račun...",
 			"alreadyHaveAccount": "Već imate račun? Prijava!",
 			"register": "Registrirajte se",
 			"termsError": "Za registraciju morate prihvatiti uvjete i pravila.",

src/messages/hu.json

@@ -754,6 +754,7 @@
 			"termsAccept": "18 évesnél idősebb vagyok, és elfogadom a {hotel} feltételeit és szabályait.",
 			"createAccount": "Hozzon létre fiókot",
 			"creatingAccount": "Fiók létrehozása...",
+			"redirecting": "Átirányítás a fiókjához...",
 			"alreadyHaveAccount": "Már van fiókja? Bejelentkezés!",
 			"register": "Regisztráció",
 			"termsError": "A regisztrációhoz el kell fogadnia a feltételeket és szabályokat.",

src/messages/it.json

@@ -877,6 +877,7 @@
 			"termsAccept": "Ho 18+ anni e accetto i termini e regole di {hotel}.",
 			"createAccount": "Crea account",
 			"creatingAccount": "Creazione account...",
+			"redirecting": "Reindirizzamento al tuo account...",
 			"alreadyHaveAccount": "Hai già un account? Accedi!",
 			"register": "Registrati",
 			"termsError": "Devi accettare i termini e regole per registrarti.",

src/messages/nl.json

@@ -907,6 +907,7 @@
 			"termsAccept": "Ik ben 18+ en accepteer de {hotel} voorwaarden & regels.",
 			"createAccount": "Account aanmaken",
 			"creatingAccount": "Account wordt aangemaakt...",
+			"redirecting": "Doorgaan naar je account...",
 			"alreadyHaveAccount": "Al een account? Inloggen!",
 			"register": "Registreren",
 			"alreadyHaveAccountPre": "Al een account?",

src/messages/no.json

@@ -754,6 +754,7 @@
 			"termsAccept": "Jeg er 18+ og godtar vilkårene og reglene for {hotel}.",
 			"createAccount": "Opprett konto",
 			"creatingAccount": "Oppretter konto ...",
+			"redirecting": "Videre til kontoen din...",
 			"alreadyHaveAccount": "Har du allerede en konto? Logg inn!",
 			"register": "Registrer deg",
 			"termsError": "Du må godta vilkårene og reglene for å registrere deg.",

src/messages/pl.json

@@ -754,6 +754,7 @@
 			"termsAccept": "Mam ukończone 18 lat i akceptuję warunki i zasady hotelu {hotel}.",
 			"createAccount": "Utwórz konto",
 			"creatingAccount": "Tworzenie konta...",
+			"redirecting": "Przekierowywanie na twoje konto...",
 			"alreadyHaveAccount": "Masz już konto? Login!",
 			"register": "Zarejestruj się",
 			"termsError": "Aby się zarejestrować, musisz zaakceptować regulamin.",

src/messages/pt.json

@@ -754,6 +754,7 @@
 			"termsAccept": "Tenho mais de 18 anos e aceito os termos e regras do {hotel}.",
 			"createAccount": "Criar conta",
 			"creatingAccount": "Criando conta...",
+			"redirecting": "A redirecionar para a sua conta...",
 			"alreadyHaveAccount": "Já tem uma conta? Conecte-se!",
 			"register": "Cadastre-se",
 			"termsError": "Você deve aceitar os termos e regras para se registrar.",

src/messages/ro.json

@@ -754,6 +754,7 @@
 			"termsAccept": "Am peste 18 ani și accept termenii și regulile {hotel}.",
 			"createAccount": "Creați cont",
 			"creatingAccount": "Se creează cont...",
+			"redirecting": "Se redirecționează către contul tău...",
 			"alreadyHaveAccount": "Aveți deja un cont? Log in!",
 			"register": "Înregistrează-te",
 			"termsError": "Trebuie să acceptați termenii și regulile pentru a vă înregistra.",

src/messages/ru.json

@@ -752,6 +752,7 @@
 			"termsAccept": "Мне 18+ и я принимаю условия и правила {hotel}.",
 			"createAccount": "Создать аккаунт",
 			"creatingAccount": "Создание учетной записи...",
+			"redirecting": "Переход в ваш аккаунт...",
 			"alreadyHaveAccount": "Уже есть аккаунт? Войти!",
 			"register": "Регистрация",
 			"termsError": "Чтобы зарегистрироваться, вы должны принять условия и правила.",

src/messages/sk.json

@@ -754,6 +754,7 @@
 			"termsAccept": "Mám 18+ a súhlasím so zmluvnými podmienkami a pravidlami {hotel}.",
 			"createAccount": "Vytvoriť účet",
 			"creatingAccount": "Vytvára sa účet...",
+			"redirecting": "Presmerovávam na váš účet...",
 			"alreadyHaveAccount": "Už máte účet? Prihláste sa!",
 			"register": "Zaregistrujte sa",
 			"termsError": "Ak sa chcete zaregistrovať, musíte prijať podmienky a pravidlá.",

src/messages/sr.json

@@ -754,6 +754,7 @@
 			"termsAccept": "I am 18+ and accept the {hotel} terms & rules.",
 			"createAccount": "Креирајте налог",
 			"creatingAccount": "Прављење налога...",
+			"redirecting": "Преусмеравање на ваш налог...",
 			"alreadyHaveAccount": "Већ имате налог? Пријавите се!",
 			"register": "Региструјте се",
 			"termsError": "Морате прихватити услове и правила да бисте се регистровали.",

src/messages/sv.json

@@ -754,6 +754,7 @@
 			"termsAccept": "Jag är 18+ och accepterar villkoren och reglerna för {hotel}.",
 			"createAccount": "Skapa konto",
 			"creatingAccount": "Skapar konto...",
+			"redirecting": "Vidare till ditt konto...",
 			"alreadyHaveAccount": "Har du redan ett konto? Inloggning!",
 			"register": "Registrera dig",
 			"termsError": "Du måste acceptera villkoren och reglerna för att registrera dig.",

src/messages/tr.json

@@ -754,6 +754,7 @@
 			"termsAccept": "18 yaşındayım ve {hotel} şartlarını ve kurallarını kabul ediyorum.",
 			"createAccount": "Hesap oluştur",
 			"creatingAccount": "Hesap oluşturuluyor...",
+			"redirecting": "Hesabınıza yönlendiriliyorsunuz...",
 			"alreadyHaveAccount": "Zaten bir hesabınız var mı? Giriş yapmak!",
 			"register": "Kayıt ol",
 			"termsError": "Kayıt olmak için şartları ve kuralları kabul etmelisiniz.",

src/messages/uk.json

@@ -754,6 +754,7 @@
 			"termsAccept": "Мені 18+ і я приймаю умови та правила {hotel}.",
 			"createAccount": "Створити акаунт",
 			"creatingAccount": "Створення облікового запису...",
+			"redirecting": "Перехід до вашого акаунту...",
 			"alreadyHaveAccount": "Вже маєте акаунт? Вхід!",
 			"register": "зареєструватися",
 			"termsError": "Ви повинні прийняти умови та правила, щоб зареєструватися.",

src/types/lzma.d.ts

@@ -1,7 +1,14 @@
 declare module "lzma" {
-	const lzma: {
+	export const LZMA: any;
-		decompress(input: Buffer | Uint8Array | number[]): number[];
+	export function decompress(
-		compress(input: string | Uint8Array | number[], mode?: number): number[];
+		byte_array: any,
-	};
+		on_finish?: (result: any, error: any) => void,
-	export default lzma;
+		on_progress?: (percent: number) => void,
+	): any;
+	export function compress(
+		string: string | Uint8Array,
+		mode: number,
+		on_finish?: (result: any, error: any) => void,
+		on_progress?: (percent: number) => void,
+	): any;
 }