tornapi-typescript 0.0.6 → 0.1.1

package/dist/index.d.ts

@@ -9,6 +9,52 @@
 
 export type RaceClassEnum = "A" | "B" | "C" | "D" | "E";
 
+export type FactionStatEnum =
+    | "medicalitemsused"
+    | "criminaloffences"
+    | "organisedcrimerespect"
+    | "organisedcrimemoney"
+    | "organisedcrimesuccess"
+    | "organisedcrimefail"
+    | "attackswon"
+    | "attackslost"
+    | "attackschain"
+    | "attacksleave"
+    | "attacksmug"
+    | "attackshosp"
+    | "bestchain"
+    | "busts"
+    | "revives"
+    | "jails"
+    | "hosps"
+    | "medicalitemrecovery"
+    | "medicalcooldownused"
+    | "gymtrains"
+    | "gymstrength"
+    | "gymspeed"
+    | "gymdefense"
+    | "gymdexterity"
+    | "candyused"
+    | "alcoholused"
+    | "energydrinkused"
+    | "drugsused"
+    | "drugoverdoses"
+    | "rehabs"
+    | "caymaninterest"
+    | "traveltimes"
+    | "traveltime"
+    | "hunting"
+    | "attacksdamagehits"
+    | "attacksdamage"
+    | "hosptimegiven"
+    | "hosptimereceived"
+    | "attacksdamaging"
+    | "attacksrunaway"
+    | "highestterritories"
+    | "territoryrespect";
+
+export type FactionBranchStateEnum = "war" | "peace";
+
 export type FactionOrganizedCrimePayoutType =
     | "balance"
     | "wallet"
@@ -310,13 +356,6 @@ export type ItemUid = number;
 
 export type UserId = number;
 
-export type UserIdNullable = number | null;
-
-export type UserIdNullableDeprecated =
-    /** This field is replaced with the 'user.id' and will be removed on the 1st of May 2025. */
-    | number /** This field is replaced with the 'user.id' and will be removed on the 1st of May 2025. */
-    | null;
-
 export type ReviveId = number;
 
 export type LogId = number;
@@ -325,7 +364,7 @@ export type LogCategoryId = number;
 
 export type FactionId = number;
 
-export type FactionIdNullable = number | null;
+export type FactionBranchId = number;
 
 export type FactionCrimeId = number;
 
