tornapi-typescript 5.8.0 → 5.8.1

package/dist/index.d.ts

@@ -496,6 +496,15 @@ export interface ErrorCategorySelectionUnavailableForInteractionLogs {
     error: string;
 }
 export type ApiError = ErrorUnknown | ErrorKeyEmpty | ErrorIncorrectKey | ErrorWrongType | ErrorWrongFields | ErrorTooManyRequests | ErrorIncorrectId | ErrorIncorrectIdEntityRelation | ErrorIpBlocked | ErrorApiDisabled | ErrorKeyOwnerInFederalJail | ErrorKeyChangeCooldown | ErrorKeyReadError | ErrorKeyTemporaryDisabled | ErrorDailyReadLimitReached | ErrorLogUnavailable | ErrorAccessLevelTooLow | ErrorBackendError | ErrorApiKeyPaused | ErrorMustMigrateToCrimesV2 | ErrorRaceNotFinished | ErrorIncorrectCategory | ErrorOnlyAvailableInApiV1 | ErrorOnlyAvailableInApiV2 | ErrorClosedTemporarily | ErrorInvalidStatRequested | ErrorOnlyCategoryOrStatsAllowed | ErrorMustMigrateToOrganizedCrimesV2 | ErrorIncorrectLogId | ErrorCategorySelectionUnavailableForInteractionLogs;
