feat(catalog): store furniture bundles as .hab instead of .nitro

Every bundle the CMS writes — upload, clone, sync, repair and the pet /
effect / figure importers — now lands as `<classname>.hab`, the extension
this deployment's renderer asks for. `.hab` and `.nitro` are the same
container, so an upload of either extension is accepted.

Resolution goes through one module, src/lib/furni/bundle-file.ts, so
nothing has to know the extension twice. Every existence check probes
`.hab` first and falls back to `.nitro`: the on-disk asset set is still
predominantly `.nitro`, and without the fallback Studio would report every
imported item as missing and the cleanup scan would classify 18k live
bundles as fake leftovers. Downloads are unchanged — Habbo's CDN and every
configured clone source still serve `.nitro`, so the conversion happens on
write, not on request.

Deliberately unchanged: the staged-attachment store in furni-attachment.ts
keys on a UUID and never reaches the client, so renaming it would break
in-flight recovery jobs.

Adds scripts/migrate-nitro-to-hab.ts to rename the existing asset set. It
refuses to run without --dry-run or --yes, never overwrites an existing
.hab, never deletes, and is idempotent.

Note: renderer-config.json lives outside this repo and was patched to
.hab separately; that file is served with a 30-day max-age, so returning
clients need a cms-client cache purge to pick the change up.

src/app/api/admin/import/furni/batch-regen/route.ts

@@ -4,6 +4,10 @@ import { eq } from "drizzle-orm";
 import { apiError } from "@/lib/api";
 import { withAdmin } from "@/lib/api-handler";
 import { db, ItemsBase } from "@/lib/db";
