bitburner-src/src/PersonObjects/Player/PlayerObjectGangMethods.ts

import type { PlayerObject } from "./PlayerObject";
import type { FactionName } from "@enums";
import type { Faction } from "../../Faction/Faction";

import { Factions } from "../../Faction/Factions";
import { Gang } from "../../Gang/Gang";
import { GangConstants } from "../../Gang/data/Constants";
import { isFactionWork } from "../../Work/FactionWork";
import { canAccessBitNodeFeature } from "../../BitNode/BitNodeUtils";
import type { Result } from "@nsdefs";

export function canAccessGang(this: PlayerObject): Result {
  if (this.bitNodeOptions.disableGang) {
    return { success: false, message: "Gang is disabled by advanced options." };
  }
  if (this.bitNodeN === 2) {
    return { success: true };
  }
  if (this.activeSourceFileLvl(2) === 0) {
    return { success: false, message: "You do not have Source-File 2." };
  }
  if (this.karma > GangConstants.GangKarmaRequirement) {
    return {
      success: false,
      message: `Your karma must be less than or equal to ${GangConstants.GangKarmaRequirement}.`,
    };
  }

  return { success: true };
}

export function isAwareOfGang(this: PlayerObject): boolean {
  return canAccessBitNodeFeature(2) && !this.bitNodeOptions.disableGang;
}

export function getGangFaction(this: PlayerObject): Faction {
  const gang = this.gang;
  if (gang === null) throw new Error("Cannot get gang faction because player is not in a gang.");

  const fac = Factions[gang.facName];
  if (fac == null) throw new Error(`Gang has invalid faction name: ${gang.facName}`);

  return fac;
}

export function getGangName(this: PlayerObject): FactionName | null {
  const gang = this.gang;
  return gang ? gang.facName : null;
}

export function hasGangWith(this: PlayerObject, facName: FactionName): boolean {
  const gang = this.gang;
  return gang ? gang.facName === facName : false;
}

export function startGang(this: PlayerObject, factionName: FactionName, hacking: boolean): void {
  if (isFactionWork(this.currentWork) && this.currentWork.factionName === factionName) {
    this.finishWork(true);
  }

  this.gang = new Gang(factionName, hacking);

  const fac = Factions[factionName];
  if (fac == null) {
    throw new Error(`Invalid faction name when creating gang: ${factionName}`);
  }
  fac.playerReputation = 0;
}

export function inGang(this: PlayerObject) {
  return Boolean(this.gang);
}