refactor(db): typed query helpers, shared test FormData helper

Replace raw db.execute tuple casts with queryRows/rowsFrom/execResult/
affectedRows helpers from lib/db, drop redundant mysql2 casts on typed
query builders, and centralize per-test fakeForm into test/fake-form.
Update db mocks in tests so helpers resolve against mocked execute.

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

@@ -4,7 +4,7 @@ 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 } from "@/lib/db";
+import { db, ItemsBase, queryRows } from "@/lib/db";
 import { PERMS } from "@/lib/permissions";
 import { logAudit } from "@/lib/services/audit";
 import { getFurniAssetDirs } from "@/lib/services/furni-asset-dirs";
@@ -48,17 +48,14 @@ export const GET = withAdmin(
 			const { json } = parseNitroBundle(buffer);
 
 			// Fetch interaction flags from DB
-			const [items] = (await db.execute(sql`
+			const items = await queryRows<{
+				allow_sit: string;
+				allow_lay: string;
+				allow_walk: string;
+			}>(sql`
         SELECT allow_sit, allow_lay, allow_walk
         FROM items_base WHERE item_name = ${rawClassname} LIMIT 1
-      `)) as unknown as [
-				Array<{
-					allow_sit: string;
-					allow_lay: string;
-					allow_walk: string;
-				}>,
-				unknown,
-			];
+      `);
 
 			const dbRow = items[0];
 			const flags = {

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

@@ -2,7 +2,7 @@ import { existsSync } from "node:fs";
 import { asc, inArray, sql } from "drizzle-orm";
 import { apiOk } from "@/lib/api";
 import { withAdmin } from "@/lib/api-handler";
-import { db, ItemsBase } from "@/lib/db";
+import { db, ItemsBase, queryRows } from "@/lib/db";
 import { PERMS } from "@/lib/permissions";
 import {
 	appendFurniEntriesBatch,
@@ -221,7 +221,7 @@ async function resolveTargetIds(
 		Date.now() - days * 24 * 60 * 60 * 1000,
 	).toISOString();
 	const sinceMysql = sinceIso.slice(0, 19).replace("T", " ");
-	const [auditRows] = (await db.execute(sql`
+	const auditRows = await queryRows<{ target_id: number }>(sql`
     SELECT DISTINCT target_id
     FROM admin_audit_log
     WHERE action = 'furni_import'
@@ -229,6 +229,6 @@ async function resolveTargetIds(
       AND target_id IS NOT NULL
       AND created_at >= ${sinceMysql}
     ORDER BY target_id ASC
-  `)) as unknown as [Array<{ target_id: number }>, unknown];
+  `);
 	return auditRows.map((r) => r.target_id).filter(Boolean);
 }

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

@@ -3,7 +3,7 @@ import path from "node:path";
 import { eq, sql } from "drizzle-orm";
 import { apiError, apiOk } from "@/lib/api";
 import { withAdmin } from "@/lib/api-handler";
-import { db, ItemsBase } from "@/lib/db";
+import { db, ItemsBase, queryRows } from "@/lib/db";
 import { normalizeClassname } from "@/lib/furni/classname";
 import { localFurnitureStatus } from "@/lib/furni/local-presence";
 import { PERMS } from "@/lib/permissions";
@@ -184,21 +184,18 @@ export const GET = withAdmin(
 			);
 			const perPage = 500;
 
-			const [importedItems] = (await db.execute(sql`
+			const importedItems = await queryRows<{
+				item_name: string;
+				public_name: string;
+				sprite_id: number;
+				type: string;
+			}>(sql`
         SELECT ib.item_name, ib.public_name, ib.sprite_id, ib.type FROM items_base ib
         WHERE EXISTS (
           SELECT 1 FROM catalog_items ci
           WHERE FIND_IN_SET(ib.id, REPLACE(ci.item_ids, ';', ',')) > 0
         )
-      `)) as unknown as [
-				Array<{
-					item_name: string;
-					public_name: string;
-					sprite_id: number;
-					type: string;
-				}>,
-				unknown,
-			];
+      `);
 
 			// Filter to only those missing .nitro on filesystem (memoized — fast)
 			const missing = importedItems.filter((item) => {

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

@@ -9,7 +9,7 @@ import {
 } from "@/features/catalog/server/import-pages";
 import { apiOk } from "@/lib/api";
 import { withAdmin } from "@/lib/api-handler";
-import { db, ItemsBase } from "@/lib/db";
+import { db, ItemsBase, queryRows } from "@/lib/db";
 import { PERMS } from "@/lib/permissions";
 
 interface OrganizeItem {
@@ -59,7 +59,7 @@ export const GET = withAdmin(
 		const placedById = new Map<number, OrganizeItem>();
 		const itemIdsToResolve = new Set<number>();
 		if (pageIds.length > 0) {
-			const [rows] = (await db.execute(sql`
+			const rows = await queryRows<Record<string, unknown>>(sql`
         SELECT ci.id AS catalogItemId,
                ci.page_id AS sourcePageId,
                ci.item_ids AS itemIds,
@@ -70,7 +70,7 @@ export const GET = withAdmin(
         WHERE ci.page_id IN (${sql.join(pageIds, sql`, `)})
         ORDER BY ci.id
         LIMIT ${limit}
-      `)) as unknown as [Record<string, unknown>[], unknown];
+      `);
 
 			for (const r of rows) {
 				const parsed = parseItemIds(String(r.itemIds ?? ""));
@@ -96,7 +96,7 @@ export const GET = withAdmin(
 
 		// 2) Recently imported furniture. Bounded candidate list first, matched
 		//    against the import tree in JS — never a correlated FIND_IN_SET scan.
-		const [candidateRows] = (await db.execute(sql`
+		const candidateRows = await queryRows<{ itemId: number }>(sql`
       SELECT DISTINCT alog.target_id AS itemId
       FROM admin_audit_log alog
       WHERE alog.action = 'furni_import'
@@ -105,7 +105,7 @@ export const GET = withAdmin(
         AND alog.created_at >= ${since}
       ORDER BY itemId DESC
       LIMIT 2000
-    `)) as unknown as [Array<{ itemId: number }>, unknown];
+    `);
 
 		for (const r of candidateRows) {
 			const itemId = Number(r.itemId);