+export interface UserItemMod {
+    id: ItemModId;
+    title: string;
+    equipped: boolean;
+    equipped_item_uid: ItemUid | null;
+}
+export interface UserItemModsResponse {
+    itemmods: UserItemMod[];
+}
 export interface UserTradesResponse {
     trades: UserTrade[];
     _metadata: RequestMetadataWithLinks;
@@ -615,7 +624,18 @@ export interface UserOrganizedCrimesResponse {
 }
 export type UserEquipment = TornItemDetails & {
     slot: number;
+    mods: UserEquipmentItemMod[];
+    ammo: {
+        id: AmmoId;
+        name: string;
+        quantity: number;
+        type: TornItemAmmoTypeEnum;
+    };
 };
+export interface UserEquipmentItemMod {
+    id: ItemModId;
+    name: string;
+}
 export interface UserClothing {
     id: ItemId;
     name: string;
@@ -2736,18 +2756,20 @@ export interface CompanyCustomers {
     weekly: number;
 }
 export interface CompanyEmployeesResponse {
-    employees: (CompanyEmployee | CompanyEmployeeExtended)[];
+    employees: (CompanyEmployee | CompanyEmployeeExtended | CompanyEmployeeFull)[];
 }
 export interface CompanyEmployeesResponseBasic {
     employees: CompanyEmployee[];
 }
 export interface CompanyEmployeeExtended extends CompanyEmployee {
-    joined_at: number;
-    wage: number;
     stats: CompanyEmployeeStats;
     effectiveness: CompanyEmployeeEffectiveness;
-    value: number | null;
 }
+export type CompanyEmployeeFull = CompanyEmployeeExtended & {
+    joined_at: number;
+    wage: number;
+    value: number | null;
+};
 export interface CompanyEmployeeStats {
     manual_labor: number;
     intelligence: number;
@@ -2998,7 +3020,7 @@ export interface MarketRentalsResponse {
     rentals_timestamp: number;
     /** The minimum amount of time needed before the cache timestamp can change. */
     rentals_delay?: number;
-    _metadata: RequestMetadataWithLinks;
+    _metadata: RequestMetadataWithLinksAndTotal;
 }
 export interface MarketPropertyDetails {
     listings: {
@@ -3015,7 +3037,7 @@ export interface MarketPropertiesResponse {
     properties_timestamp: number;
     /** The minimum amount of time needed before the cache timestamp can change. */
     properties_delay?: number;
-    _metadata: RequestMetadataWithLinks;
+    _metadata: RequestMetadataWithLinksAndTotal;
 }
 export interface BazaarWeekly {
     busiest: BazaarWeeklyCustomers[];
@@ -3108,7 +3130,7 @@ export interface ItemMarket {
 }
 export interface MarketItemMarketResponse {
     itemmarket: ItemMarket;
-    _metadata: RequestMetadataWithLinks;
+    _metadata: RequestMetadataWithLinksAndTotal;
 }
 /** The following selections will fallback to API v1 and may change at any time: 'pointsmarket'. */
 export type MarketSelectionName = string;
@@ -3633,6 +3655,7 @@ export interface TornItemAmmoResponse {
 export interface TornItemMods {
     id: ItemModId;
     name: string;
+    image: string;
     description: string;
     /** Whether the upgrade fits on dual weapons. */
     dual_fit: boolean;
@@ -7104,6 +7127,10 @@ export interface UserV2 extends BaseSchema {
             response: UserItemMarketResponse;
             params: "offset" | "timestamp";
         };
+        itemmods: {
+            response: UserItemModsResponse;
+            params: "timestamp";
+        };
         job: {
             response: UserJobResponse;
             params: "timestamp";

package/dist/index.ts

@@ -5576,6 +5576,17 @@ export type ApiError =
     | ErrorIncorrectLogId
     | ErrorCategorySelectionUnavailableForInteractionLogs;
 
+export interface UserItemMod {
+    id: ItemModId;
+    title: string;
+    equipped: boolean;
+    equipped_item_uid: ItemUid | null;
+}
+
+export interface UserItemModsResponse {
+    itemmods: UserItemMod[];
+}
+
 export interface UserTradesResponse {
     trades: UserTrade[];
     _metadata: RequestMetadataWithLinks;
@@ -5721,8 +5732,20 @@ export interface UserOrganizedCrimesResponse {
 
 export type UserEquipment = TornItemDetails & {
     slot: number;
+    mods: UserEquipmentItemMod[];
+    ammo: {
+        id: AmmoId;
+        name: string;
+        quantity: number;
+        type: TornItemAmmoTypeEnum;
+    };
 };
 
+export interface UserEquipmentItemMod {
+    id: ItemModId;
+    name: string;
+}
+
 export interface UserClothing {
     id: ItemId;
     name: string;
@@ -8448,7 +8471,11 @@ export interface CompanyCustomers {
 }
 
 export interface CompanyEmployeesResponse {
-    employees: (CompanyEmployee | CompanyEmployeeExtended)[];
+    employees: (
+        | CompanyEmployee
+        | CompanyEmployeeExtended
+        | CompanyEmployeeFull
+    )[];
 }
 
 export interface CompanyEmployeesResponseBasic {
@@ -8456,13 +8483,16 @@ export interface CompanyEmployeesResponseBasic {
 }
 
 export interface CompanyEmployeeExtended extends CompanyEmployee {
-    joined_at: number;
-    wage: number;
     stats: CompanyEmployeeStats;
     effectiveness: CompanyEmployeeEffectiveness;
-    value: number | null;
 }
 
+export type CompanyEmployeeFull = CompanyEmployeeExtended & {
+    joined_at: number;
+    wage: number;
+    value: number | null;
+};
+
 export interface CompanyEmployeeStats {
     manual_labor: number;
     intelligence: number;
@@ -8748,7 +8778,7 @@ export interface MarketRentalsResponse {
     rentals_timestamp: number;
     /** The minimum amount of time needed before the cache timestamp can change. */
     rentals_delay?: number;
-    _metadata: RequestMetadataWithLinks;
+    _metadata: RequestMetadataWithLinksAndTotal;
 }
 
 export interface MarketPropertyDetails {
@@ -8767,7 +8797,7 @@ export interface MarketPropertiesResponse {
     properties_timestamp: number;
     /** The minimum amount of time needed before the cache timestamp can change. */
     properties_delay?: number;
-    _metadata: RequestMetadataWithLinks;
+    _metadata: RequestMetadataWithLinksAndTotal;
 }
 
 export interface BazaarWeekly {
@@ -8881,7 +8911,7 @@ export interface ItemMarket {
 
 export interface MarketItemMarketResponse {
     itemmarket: ItemMarket;
-    _metadata: RequestMetadataWithLinks;
+    _metadata: RequestMetadataWithLinksAndTotal;
 }
 
 /** The following selections will fallback to API v1 and may change at any time: 'pointsmarket'. */
@@ -9491,6 +9521,7 @@ export interface TornItemAmmoResponse {
 export interface TornItemMods {
     id: ItemModId;
     name: string;
+    image: string;
     description: string;
     /** Whether the upgrade fits on dual weapons. */
     dual_fit: boolean;
@@ -13060,6 +13091,10 @@ export interface UserV2 extends BaseSchema {
             response: UserItemMarketResponse;
             params: "offset" | "timestamp";
         };
+        itemmods: {
+            response: UserItemModsResponse;
+            params: "timestamp";
+        };
         job: {
             response: UserJobResponse;
             params: "timestamp";

package/dist/openapi.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "Torn API",
     "description": "\n * The development of Torn's API v2 is still ongoing.\n * If selections remain unaltered, they will default to the API v1 version.\n * Unlike API v1, API v2 accepts both selections and IDs as path and query parameters.\n * If any discrepancies or errors are found, please submit a [bug report](https://www.torn.com/forums.php#/p=forums&f=19&b=0&a=0) on the Torn Forums.\n * In case you're using bots to check for changes on openapi.json file, make sure to specificy a custom user-agent header - CloudFlare sometimes prevents requests from default user-agents.",
-    "version": "5.8.0"
+    "version": "5.8.1"
   },
   "servers": [
     {
@@ -1665,6 +1665,45 @@
         "x-stability": "Stable"
       }
     },
+    "/user/itemmods": {
+      "get": {
+        "tags": [
+          "User"
+        ],
+        "summary": "Get your information about available item mods",
+        "description": "Requires minimal access key. <br>",
+        "operationId": "getMyItemModsInformation",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ApiTimestamp"
+          },
+          {
+            "$ref": "#/components/parameters/ApiComment"
+          },
+          {
+            "$ref": "#/components/parameters/ApiKeyPublic"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UserItemModsResponse"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ],
+        "x-stability": "Stable"
+      }
+    },
     "/user/job": {
       "get": {
         "tags": [
@@ -3801,6 +3840,9 @@
                     {
                       "$ref": "#/components/schemas/UserOrganizedCrimeResponse"
                     },
+                    {
+                      "$ref": "#/components/schemas/UserItemModsResponse"
+                    },
                     {
                       "$ref": "#/components/schemas/AttacksResponse"
                     },
@@ -6439,7 +6481,7 @@
           "Company"
         ],
         "summary": "Get my company's employees",
-        "description": "Requires public access key. <br>When using Limited, Custom or Full access API keys, the response will be of type CompanyEmployeeExtended, otherwise it will be of type CompanyEmployee.",
+        "description": "Requires public access key. <br>When using Limited, Custom or Full access API keys, the response will be:<br>\n * for director: CompanyEmployeeFull\n * for employee: CompanyEmployeeExtended\n * anyone else: CompanyEmployee.",
         "operationId": "getMyCompanyEmployees",
         "parameters": [
           {
@@ -17770,6 +17812,50 @@
           }
         ]
       },
+      "UserItemMod": {
+        "required": [
+          "id",
+          "title",
+          "equipped",
+          "equipped_item_uid"
+        ],
+        "properties": {
+          "id": {
+            "$ref": "#/components/schemas/ItemModId"
+          },
+          "title": {
+            "type": "string"
+          },
+          "equipped": {
+            "type": "boolean"
+          },
+          "equipped_item_uid": {
+            "oneOf": [
+              {
+                "$ref": "#/components/schemas/ItemUid"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "UserItemModsResponse": {
+        "required": [
+          "itemmods"
+        ],
+        "properties": {
+          "itemmods": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/UserItemMod"
+            }
+          }
+        },
+        "type": "object"
+      },
       "UserTradesResponse": {
         "required": [
           "trades",
@@ -18324,18 +18410,65 @@
           },
           {
             "required": [
-              "slot"
+              "slot",
+              "ammo",
+              "mods"
             ],
             "properties": {
               "slot": {
                 "type": "integer",
                 "format": "int32"
+              },
+              "mods": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/UserEquipmentItemMod"
+                }
+              },
+              "ammo": {
+                "required": [
+                  "id",
+                  "name",
+                  "type",
+                  "quantity"
+                ],
+                "properties": {
+                  "id": {
+                    "$ref": "#/components/schemas/AmmoId"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "quantity": {
+                    "type": "integer",
+                    "format": "int32"
+                  },
+                  "type": {
+                    "$ref": "#/components/schemas/TornItemAmmoTypeEnum"
+                  }
+                },
+                "type": "object"
               }
             },
             "type": "object"
           }
         ]
       },
+      "UserEquipmentItemMod": {
+        "required": [
+          "id",
+          "name"
+        ],
+        "properties": {
+          "id": {
+            "$ref": "#/components/schemas/ItemModId"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
       "UserClothing": {
         "required": [
           "id",
@@ -22007,6 +22140,7 @@
               "icons",
               "inventory",
               "itemmarket",
+              "itemmod",
               "job",
               "jobpoints",
               "jobranks",
@@ -28731,6 +28865,9 @@
                 },
                 {
                   "$ref": "#/components/schemas/CompanyEmployeeExtended"
+                },
+                {
+                  "$ref": "#/components/schemas/CompanyEmployeeFull"
                 }
               ]
             }
@@ -28757,12 +28894,32 @@
           {
             "$ref": "#/components/schemas/CompanyEmployee"
           },
+          {
+            "required": [
+              "stats",
+              "effectiveness"
+            ],
+            "properties": {
+              "stats": {
+                "$ref": "#/components/schemas/CompanyEmployeeStats"
+              },
+              "effectiveness": {
+                "$ref": "#/components/schemas/CompanyEmployeeEffectiveness"
+              }
+            },
+            "type": "object"
+          }
+        ]
+      },
+      "CompanyEmployeeFull": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/CompanyEmployeeExtended"
+          },
           {
             "required": [
               "joined_at",
               "wage",
-              "stats",
-              "effectiveness",
               "value"
             ],
             "properties": {
@@ -28774,12 +28931,6 @@
                 "type": "integer",
                 "format": "int64"
               },
-              "stats": {
-                "$ref": "#/components/schemas/CompanyEmployeeStats"
-              },
-              "effectiveness": {
-                "$ref": "#/components/schemas/CompanyEmployeeEffectiveness"
-              },
               "value": {
                 "description": "This value is null if you don't have a secretary.",
                 "oneOf": [
@@ -30001,7 +30152,7 @@
             "format": "int32"
           },
           "_metadata": {
-            "$ref": "#/components/schemas/RequestMetadataWithLinks"
+            "$ref": "#/components/schemas/RequestMetadataWithLinksAndTotal"
           }
         },
         "type": "object"
@@ -30075,7 +30226,7 @@
             "format": "int32"
           },
           "_metadata": {
-            "$ref": "#/components/schemas/RequestMetadataWithLinks"
+            "$ref": "#/components/schemas/RequestMetadataWithLinksAndTotal"
           }
         },
         "type": "object"
@@ -30577,7 +30728,7 @@
             "$ref": "#/components/schemas/ItemMarket"
           },
           "_metadata": {
-            "$ref": "#/components/schemas/RequestMetadataWithLinks"
+            "$ref": "#/components/schemas/RequestMetadataWithLinksAndTotal"
           }
         },
         "type": "object"
@@ -33121,6 +33272,7 @@
         "required": [
           "id",
           "name",
+          "image",
           "description",
           "dual_fit",
           "weapons"
@@ -33132,6 +33284,9 @@
           "name": {
             "type": "string"
           },
+          "image": {
+            "type": "string"
+          },
           "description": {
             "type": "string"
           },

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "tornapi-typescript",
   "type": "module",
-  "version": "5.8.0",
+  "version": "5.8.1",
   "scripts": {
     "generate-types": "tsc && node build/index.js"
   },
   "devDependencies": {
     "@scalar/openapi-types": "^0.8.0",
-    "@types/node": "^24.12.2",
+    "@types/node": "^24.12.3",
     "prettier": "^3.8.3",
     "typeconv": "^2.3.1",
     "typescript": "^6.0.3"