API: Make condition of donateToFaction consistent (#1686)

markdown/bitburner.singularity.donatetofaction.md

@@ -31,3 +31,7 @@ RAM cost: 5 GB \* 16/4/1
 
 Attempts to donate money to the specified faction in exchange for reputation. Returns true if you successfully donate the money, and false otherwise.
 
+You cannot donate to your gang's faction.
+
+The specified faction must offer at least 1 type of work. You can use [getFactionWorkTypes](./bitburner.singularity.getfactionworktypes.md) to get the list of work types of a faction.
+

src/Faction/FactionInfo.tsx

@@ -697,6 +697,9 @@ export const FactionInfos: Record<FactionName, FactionInfo> = {
     rumorText: <>The {CompanyName.NSA} would like to have a word with you once you're ready.</>,
     inviteReqs: [haveSomeSourceFile(6, 7), haveBladeburnerRank(BladeburnerConstants.RankNeededForFaction)],
     rumorReqs: [haveSomeSourceFile(6, 7), notCondition(inBitNode(8))],
+    offerHackingWork: false,
+    offerFieldWork: false,
+    offerSecurityWork: false,
     special: true,
     assignment: (): React.ReactElement => {
       return (
@@ -790,6 +793,9 @@ export const FactionInfos: Record<FactionName, FactionInfo> = {
         },
       },
     ],
+    offerHackingWork: false,
+    offerFieldWork: false,
+    offerSecurityWork: false,
     special: true,
     keepOnInstall: true,
     assignment: (): React.ReactElement => {

src/NetscriptFunctions/Singularity.ts

@@ -1,15 +1,7 @@
 import type { Singularity as ISingularity, Task as ITask } from "@nsdefs";
 
 import { Player } from "@player";
-import {
-  AugmentationName,
-  CityName,
-  FactionName,
-  FactionWorkType,
-  GymType,
-  LocationName,
-  UniversityClassType,
-} from "@enums";
+import { AugmentationName, CityName, FactionWorkType, GymType, LocationName, UniversityClassType } from "@enums";
 import { purchaseAugmentation, joinFaction, getFactionAugmentationsFiltered } from "../Faction/FactionHelpers";
 import { startWorkerScript } from "../NetscriptWorker";
 import { Augmentations } from "../Augmentation/Augmentations";
@@ -967,12 +959,8 @@ export function NetscriptSingularity(): InternalAPI<ISingularity> {
         helpers.log(ctx, () => `You can't donate to '${facName}' because you are managing a gang for it`);
         return false;
       }
-      if (
-        faction.name === FactionName.ChurchOfTheMachineGod ||
-        faction.name === FactionName.Bladeburners ||
-        faction.name === FactionName.ShadowsOfAnarchy
-      ) {
-        helpers.log(ctx, () => `You can't donate to '${facName}' because they do not accept donations`);
+      if (!faction.getInfo().offersWork()) {
+        helpers.log(ctx, () => `You can't donate to '${facName}' because this faction does not offer any type of work`);
         return false;
       }
       if (typeof amt !== "number" || amt <= 0 || isNaN(amt)) {

src/ScriptEditor/NetscriptDefinitions.d.ts

@@ -2294,6 +2294,10 @@ export interface Singularity {
    * Attempts to donate money to the specified faction in exchange for reputation.
    * Returns true if you successfully donate the money, and false otherwise.
    *
+   * You cannot donate to your gang's faction.
+   *
+   * The specified faction must offer at least 1 type of work. You can use {@link Singularity.getFactionWorkTypes | getFactionWorkTypes} to get the list of work types of a faction.
+   *
    * @param faction - Name of faction to donate to.
    * @param amount - Amount of money to donate.
    * @returns True if the money was donated, and false otherwise.