@@ -342,10 +381,8 @@ export type ForumThreadId = number;
 export type ForumPostId = number;
 
 export interface RequestLinks {
-    next: /** Auto-generated link to get the next set of records. */
-    string /** Auto-generated link to get the next set of records. */ | null;
-    prev: /** Auto-generated link to get the prev set of records. */
-    string /** Auto-generated link to get the prev set of records. */ | null;
+    next: string | null;
+    prev: string | null;
 }
 
 export interface RequestMetadata {
@@ -520,7 +557,7 @@ export interface AttackPlayer {
 
 export interface AttackPlayerSimplified {
     id: UserId;
-    faction_id: FactionId & (number | null);
+    faction_id: FactionId | null;
 }
 
 export interface AttackingFinishingHitEffects {
@@ -577,11 +614,11 @@ export interface ReviveSimplified {
     id: ReviveId;
     reviver: {
         id: UserId;
-        faction_id: FactionId & (number | null);
+        faction_id: FactionId | null;
     };
     target: {
         id: UserId;
-        faction_id: FactionId & (number | null);
+        faction_id: FactionId | null;
         hospital_reason: string;
         early_discharge: boolean;
         last_action: number;
@@ -633,6 +670,56 @@ export interface TimestampResponse {
     timestamp: number;
 }
 
+export interface FactionUpgradeDetails {
+    id: FactionBranchId;
+    name: string;
+    ability: string;
+    level: number;
+    cost: number;
+    unlocked_at?: number;
+}
+
+export interface FactionBranchDetails {
+    name: string;
+    order: number;
+    /** Respect cost multiplier. */
+    multiplier: number;
+    upgrades: FactionUpgradeDetails[];
+}
+
+export interface FactionUpgrades {
+    core: {
+        upgrades?: FactionUpgradeDetails[];
+    };
+    peace: FactionBranchDetails[];
+    war: FactionBranchDetails[];
+}
+
+export interface FactionUpgradesResponse {
+    upgrades: FactionUpgrades;
+    state: FactionBranchStateEnum;
+}
+
+export interface FactionStat {
+    name: FactionStatEnum;
+    value: number;
+}
+
+export interface FactionStatsResponse {
+    stats: FactionStat[];
+}
+
+export interface FactionContributor {
+    id: UserId;
+    username: string;
+    value: number;
+    in_faction: boolean;
+}
+
+export interface FactionContributorsResponse {
+    contributors: FactionContributor[];
+}
+
 export interface FactionHofStats {
     rank: HofValueString;
     respect: HofValue;
@@ -659,7 +746,7 @@ export interface FactionMember {
     has_early_discharge: boolean;
     last_action: UserLastAction;
     status: UserStatus;
-    life: UserLife;
+    life?: UserLife;
     revive_setting: ReviveSetting;
 }
 
@@ -672,8 +759,8 @@ export interface UserLastAction {
 
 /** Unfortunately, current life value is often shown incorrectly, and the calculation for each member is very resource heavy, so this field is deprecated and will be removed on 1st of May, 2025. */
 export interface UserLife {
-    current: number;
-    maximum: number;
+    current?: number;
+    maximum?: number;
 }
 
 /** Details about a user's status. */
@@ -707,9 +794,7 @@ export interface FactionBasic {
     days_old: number;
     capacity: number;
     members: number;
-    is_enlisted: /** Indicates if the faction is enlisted for ranked wars. Available only with faction AA permissions for your own faction. */
-    | boolean /** Indicates if the faction is enlisted for ranked wars. Available only with faction AA permissions for your own faction. */
-        | null;
+    is_enlisted: boolean | null;
     rank: FactionRank;
     best_chain: number;
 }
@@ -778,7 +863,7 @@ export interface FactionTerritoryWar {
     end: number | null;
     /** The score target of the war. */
     target: number;
-    winner: number | null;
+    winner?: FactionId | null;
     /** The factions involved in the territory war. */
     factions: FactionTerritoryWarParticipant[];
 }
@@ -929,7 +1014,7 @@ export interface FactionChainReportAttackerAttacks {
     retaliations: number;
     overseas: number;
     draws: number;
-    escapes: number;
+    escapes?: number;
     losses: number;
     war: number;
     bonuses: number;
@@ -937,7 +1022,7 @@ export interface FactionChainReportAttackerAttacks {
 
 export interface FactionCrimeUser {
     id: UserId;
-    outcome: FactionCrimeUserOutcome;
+    outcome: FactionCrimeUserOutcome | null;
     /** The timestamp at which the user joined the slot. */
     joined_at: number;
     /** Current planning progress on the slot. */
@@ -974,12 +1059,12 @@ export interface FactionCrimeSlot {
         /** Shows if user has the required item. */
         is_available: boolean;
     } | null;
-    user_id: UserIdNullableDeprecated;
+    user_id?: UserId | null;
     user: FactionCrimeUser | null;
     /** This field is replaced with 'checkpoint_pass_rate' field and will be removed on 1st of May 2025. */
-    success_chance: number;
+    success_chance?: number;
     /** This field is replaced with 'checkpoint_pass_rate' field and will be removed on 1st of May 2025. */
-    crime_pass_rate: number;
+    crime_pass_rate?: number;
     /** Returns CPR for the player who joined the slot. If the slot is empty (availalbe), it shows your CPR for that slot. This value is 0 for expired crimes. */
     checkpoint_pass_rate: number;
 }
@@ -991,16 +1076,11 @@ export interface FactionCrime {
     status: FactionCrimeStatusEnum;
     /** The timestamp at which the crime was created. */
     created_at: number;
-    planning_at: /** The timestamp at which the planning phase for the crime has begun. */
-    | number /** The timestamp at which the planning phase for the crime has begun. */
-        | null;
-    ready_at: /** The timestamp at which the crime will be ready. */
-    number /** The timestamp at which the crime will be ready. */ | null;
+    planning_at: number | null;
+    ready_at: number | null;
     /** The timestamp at which the crime will expire. */
     expired_at: number;
-    executed_at: /** The timestamp at which the crime was executed. <br> Note: this value is null for all crimes executed before January 15th, 2025. */
-    | number /** The timestamp at which the crime was executed. <br> Note: this value is null for all crimes executed before January 15th, 2025. */
-        | null;
+    executed_at: number | null;
     slots: FactionCrimeSlot[];
     rewards: FactionCrimeReward | null;
 }
@@ -1014,15 +1094,35 @@ export interface FactionCrimeResponse {
     crime: FactionCrime;
 }
 
-/** The following selections will fallback to API v1 and may change at any time: 'armor', 'boosters', 'caches', 'cesium', 'contributors', 'crimeexp', 'currency', 'donations', 'drugs', 'medical', 'positions', 'reports', 'stats', 'temporary', 'upgrades', 'weapons'. */
+export interface FactionBalance {
+    faction: {
+        money: number;
+        points: number;
+        scope: number;
+    };
+    members: {
+        id: UserId;
+        username: string;
+        money: number;
+        points: number;
+    }[];
+}
+
+export interface FactionBalanceResponse {
+    balance: FactionBalance;
+}
+
+/** The following selections will fallback to API v1 and may change at any time: 'armor', 'boosters', 'caches', 'cesium', 'crimeexp', 'drugs', 'medical', 'positions', 'reports', 'temporary', 'weapons'. */
 export type FactionSelectionName =
     | "applications"
     | "attacks"
     | "attacksfull"
+    | "balance"
     | "basic"
     | "chain"
     | "chainreport"
     | "chains"
+    | "contributors"
     | "crime"
     | "crimes"
     | "hof"
@@ -1033,24 +1133,21 @@ export type FactionSelectionName =
     | "rankedwarreport"
     | "revives"
     | "revivesfull"
+    | "stats"
     | "timestamp"
+    | "upgrades"
     | "wars"
     | "armor"
     | "boosters"
     | "caches"
     | "cesium"
-    | "contributors"
     | "crimeexp"
-    | "currency"
-    | "donations"
     | "drugs"
     | "medical"
     | "positions"
     | "reports"
-    | "stats"
     | "temporary"
     | "territory"
-    | "upgrades"
     | "weapons";
 
 export interface FactionLookupResponse {
@@ -1064,12 +1161,12 @@ export interface FactionRankedWarDetails {
     /** Timestamp the war ended at. */
     end: number;
     target: number;
-    winner: FactionId & (number | null);
+    winner: FactionId | null;
     factions: {
-        id?: FactionId;
-        name?: string;
-        score?: number;
-        chain?: number;
+        id: FactionId;
+        name: string;
+        score: number;
+        chain: number;
     }[];
 }
 
@@ -1088,29 +1185,29 @@ export interface FactionRankedWarReportResponse {
         winner: FactionId;
         forfeit: boolean;
         factions: {
-            id?: FactionId;
-            name?: string;
-            score?: number;
-            attacks?: number;
-            rank?: {
-                before?: string;
-                after?: string;
+            id: FactionId;
+            name: string;
+            score: number;
+            attacks: number;
+            rank: {
+                before: string;
+                after: string;
             };
-            rewards?: {
-                respect?: number;
-                points?: number;
-                items?: {
-                    id?: ItemId;
-                    name?: string;
-                    quantity?: number;
+            rewards: {
+                respect: number;
+                points: number;
+                items: {
+                    id: ItemId;
+                    name: string;
+                    quantity: number;
                 }[];
             };
-            members?: {
-                id?: UserId;
-                name?: string;
-                level?: number;
-                attacks?: number;
-                score?: number;
+            members: {
+                id: UserId;
+                name: string;
+                level: number;
+                attacks: number;
+                score: number;
             }[];
         }[];
     };
@@ -1118,10 +1215,10 @@ export interface FactionRankedWarReportResponse {
 
 export interface ForumCategoriesResponse {
     categories: {
-        id?: ForumId;
-        title?: string;
-        acronym?: string;
-        threads?: number;
+        id: ForumId;
+        title: string;
+        acronym: string;
+        threads: number;
     }[];
 }
 
@@ -1151,7 +1248,7 @@ export interface ForumThreadBase {
     /** Total number of times players have opened this thread. */
     views: number;
     author: ForumThreadAuthor;
-    last_poster: ForumThreadAuthor;
+    last_poster: ForumThreadAuthor | null;
     first_post_time: number;
     last_post_time: number | null;
     has_poll: boolean;
@@ -1160,9 +1257,9 @@ export interface ForumThreadBase {
 }
 
 export interface ForumThreadExtended extends ForumThreadBase {
-    content?: string;
-    content_raw?: string;
-    poll?: ForumPoll;
+    content: string;
+    content_raw: string;
+    poll: ForumPoll | null;
 }
 
 export interface ForumPost {
@@ -1175,10 +1272,9 @@ export interface ForumPost {
     is_edited: boolean;
     is_pinned: boolean;
     created_time: number;
-    edited_by: UserId;
+    edited_by: UserId | null;
     has_quote: boolean;
-    quoted_post_id: /** 'quoted_post_id' is null when 'has_quote' is false. */
-    number /** 'quoted_post_id' is null when 'has_quote' is false. */ | null;
+    quoted_post_id: number | null;
     /** depending on the input 'cat' parameter, this will either return raw value (with HTML) or plain text. Legacy posts are returned as is, they can't be stripped of tags. */
     content: string;
     likes: number;
@@ -1186,9 +1282,7 @@ export interface ForumPost {
 }
 
 export interface ForumThreadUserExtended extends ForumThreadBase {
-    new_posts?: /** Available only when requesting data for yourself (no id or your id) with at least 'Minimal' access type key. */
-    | number /** Available only when requesting data for yourself (no id or your id) with at least 'Minimal' access type key. */
-        | null;
+    new_posts: number | null;
 }
 
 export interface ForumSubscribedThreadPostsCount {
@@ -1268,7 +1362,7 @@ export interface ItemMarketListingStackable {
 }
 
 export interface ItemMarketListingItemDetails {
-    uid: number;
+    uid: ItemUid;
     stats: ItemMarketListingItemStats;
     bonuses: ItemMarketListingItemBonus[];
     rarity: ("yellow" | "orange" | "red") | null;
@@ -1277,7 +1371,8 @@ export interface ItemMarketListingItemDetails {
 export interface ItemMarketListingNonstackable {
     price: number;
     amount: number;
-    itemDetails: ItemMarketListingItemDetails;
+    itemDetails?: ItemMarketListingItemDetails;
+    item_details: ItemMarketListingItemDetails;
 }
 
 export interface ItemMarket {
@@ -1378,9 +1473,9 @@ export interface Race {
         end: number | null;
     };
     requirements: {
-        car_class: RaceClassEnum;
-        driver_class: RaceClassEnum;
-        car_item_id: ItemId;
+        car_class: RaceClassEnum | null;
+        driver_class: RaceClassEnum | null;
+        car_item_id: ItemId | null;
         requires_stock_car: boolean;
         requires_password: boolean;
         join_fee: number;
@@ -1413,7 +1508,7 @@ export interface RacerDetails {
 }
 
 export interface RacingRaceDetailsResponse extends Race {
-    results?: RacerDetails[];
+    results: RacerDetails[];
 }
 
 export type RacingSelectionName =
@@ -1448,7 +1543,7 @@ export interface TornCrime {
     id: number;
     name: string;
     category_id: number;
-    category_name: string;
+    category_name?: string;
     enhancer_id: number;
     enhancer_name: string;
     unique_outcomes_count: number;
@@ -1491,14 +1586,9 @@ export interface TornHofResponse {
 }
 
 export interface FactionHofValues {
-    chain: /** Maximum chain achieved by the faction. Null if chosen category is 'rank' or 'respect'. */
-    | number /** Maximum chain achieved by the faction. Null if chosen category is 'rank' or 'respect'. */
-        | null;
-    chain_duration: /** The duration of the chain. Null if chosen category is 'rank' or 'respect'. */
-    | number /** The duration of the chain. Null if chosen category is 'rank' or 'respect'. */
-        | null;
-    respect: /** Null if chosen category is 'chain'. */
-    number /** Null if chosen category is 'chain'. */ | null;
+    chain: number | null;
+    chain_duration: number | null;
+    respect: number | null;
 }
 
 export interface TornFactionHof {
@@ -1538,9 +1628,8 @@ export interface Bounty {
     target_id: UserId;
     target_name: string;
     target_level: number;
-    lister_id: UserId & (number | null);
-    lister_name: /** If the bounty is anonymous this field is null. */
-    string /** If the bounty is anonymous this field is null. */ | null;
+    lister_id: UserId | null;
+    lister_name: string | null;
     reward: number;
     reason: string | null;
     quantity: number;
@@ -1549,14 +1638,9 @@ export interface Bounty {
 }
 
 export interface AttackLogSummary {
-    id: UserId /** Id of the participant, could be null in stealthed attacks. */ &
-        (
-            | number /** Id of the participant, could be null in stealthed attacks. */
-            | null
-        );
+    id: UserId | null;
     name: /** Name of the participant, could be null in stealthed attacks. */
-    | string /** Name of the participant, could be null in stealthed attacks. */
-        | null;
+    string | null;
     hits: number;
     misses: number;
     damage: number;
@@ -1568,23 +1652,20 @@ export interface AttackLog {
     action: AttackActionEnum;
     icon: string;
     attacker: /** This value could be null in stealthed attacks. */
-    | {
-              id: UserId;
-              name: string;
-              item: /** This object could be null if there was no item being used in this turn or during this effect. */
-              | {
-                        id: ItemId;
-                        name: string;
-                    } /** This object could be null if there was no item being used in this turn or during this effect. */
-                  | null;
-          } /** This value could be null in stealthed attacks. */
-        | null;
+    {
+        id: UserId;
+        name: string;
+        item: /** This object could be null if there was no item being used in this turn or during this effect. */
+        {
+            id?: ItemId;
+            name?: string;
+        } | null;
+    } | null;
     defender: /** This value could be null in stealthed attacks. */
-    | {
-              id: number;
-              name: string;
-          } /** This value could be null in stealthed attacks. */
-        | null;
+    {
+        id: UserId;
+        name: string;
+    } | null;
 }
 
 export interface AttackLogResponse {
@@ -1666,7 +1747,7 @@ export interface TornItem {
     requirement: string | null;
     image: string;
     type: TornItemTypeEnum;
-    sub_type: TornItemWeaponTypeEnum & (string | null);
+    sub_type: TornItemWeaponTypeEnum | null;
     is_masked: boolean;
     is_tradable: boolean;
     is_found_in_city: boolean;
@@ -1680,20 +1761,46 @@ export interface TornItem {
         market_price: number;
     };
     circulation: number;
-    details: (TornItemWeaponDetails & TornItemArmorDetails) | null;
+    details: TornItemWeaponDetails | TornItemArmorDetails | null;
 }
 
 export interface TornItemsResponse {
     items: TornItem[];
 }
 
-/** The following selections will fallback to API v1 and may change at any time: 'bank','cards','cityshops','companies','competition','dirtybombs','education','factiontree','gyms','honors','itemdetails','itemstats','medals','organisedcrimes','pawnshop','pokertables','properties','rackets','raidreport','raids','rockpaperscissors','searchforcash','shoplifting','stats','stocks','territory','territorynames','territorywarreport','territorywars'. */
+export interface TornFactionTreeBranch {
+    id: FactionBranchId;
+    name: string;
+    upgrades: {
+        name: string;
+        level: number;
+        ability: string;
+        cost: number;
+        challenge: {
+            description: string;
+            amount_required: number;
+            stat: FactionStatEnum;
+        } | null;
+    }[];
+}
+
+export interface TornFactionTree {
+    name: string;
+    branches: TornFactionTreeBranch[];
+}
+
+export interface TornFactionTreeResponse {
+    factionTree: TornFactionTree;
+}
+
+/** The following selections will fallback to API v1 and may change at any time: 'bank','cards','cityshops','companies','competition','dirtybombs','education','gyms','honors','itemdetails','itemstats','medals','organisedcrimes','pawnshop','pokertables','properties','rackets','raidreport','raids','rockpaperscissors','searchforcash','shoplifting','stats','stocks','territory','territorynames','territorywarreport','territorywars'. */
 export type TornSelectionName =
     | "attacklog"
     | "bounties"
     | "calendar"
     | "crimes"
     | "factionHof"
+    | "factiontree"
     | "hof"
     | "itemammo"
     | "itemmods"
@@ -1710,7 +1817,6 @@ export type TornSelectionName =
     | "competition"
     | "dirtybombs"
     | "education"
-    | "factiontree"
     | "gyms"
     | "honors"
     | "itemdetails"
@@ -2155,7 +2261,7 @@ export interface PersonalStatsAttackingPublic {
         elo: number;
         unarmored_wins: number;
         highest_level_beaten: number;
-        escapes: {
+        escapes?: {
             player: number;
             foes: number;
         };
@@ -2671,7 +2777,7 @@ export interface UserCrimeDetailsBootlegging {
         total: number;
         earnings: number;
     };
-    dvds_copied: number;
+    dvds_copied?: number;
 }
 
 export interface UserCrimeDetailsGraffiti {
@@ -2693,8 +2799,8 @@ export interface UserCrimeDetailsCardSkimming {
         sold: number;
         lost: number;
         areas: {
-            id?: number;
-            amount?: number;
+            id: number;
+            amount: number;
         }[];
     };
     skimmers: {
@@ -2828,14 +2934,14 @@ export interface UserRacesResponse {
 }
 
 export interface UserRaceCarDetails extends RaceCar {
-    id?: RaceCarId;
-    name?: string;
-    worth?: number;
-    points_spent?: number;
-    races_entered?: number;
-    races_won?: number;
-    is_removed?: boolean;
-    parts?: RaceCarUpgradeId[];
+    id: RaceCarId;
+    name: string;
+    worth: number;
+    points_spent: number;
+    races_entered: number;
+    races_won: number;
+    is_removed: boolean;
+    parts: RaceCarUpgradeId[];
 }
 
 export interface UserEnlistedCarsResponse {
@@ -2853,7 +2959,7 @@ export interface UserForumThreadsResponse {
 }
 
 export interface UserForumSubscribedThreadsResponse {
-    forumSubscribedThreads: ForumSubscribedThread[];
+    forumSubscribedThreads?: ForumSubscribedThread[];
 }
 
 export interface UserForumFeedResponse {
@@ -2927,7 +3033,7 @@ export interface UserItemMarkeListingItemDetails {
     name: string;
     type: string;
     rarity: ("yellow" | "orange" | "red") | null;
-    uid: number | null;
+    uid: ItemUid | null;
     stats: ItemMarketListingItemStats | null;
     bonuses: ItemMarketListingItemBonus[];
 }
@@ -2965,7 +3071,7 @@ export interface UserList {
     id: UserId;
     name: string;
     level: number;
-    faction_id: FactionId & (number | null);
+    faction_id: FactionId | null;
     last_action: UserLastAction;
     status: UserStatus;
 }