+import {
+	bundleExistsInDir,
+	bundleWritePathInDir,
+} from "@/lib/furni/bundle-file";
 import { PERMS } from "@/lib/permissions";
 import { getFurniAssetDirs } from "@/lib/services/furni-asset-dirs";
 import {
@@ -103,12 +107,12 @@ export const POST = withAdmin(
 							starIdx !== -1
 								? item.classname.substring(0, starIdx)
 								: item.classname;
-						const nitroPath = path.join(
-							/*turbopackIgnore: true*/ nitroDir,
-							`${baseClassname}.nitro`,
-						);
-
-						if (existsSync(/*turbopackIgnore: true*/ nitroPath)) {
+						if (
+							bundleExistsInDir(
+								/*turbopackIgnore: true*/ nitroDir,
+								baseClassname,
+							)
+						) {
 							skipped++;
 							send({
 								type: "regen_progress",
@@ -203,6 +207,10 @@ export const POST = withAdmin(
 								swfBuffer,
 								baseClassname,
 							);
+							const nitroPath = bundleWritePathInDir(
+								/*turbopackIgnore: true*/ nitroDir,
+								baseClassname,
+							);
 							await fs.writeFile(nitroPath, conversion.bundle);
 
 							// Build FurnitureData entry if missing

src/app/api/admin/import/furni/nitro-editor/route.ts

@@ -1,10 +1,10 @@
-import { existsSync, promises as fs } from "node:fs";
-import path from "node:path";
+import { promises as fs } from "node:fs";
 import { eq, sql } from "drizzle-orm";
 import type { NextRequest } from "next/server";
 import { apiError, apiOk } from "@/lib/api";
 import { withAdmin } from "@/lib/api-handler";
 import { db, ItemsBase, queryRows } from "@/lib/db";
+import { resolveBundleInDir } from "@/lib/furni/bundle-file";
 import { PERMS } from "@/lib/permissions";
 import { logAudit } from "@/lib/services/audit";
 import { getFurniAssetDirs } from "@/lib/services/furni-asset-dirs";
@@ -25,7 +25,7 @@ function baseClassname(classname: string): string {
 	return classname.includes("*") ? classname.split("*")[0] : classname;
 }
 
-// ── GET: Read .nitro metadata ──────────────────────────────────────
+// ── GET: Read bundle metadata ──────────────────────────────────────
 
 export const GET = withAdmin(
 	{ permission: PERMS.ASSETS_IMPORT },
@@ -35,13 +35,12 @@ export const GET = withAdmin(
 
 		const base = baseClassname(rawClassname);
 		const { nitroDir } = await getFurniAssetDirs();
-		const nitroPath = path.join(
+		const nitroPath = resolveBundleInDir(
 			/*turbopackIgnore: true*/ nitroDir,
-			`${base}.nitro`,
+			base,
 		);
 
-		if (!existsSync(/*turbopackIgnore: true*/ nitroPath))
-			return apiError("Nitro file not found", 404);
+		if (!nitroPath) return apiError("Bundle file not found", 404);
 
 		try {
 			const buffer = await fs.readFile(/*turbopackIgnore: true*/ nitroPath);
@@ -67,15 +66,15 @@ export const GET = withAdmin(
 			return apiOk({ metadata: json, flags });
 		} catch (err) {
 			console.error(
-				"[nitro-editor] Failed to parse .nitro:",
+				"[nitro-editor] Failed to parse bundle:",
 				(err as Error).message,
 			);
-			return apiError("Failed to parse .nitro file", 500);
+			return apiError("Failed to parse bundle file", 500);
 		}
 	},
 );
 
-// ── PUT: Save .nitro metadata ──────────────────────────────────────
+// ── PUT: Save bundle metadata ──────────────────────────────────────
 
 export const PUT = withAdmin(
 	{ permission: PERMS.ASSETS_IMPORT },
@@ -94,13 +93,15 @@ export const PUT = withAdmin(
 
 		const base = baseClassname(rawClassname);
 		const { nitroDir } = await getFurniAssetDirs();
-		const nitroPath = path.join(
+		// Write back to whichever extension the file already carries, so
+		// editing metadata never migrates a legacy `.nitro` to `.hab` (or the
+		// reverse) as a side effect.
+		const nitroPath = resolveBundleInDir(
 			/*turbopackIgnore: true*/ nitroDir,
-			`${base}.nitro`,
+			base,
 		);
 
-		if (!existsSync(/*turbopackIgnore: true*/ nitroPath))
-			return apiError("Nitro file not found", 404);
+		if (!nitroPath) return apiError("Bundle file not found", 404);
 
 		const saved = await withFurniDataLock(async () => {
 			const existingBuffer = await fs.readFile(nitroPath);

src/app/api/admin/import/furni/route.ts

@@ -5,6 +5,10 @@ import { invalidateCatalogTotals } from "@/features/catalog/server/catalog-total
 import { apiError, apiOk } from "@/lib/api";
 import { withAdmin } from "@/lib/api-handler";
 import { db, ItemsBase, queryRows } from "@/lib/db";
+import {
+	bundleExistsInDir,
+	bundleWritePathInDir,
+} from "@/lib/furni/bundle-file";
 import { isSafeAssetName, normalizeClassname } from "@/lib/furni/classname";
 import { localFurnitureStatus } from "@/lib/furni/local-presence";
 import { PERMS } from "@/lib/permissions";
@@ -723,13 +727,16 @@ export const PATCH = withAdmin(
 			const starIdx = normalised.indexOf("*");
 			const baseClassname =
 				starIdx !== -1 ? normalised.substring(0, starIdx) : normalised;
-			const nitroPath = path.join(
+			// Regeneration writes `.hab`; a legacy `.nitro` counts as present too.
+			const nitroPath = bundleWritePathInDir(
 				/*turbopackIgnore: true*/ nitroDir,
-				`${baseClassname}.nitro`,
+				baseClassname,
 			);
 
-			// Skip if .nitro already exists
-			if (existsSync(/*turbopackIgnore: true*/ nitroPath)) {
+			// Skip if a bundle already exists (`.hab` or legacy `.nitro`).
+			if (
+				bundleExistsInDir(/*turbopackIgnore: true*/ nitroDir, baseClassname)
+			) {
 				results.push({
 					classname: item.classname,
 					ok: true,

src/app/api/admin/import/furni/upload/route.ts

@@ -27,7 +27,9 @@ export const POST = withAdmin(
 			(formData.get("interactionType") as string)?.trim() || "default";
 		const customparams = (formData.get("customparams") as string)?.trim() || "";
 		const generateSql = formData.get("generateSql") === "true";
-		const nitroFile = formData.get("nitro") as File | null;
+		const nitroFile =
+			(formData.get("nitro") as File | null) ??
+			(formData.get("hab") as File | null);
 		const iconFile = formData.get("icon") as File | null;
 
 		if (!classname) return apiError("classname is required", 400);
@@ -35,10 +37,10 @@ export const POST = withAdmin(
 		if (!itemType || !["s", "i"].includes(itemType))
 			return apiError("itemType must be 's' or 'i'", 400);
 		if (!nitroFile || nitroFile.size === 0)
-			return apiError(".nitro file is required", 400);
+			return apiError(".hab file is required", 400);
 
 		if (nitroFile.size > 50 * 1024 * 1024)
-			return apiError(".nitro file too large (max 50MB)", 400);
+			return apiError(".hab file too large (max 50MB)", 400);
 
 		const nitroBuffer = Buffer.from(await nitroFile.arrayBuffer());