style(lib): format shared libraries and remove unused imports

src/lib/attendance/index.ts

@@ -57,9 +57,10 @@ export async function setMissionAttendance(
 
   const mission = (await payload
     .findByID({ collection: "missions", id: missionId, depth: 0, overrideAccess: true })
-    .catch(() => null)) as unknown as
+    .catch(() => null)) as unknown as {
-    | { name?: string; classification: { startDateTime: string } }
+    name?: string;
-    | null;
+    classification: { startDateTime: string };
+  } | null;
   if (!mission) throw new Error("Mission not found.");
 
   if (isMissionPast(mission.classification.startDateTime)) {

src/lib/banking/index.ts

@@ -1,4 +1,3 @@
-import type { Payload } from "payload";
 import type { BankAccount, BankTransaction } from "@/payload-types";
 
 export type BankAccountType = "treasury" | "faction" | "personal";
@@ -93,7 +92,10 @@ export async function createAccount(
   })) as unknown as BankAccount;
 }
 
-export async function ensurePersonalAccount(payload: PayloadType, userId: number): Promise<BankAccount> {
+export async function ensurePersonalAccount(
+  payload: PayloadType,
+  userId: number,
+): Promise<BankAccount> {
   const existing = (await payload.find({
     collection: "bank-accounts",
     where: {
@@ -105,12 +107,14 @@ export async function ensurePersonalAccount(payload: PayloadType, userId: number
   })) as unknown as { docs: BankAccount[] };
   if (existing.docs.length > 0) return existing.docs[0];
 
-  const user = (await payload.findByID({
+  const user = (await payload
-    collection: "users",
+    .findByID({
-    id: userId,
+      collection: "users",
-    depth: 0,
+      id: userId,
-    overrideAccess: true,
+      depth: 0,
-  }).catch(() => null)) as unknown as { username?: string; displayName?: string } | null;
+      overrideAccess: true,
+    })
+    .catch(() => null)) as unknown as { username?: string; displayName?: string } | null;
   const label = user?.displayName || user?.username || `User ${userId}`;
 
   return createAccount(payload, {

src/lib/locker/index.ts

@@ -1,4 +1,3 @@
-import type { Payload } from "payload";
 import type { Asset, LockerStorage } from "@/payload-types";
 import type { GridDimensions } from "@/lib/logistics";
 

src/lib/locker/search.ts

@@ -1,10 +1,10 @@
 import type { Asset, Loadout } from "@/payload-types";
 import {
-  WARDROBE_SLOT_LAYOUT,
   getAssetTypeLabel,
   getLoadoutSlot,
   type LoadoutSlots,
   type LockerGridItem,
+  WARDROBE_SLOT_LAYOUT,
 } from "@/lib/locker";
 
 export type LockerSearchLocationKind = "locker" | "attached" | "skin" | "loadout";
@@ -77,11 +77,14 @@ export function buildAssetStats(asset: Asset): LockerSearchStat[] {
   if (mag?.ammoType) stats.push({ label: "Ammo", value: mag.ammoType });
 
   const container = asset["Container Configuration"];
-  if (container?.capacityKg != null) stats.push({ label: "Capacity", value: `${container.capacityKg}kg` });
+  if (container?.capacityKg != null)
-  if (container?.weightKg != null) stats.push({ label: "Weight", value: `${container.weightKg}kg` });
+    stats.push({ label: "Capacity", value: `${container.capacityKg}kg` });
+  if (container?.weightKg != null)
+    stats.push({ label: "Weight", value: `${container.weightKg}kg` });
 
   const nvg = asset["Nightvision Configuration"];
-  if (nvg?.nvgGeneration) stats.push({ label: "Gen", value: NVG_GEN_LABELS[nvg.nvgGeneration] ?? nvg.nvgGeneration });
+  if (nvg?.nvgGeneration)
+    stats.push({ label: "Gen", value: NVG_GEN_LABELS[nvg.nvgGeneration] ?? nvg.nvgGeneration });
   if (nvg?.nvgHasThermals) stats.push({ label: "Thermals", value: "Yes" });
 
   const skin = asset["Skin Configuration"];
@@ -93,7 +96,8 @@ export function buildAssetStats(asset: Asset): LockerSearchStat[] {
   }
 
   const market = asset.marketTrading;
-  if (market?.Rarity) stats.push({ label: "Rarity", value: RARITY_LABELS[market.Rarity] ?? market.Rarity });
+  if (market?.Rarity)
+    stats.push({ label: "Rarity", value: RARITY_LABELS[market.Rarity] ?? market.Rarity });
 
   const dims = asset.storageDimensions;
   if (dims?.gridWidth != null && dims?.gridHeight != null) {

src/lib/market/chatBubbles.ts

@@ -70,7 +70,10 @@ export function buildChatBubbles(
     const fallbackRng = negotiation ? seededRng(negotiation.id) : Math.random;
 
     if (negotiation?.status === "accepted" && !hasDialogue) {
-      bubbles.push({ from: "seller", text: npcDialogue("accept", undefined, undefined, fallbackRng) });
+      bubbles.push({
+        from: "seller",
+        text: npcDialogue("accept", undefined, undefined, fallbackRng),
+      });
     } else if (negotiation?.status === "closed" && !hasDialogue) {
       bubbles.push({
         from: "seller",

src/lib/market/index.ts

@@ -1,4 +1,3 @@
-import type { Payload } from "payload";
 import type { Asset, LockerStorage, MarketListing, User } from "@/payload-types";
 import {
   ensureLockerStorage,
@@ -10,11 +9,7 @@ import {
   resolveAssetId,
   toLockerGridItems,
 } from "@/lib/locker";
-import {
+import { applyTransaction, ensurePersonalAccount, getMainCurrencyId } from "@/lib/banking";
-  applyTransaction,
-  ensurePersonalAccount,
-  getMainCurrencyId,
-} from "@/lib/banking";
 
 type PayloadType = Awaited<ReturnType<typeof import("payload").getPayload>>;
 
@@ -65,14 +60,18 @@ export interface NegotiationRange {
 }
 
 /** Resolve a listing's negotiation range. Non-negotiable listings have min === desired. */
-export function negotiationRange(listing: Pick<MarketListing, "price" | "desiredPrice" | "minPrice">): NegotiationRange {
+export function negotiationRange(
+  listing: Pick<MarketListing, "price" | "desiredPrice" | "minPrice">,
+): NegotiationRange {
   const desired = listing.desiredPrice ?? listing.price ?? 0;
   const min = listing.minPrice ?? desired;
   return { min, desired };
 }
 
 /** A listing is negotiable when the seller has set a floor below the asking price. */
-export function isNegotiable(listing: Pick<MarketListing, "price" | "desiredPrice" | "minPrice">): boolean {
+export function isNegotiable(
+  listing: Pick<MarketListing, "price" | "desiredPrice" | "minPrice">,
+): boolean {
   const { min, desired } = negotiationRange(listing);
   return min < desired;
 }
@@ -179,7 +178,13 @@ export async function creditLockerQuantity(
 
   while (remaining > 0) {
     const stackAmount = Math.min(remaining, maxStack === Infinity ? remaining : maxStack);
-    const spot = findLockerEmptySpot(gridItems, footprint.width, footprint.height, grid.width, grid.height);
+    const spot = findLockerEmptySpot(
+      gridItems,
+      footprint.width,
+      footprint.height,
+      grid.width,
+      grid.height,
+    );
     if (!spot) {
       throw new Error(
         `No space in buyer's locker for ${asset.name}. Needs ${footprint.width}×${footprint.height} free cells.`,
@@ -266,7 +271,9 @@ export async function buyListing(
   }
 
   const sellerId =
-    typeof listing.seller === "object" && listing.seller ? listing.seller.id : (listing.seller as number | null);
+    typeof listing.seller === "object" && listing.seller
+      ? listing.seller.id
+      : (listing.seller as number | null);
   if (sellerId != null && sellerId === buyer.id) {
     throw new Error("You cannot buy your own listing.");
   }
@@ -343,10 +350,17 @@ export async function expireListing(
   listing: MarketListing,
 ): Promise<MarketListing> {
   const sellerId =
-    typeof listing.seller === "object" && listing.seller ? listing.seller.id : (listing.seller as number | null);
+    typeof listing.seller === "object" && listing.seller
+      ? listing.seller.id
+      : (listing.seller as number | null);
 
   if (sellerId != null && !listing.isAutoGenerated) {
-    await creditLockerQuantity(payload, sellerId, resolveAssetId(listing.asset) as number, listing.quantity);
+    await creditLockerQuantity(
+      payload,
+      sellerId,
+      resolveAssetId(listing.asset) as number,
+      listing.quantity,
+    );
   }
 
   return (await payload.update({

src/lib/market/negotiations.ts

@@ -98,7 +98,8 @@ export function npcResponseToOffer(
     amount > lastBuyerOffer &&
     amount - lastBuyerOffer < desired * NPC_PATIENCE.stallRatio;
 
-  if (amount >= stance) return { action: "accept", amount: Math.min(amount, desired), reason: good(amount) };
+  if (amount >= stance)
+    return { action: "accept", amount: Math.min(amount, desired), reason: good(amount) };
   if (amount >= stance - margin) {
     if (rng() < NPC_ACCEPT.chance) {
       return { action: "accept", amount: Math.min(amount, desired), reason: good(amount) };
@@ -136,7 +137,11 @@ function advancePatience(
   previous: number | null,
 ): number {
   let delta: number;
-  if (previous != null && amount > previous && amount - previous < desired * NPC_PATIENCE.stallRatio) {
+  if (
+    previous != null &&
+    amount > previous &&
+    amount - previous < desired * NPC_PATIENCE.stallRatio
+  ) {
     delta = NPC_PATIENCE.roundCost + NPC_PATIENCE.stallPenalty;
   } else if (amount < min) {
     delta = NPC_PATIENCE.roundCost + NPC_PATIENCE.lowballPenalty;

src/lib/market/npcs.ts

@@ -168,17 +168,11 @@ export async function createGeneratedNpc(
 }
 
 /** All enabled vendor NPCs that sell the given asset. */
-export async function findVendorNpcs(
+export async function findVendorNpcs(payload: PayloadType, assetId: number): Promise<GameNpc[]> {
-  payload: PayloadType,
-  assetId: number,
-): Promise<GameNpc[]> {
   const result = await payload.find({
     collection: "game-npcs",
     where: {
-      and: [
+      and: [{ "vendor.enabled": { equals: true } }, { "vendor.sells": { equals: assetId } }],
-        { "vendor.enabled": { equals: true } },
-        { "vendor.sells": { equals: assetId } },
-      ],
     },
     limit: 100,
     depth: 0,
@@ -193,10 +187,7 @@ export async function findVendorNpcs(
  * 2. Otherwise reuse any existing vendor NPC selling the asset.
  * 3. If none exist, generate a new placeholder NPC for the asset.
  */
-export async function resolveVendorNpc(
+export async function resolveVendorNpc(payload: PayloadType, assetId: number): Promise<GameNpc> {
-  payload: PayloadType,
-  assetId: number,
-): Promise<GameNpc> {
   const vendors = await findVendorNpcs(payload, assetId);
   if (vendors.length > 0) {
     const inGame = vendors.filter((npc) => npc.isInGame === true);

src/lib/storageRules.ts

@@ -10,10 +10,7 @@ export type StorageRulesSource = Pick<
   "allowedStorage" | "prohibitedStorage" | "restrictToAllowed"
 >;
 
-export type StorageRuleViolation =
+export type StorageRuleViolation = "prohibited" | "not_whitelisted" | "over_cap";
-  | "prohibited"
-  | "not_whitelisted"
-  | "over_cap";
 
 export interface StorageRuleCheck {
   allowed: boolean;
@@ -35,10 +32,7 @@ function resolveResourceId(value: number | { id: number }): number {
 /**
  * Whether this resource is on the structure's prohibited list.
  */
-export function isResourceProhibited(
+export function isResourceProhibited(rules: StorageRulesSource, resourceId: number): boolean {
-  rules: StorageRulesSource,
-  resourceId: number,
-): boolean {
   return (rules.prohibitedStorage ?? []).some((rule) => {
     if (!isResourceRef(rule.item)) return false;
     return resolveResourceId(rule.item.value) === resourceId;
@@ -50,10 +44,7 @@ export function isResourceProhibited(
  * enabled, only resources listed in `allowedStorage` pass. Otherwise everything
  * passes (prohibited list still applies separately).
  */
-export function isResourceWhitelisted(
+export function isResourceWhitelisted(rules: StorageRulesSource, resourceId: number): boolean {
-  rules: StorageRulesSource,
-  resourceId: number,
-): boolean {
   if (!rules.restrictToAllowed) return true;
   return (rules.allowedStorage ?? []).some((rule) => {
     if (!isResourceRef(rule.item)) return false;
@@ -106,20 +97,14 @@ export function checkStorageDeposit(
 /**
  * Human-readable message describing why a deposit/transfer was rejected.
  */
-export function storageViolationMessage(
+export function storageViolationMessage(resourceName: string, check: StorageRuleCheck): string {
-  resourceName: string,
-  check: StorageRuleCheck,
-): string {
   switch (check.violation) {
     case "prohibited":
       return `This resource is prohibited from storage at this structure.`;
     case "not_whitelisted":
       return `This structure only accepts items on its allowed storage list — "${resourceName}" is not permitted.`;
     case "over_cap": {
-      const available = Math.max(
+      const available = Math.max(0, (check.cap ?? 0) - (check.currentStored ?? 0));
-        0,
-        (check.cap ?? 0) - (check.currentStored ?? 0),
-      );
       return available <= 0
         ? `${resourceName} is at its storage allowance here (${check.cap?.toLocaleString()}). No more can be stored.`
         : `${resourceName} is limited to ${check.cap?.toLocaleString()} units here — you can add at most ${available.toLocaleString()} more.`;

src/utils/access-control/hasRoles.ts

@@ -1,6 +1,6 @@
 import { User } from "@/payload-types";
 
-export default function hasRoles(roles: NonNullable<User['roles']>, user: User | null | undefined) {
+export default function hasRoles(roles: NonNullable<User["roles"]>, user: User | null | undefined) {
   if (!user) return false;
 
   return roles.some((role) => user.roles?.some((urole) => urole === role || urole === "developer"));

src/utils/event-log/emit.ts

@@ -5,7 +5,29 @@ interface GameEventInput {
   message: string;
   actor?: number;
   structure?: number;
-  targetCollection?: "users" | "missions" | "maps" | "campaigns" | "factions" | "technologies" | "assets" | "resources" | "structures" | "vehicles" | "game-structures" | "game-vehicles" | "game-npcs" | "shipments" | "bank-accounts" | "bank-transactions" | "ledger-entries" | "locker-storages" | "loadouts" | "market-listings" | "market-negotiations" | "tickets";
+  targetCollection?:
+    | "users"
+    | "missions"
+    | "maps"
+    | "campaigns"
+    | "factions"
+    | "technologies"
+    | "assets"
+    | "resources"
+    | "structures"
+    | "vehicles"
+    | "game-structures"
+    | "game-vehicles"
+    | "game-npcs"
+    | "shipments"
+    | "bank-accounts"
+    | "bank-transactions"
+    | "ledger-entries"
+    | "locker-storages"
+    | "loadouts"
+    | "market-listings"
+    | "market-negotiations"
+    | "tickets";
   targetId?: number;
   data?: Record<string, unknown>;
 }