@orangefox-recovery/foxinternalclient 5.3.3 → 6.0.4

package/src/apis/DeviceApi.ts

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * Fox API
- *  Warning: Please add a custom user agent header to your requests. This would help us fighting against DDoS attacks in future, while keeping your application\'s access to the API. In future, this may be a mandatory requirement.  To reduce the system load, the API endpoints are rate limited. The default limit is 30 requests per minute. Contact admin@orangefox.tech if you need a higher limit.  The requests may be logged for analytics and development purposes. 
+ * Warning: Please add a custom user agent header to your requests. This would help us fighting against DDoS attacks in future, while keeping your application\'s access to the API. In future, this may be a mandatory requirement.  To reduce the system load, the API endpoints are rate limited. The default limit is 30 requests per minute. Contact admin@orangefox.tech if you need a higher limit.  The requests may be logged for analytics and development purposes. 
  *
- * The version of the OpenAPI document: 5.3.3
+ * The version of the OpenAPI document: 6.0.4
  * Contact: admin@orangefox.tech
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -16,39 +16,39 @@
 import * as runtime from '../runtime';
 import type {
   DeviceResponse,
-  HTTPValidationError,
+  ErrorResponse,
   ListResponseShortDeviceResponse,
-  ListResponseStr,
+  ListResponseString,
 } from '../models/index';
 import {
     DeviceResponseFromJSON,
     DeviceResponseToJSON,
-    HTTPValidationErrorFromJSON,
-    HTTPValidationErrorToJSON,
+    ErrorResponseFromJSON,
+    ErrorResponseToJSON,
     ListResponseShortDeviceResponseFromJSON,
     ListResponseShortDeviceResponseToJSON,
-    ListResponseStrFromJSON,
-    ListResponseStrToJSON,
+    ListResponseStringFromJSON,
+    ListResponseStringToJSON,
 } from '../models/index';
 
 export interface GetDeviceRequest {
     deviceId?: string | null;
-    id?: string | null;
     codename?: string | null;
+    id?: string | null;
 }
 
-export interface GetDeviceDeprecatedRequest {
+export interface GetDeviceByIdRequest {
     deviceId: string;
 }
 
-export interface GetDevicesRequest {
-    id?: Array<string>;
-    id2?: Array<string>;
-    oemName?: Array<string>;
-    codename?: Array<string>;
-    modelName?: Array<string>;
+export interface ListDevicesRequest {
+    id?: string | null;
+    id2?: string | null;
+    oemName?: string | null;
+    codename?: string | null;
+    modelName?: string | null;
     supported?: boolean | null;
-    maintainer?: Array<string>;
+    maintainer?: string | null;
     freezed?: boolean | null;
     hasReleases?: boolean | null;
     skip?: number | null;
@@ -63,11 +63,21 @@ export interface GetDevicesRequest {
  */
 export interface DeviceApiInterface {
     /**
-     * Extended get device method, including the ability to get a device using device codename instead of the ID.  /device/get?codename=lavender   Due to the reasons mentioned in the /device route, identification devices using their codenames are considered  unrecommended.
-     * @summary Get Device
+     * Creates request options for getDevice without sending the request
      * @param {string} [deviceId] 
-     * @param {string} [id] Filter by Device ID (deprecated)
-     * @param {string} [codename] Not recommended to use when you can
+     * @param {string} [codename] 
+     * @param {string} [id] 
+     * @throws {RequiredError}
+     * @memberof DeviceApiInterface
+     */
+    getDeviceRequestOpts(requestParameters: GetDeviceRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * 
+     * @summary GET /devices/get - Get a single device by device_id, codename, or _id.
+     * @param {string} [deviceId] 
+     * @param {string} [codename] 
+     * @param {string} [id] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof DeviceApiInterface
@@ -75,69 +85,96 @@ export interface DeviceApiInterface {
     getDeviceRaw(requestParameters: GetDeviceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeviceResponse>>;
 
     /**
-     * Extended get device method, including the ability to get a device using device codename instead of the ID.  /device/get?codename=lavender   Due to the reasons mentioned in the /device route, identification devices using their codenames are considered  unrecommended.
-     * Get Device
+     * GET /devices/get - Get a single device by device_id, codename, or _id.
      */
     getDevice(requestParameters: GetDeviceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeviceResponse>;
 
     /**
-     * Gets device info using device ID.
-     * @summary Get Device Short
-     * @param {string} deviceId 
+     * Creates request options for getDeviceById without sending the request
+     * @param {string} deviceId Device ID
+     * @throws {RequiredError}
+     * @memberof DeviceApiInterface
+     */
+    getDeviceByIdRequestOpts(requestParameters: GetDeviceByIdRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * 
+     * @summary GET /devices/{device_id} - Get device by ID (deprecated).
+     * @param {string} deviceId Device ID
      * @param {*} [options] Override http request option.
-     * @deprecated
      * @throws {RequiredError}
      * @memberof DeviceApiInterface
      */
-    getDeviceDeprecatedRaw(requestParameters: GetDeviceDeprecatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeviceResponse>>;
+    getDeviceByIdRaw(requestParameters: GetDeviceByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeviceResponse>>;
 
     /**
-     * Gets device info using device ID.
-     * Get Device Short
-     * @deprecated
+     * GET /devices/{device_id} - Get device by ID (deprecated).
      */
-    getDeviceDeprecated(requestParameters: GetDeviceDeprecatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeviceResponse>;
+    getDeviceById(requestParameters: GetDeviceByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeviceResponse>;
 
     /**
-     * Get a device list.  Device ID is the internal OrangeFox device identifier (https://www.mongodb.com/docs/manual/reference/method/ObjectId/). Please only use it for identification instead of codename or model_name if it\'s possible. You would find two Device ID query parameters here, the _id one is left deprecated due to historical reasons,  please use id instead.  Please note that using model_name is unrecommended and considered deprecated as it\'s very inconsistent around some  OEMs that play with the names around. As of the current moment, the API won\'t support unified model names at all! In short, do not use model_name as device\'s identification.  Be careful using codenames, there are a lot of problems and pain about those. Some OEMs keep releasing new phones with the same hardware as the old ones and may or may not update or change the codename for those. Currently, API doesn\'t support unified devices; they would have only one codename.  Our OEMs database would not include subbrands, they instead would be added to the model name. Like oem_name: \"Xiaomi\" model_name: \"Poco F5 Pro\". The exclusions are merged ones, like OnePlus, as calling those BBK OnePlus is really weird in the respective  communities.  Note: You will get only a shortened device object with this method, if you want to get a full one, use \"/device/<device_id>\" or \"/device/get\" method instead.
-     * @summary Get Devices
-     * @param {Array<string>} [id] Filter by Device IDs
-     * @param {Array<string>} [id2] Filter by Device IDs (deprecated)
-     * @param {Array<string>} [oemName] Filter by OEM names
-     * @param {Array<string>} [codename] Filter by device codenames
-     * @param {Array<string>} [modelName] Filter by model names
-     * @param {boolean} [supported] Supported status
-     * @param {Array<string>} [maintainer] Filter by maintainer ID
-     * @param {boolean} [freezed] Filter by Freezed status
-     * @param {boolean} [hasReleases] Filter by has releases status
-     * @param {number} [skip] Skip query results
-     * @param {number} [limit] Limit query results (0 means unlimited)
+     * Creates request options for getOems without sending the request
+     * @throws {RequiredError}
+     * @memberof DeviceApiInterface
+     */
+    getOemsRequestOpts(): Promise<runtime.RequestOpts>;
+
+    /**
+     * 
+     * @summary GET /oems - Get a list of all unique OEM names.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof DeviceApiInterface
      */
-    getDevicesRaw(requestParameters: GetDevicesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListResponseShortDeviceResponse>>;
+    getOemsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListResponseString>>;
+
+    /**
+     * GET /oems - Get a list of all unique OEM names.
+     */
+    getOems(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListResponseString>;
 
     /**
-     * Get a device list.  Device ID is the internal OrangeFox device identifier (https://www.mongodb.com/docs/manual/reference/method/ObjectId/). Please only use it for identification instead of codename or model_name if it\'s possible. You would find two Device ID query parameters here, the _id one is left deprecated due to historical reasons,  please use id instead.  Please note that using model_name is unrecommended and considered deprecated as it\'s very inconsistent around some  OEMs that play with the names around. As of the current moment, the API won\'t support unified model names at all! In short, do not use model_name as device\'s identification.  Be careful using codenames, there are a lot of problems and pain about those. Some OEMs keep releasing new phones with the same hardware as the old ones and may or may not update or change the codename for those. Currently, API doesn\'t support unified devices; they would have only one codename.  Our OEMs database would not include subbrands, they instead would be added to the model name. Like oem_name: \"Xiaomi\" model_name: \"Poco F5 Pro\". The exclusions are merged ones, like OnePlus, as calling those BBK OnePlus is really weird in the respective  communities.  Note: You will get only a shortened device object with this method, if you want to get a full one, use \"/device/<device_id>\" or \"/device/get\" method instead.
-     * Get Devices
+     * Creates request options for listDevices without sending the request
+     * @param {string} [id] 
+     * @param {string} [id2] 
+     * @param {string} [oemName] 
+     * @param {string} [codename] 
+     * @param {string} [modelName] 
+     * @param {boolean} [supported] 
+     * @param {string} [maintainer] 
+     * @param {boolean} [freezed] 
+     * @param {boolean} [hasReleases] 
+     * @param {number} [skip] 
+     * @param {number} [limit] 
+     * @throws {RequiredError}
+     * @memberof DeviceApiInterface
      */
-    getDevices(requestParameters: GetDevicesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListResponseShortDeviceResponse>;
+    listDevicesRequestOpts(requestParameters: ListDevicesRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Lists all OEM names
-     * @summary Get Oems
+     * 
+     * @summary GET /devices/ - List devices with filters.
+     * @param {string} [id] 
+     * @param {string} [id2] 
+     * @param {string} [oemName] 
+     * @param {string} [codename] 
+     * @param {string} [modelName] 
+     * @param {boolean} [supported] 
+     * @param {string} [maintainer] 
+     * @param {boolean} [freezed] 
+     * @param {boolean} [hasReleases] 
+     * @param {number} [skip] 
+     * @param {number} [limit] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof DeviceApiInterface
      */
-    getOemsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListResponseStr>>;
+    listDevicesRaw(requestParameters: ListDevicesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListResponseShortDeviceResponse>>;
 
     /**
-     * Lists all OEM names
-     * Get Oems
+     * GET /devices/ - List devices with filters.
      */
-    getOems(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListResponseStr>;
+    listDevices(requestParameters: ListDevicesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListResponseShortDeviceResponse>;
 
 }
 
@@ -147,42 +184,48 @@ export interface DeviceApiInterface {
 export class DeviceApi extends runtime.BaseAPI implements DeviceApiInterface {
 
     /**
-     * Extended get device method, including the ability to get a device using device codename instead of the ID.  /device/get?codename=lavender   Due to the reasons mentioned in the /device route, identification devices using their codenames are considered  unrecommended.
-     * Get Device
+     * Creates request options for getDevice without sending the request
      */
-    async getDeviceRaw(requestParameters: GetDeviceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeviceResponse>> {
+    async getDeviceRequestOpts(requestParameters: GetDeviceRequest): Promise<runtime.RequestOpts> {
         const queryParameters: any = {};
 
         if (requestParameters['deviceId'] != null) {
             queryParameters['device_id'] = requestParameters['deviceId'];
         }
 
-        if (requestParameters['id'] != null) {
-            queryParameters['_id'] = requestParameters['id'];
-        }
-
         if (requestParameters['codename'] != null) {
             queryParameters['codename'] = requestParameters['codename'];
         }
 
+        if (requestParameters['id'] != null) {
+            queryParameters['_id'] = requestParameters['id'];
+        }
+
         const headerParameters: runtime.HTTPHeaders = {};
 
 
         let urlPath = `/devices/get`;
 
-        const response = await this.request({
+        return {
             path: urlPath,
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
-        }, initOverrides);
+        };
+    }
+
+    /**
+     * GET /devices/get - Get a single device by device_id, codename, or _id.
+     */
+    async getDeviceRaw(requestParameters: GetDeviceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeviceResponse>> {
+        const requestOptions = await this.getDeviceRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
 
         return new runtime.JSONApiResponse(response, (jsonValue) => DeviceResponseFromJSON(jsonValue));
     }
 
     /**
-     * Extended get device method, including the ability to get a device using device codename instead of the ID.  /device/get?codename=lavender   Due to the reasons mentioned in the /device route, identification devices using their codenames are considered  unrecommended.
-     * Get Device
+     * GET /devices/get - Get a single device by device_id, codename, or _id.
      */
     async getDevice(requestParameters: GetDeviceRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeviceResponse> {
         const response = await this.getDeviceRaw(requestParameters, initOverrides);
@@ -190,15 +233,13 @@ export class DeviceApi extends runtime.BaseAPI implements DeviceApiInterface {
     }
 
     /**
-     * Gets device info using device ID.
-     * Get Device Short
-     * @deprecated
+     * Creates request options for getDeviceById without sending the request
      */
-    async getDeviceDeprecatedRaw(requestParameters: GetDeviceDeprecatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeviceResponse>> {
+    async getDeviceByIdRequestOpts(requestParameters: GetDeviceByIdRequest): Promise<runtime.RequestOpts> {
         if (requestParameters['deviceId'] == null) {
             throw new runtime.RequiredError(
                 'deviceId',
-                'Required parameter "deviceId" was null or undefined when calling getDeviceDeprecated().'
+                'Required parameter "deviceId" was null or undefined when calling getDeviceById().'
             );
         }
 
@@ -210,31 +251,73 @@ export class DeviceApi extends runtime.BaseAPI implements DeviceApiInterface {
         let urlPath = `/devices/{device_id}`;
         urlPath = urlPath.replace(`{${"device_id"}}`, encodeURIComponent(String(requestParameters['deviceId'])));
 
-        const response = await this.request({
+        return {
             path: urlPath,
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
-        }, initOverrides);
+        };
+    }
+
+    /**
+     * GET /devices/{device_id} - Get device by ID (deprecated).
+     */
+    async getDeviceByIdRaw(requestParameters: GetDeviceByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeviceResponse>> {
+        const requestOptions = await this.getDeviceByIdRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
 
         return new runtime.JSONApiResponse(response, (jsonValue) => DeviceResponseFromJSON(jsonValue));
     }
 
     /**
-     * Gets device info using device ID.
-     * Get Device Short
-     * @deprecated
+     * GET /devices/{device_id} - Get device by ID (deprecated).
      */
-    async getDeviceDeprecated(requestParameters: GetDeviceDeprecatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeviceResponse> {
-        const response = await this.getDeviceDeprecatedRaw(requestParameters, initOverrides);
+    async getDeviceById(requestParameters: GetDeviceByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeviceResponse> {
+        const response = await this.getDeviceByIdRaw(requestParameters, initOverrides);
         return await response.value();
     }
 
     /**
-     * Get a device list.  Device ID is the internal OrangeFox device identifier (https://www.mongodb.com/docs/manual/reference/method/ObjectId/). Please only use it for identification instead of codename or model_name if it\'s possible. You would find two Device ID query parameters here, the _id one is left deprecated due to historical reasons,  please use id instead.  Please note that using model_name is unrecommended and considered deprecated as it\'s very inconsistent around some  OEMs that play with the names around. As of the current moment, the API won\'t support unified model names at all! In short, do not use model_name as device\'s identification.  Be careful using codenames, there are a lot of problems and pain about those. Some OEMs keep releasing new phones with the same hardware as the old ones and may or may not update or change the codename for those. Currently, API doesn\'t support unified devices; they would have only one codename.  Our OEMs database would not include subbrands, they instead would be added to the model name. Like oem_name: \"Xiaomi\" model_name: \"Poco F5 Pro\". The exclusions are merged ones, like OnePlus, as calling those BBK OnePlus is really weird in the respective  communities.  Note: You will get only a shortened device object with this method, if you want to get a full one, use \"/device/<device_id>\" or \"/device/get\" method instead.
-     * Get Devices
+     * Creates request options for getOems without sending the request
      */
-    async getDevicesRaw(requestParameters: GetDevicesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListResponseShortDeviceResponse>> {
+    async getOemsRequestOpts(): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/oems`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * GET /oems - Get a list of all unique OEM names.
+     */
+    async getOemsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListResponseString>> {
+        const requestOptions = await this.getOemsRequestOpts();
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ListResponseStringFromJSON(jsonValue));
+    }
+
+    /**
+     * GET /oems - Get a list of all unique OEM names.
+     */
+    async getOems(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListResponseString> {
+        const response = await this.getOemsRaw(initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listDevices without sending the request
+     */
+    async listDevicesRequestOpts(requestParameters: ListDevicesRequest): Promise<runtime.RequestOpts> {
         const queryParameters: any = {};
 
         if (requestParameters['id'] != null) {
@@ -284,55 +367,31 @@ export class DeviceApi extends runtime.BaseAPI implements DeviceApiInterface {
         const headerParameters: runtime.HTTPHeaders = {};
 
 
-        let urlPath = `/devices/`;
+        let urlPath = `/devices`;
 
-        const response = await this.request({
+        return {
             path: urlPath,
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
-        }, initOverrides);
-
-        return new runtime.JSONApiResponse(response, (jsonValue) => ListResponseShortDeviceResponseFromJSON(jsonValue));
+        };
     }
 
     /**
-     * Get a device list.  Device ID is the internal OrangeFox device identifier (https://www.mongodb.com/docs/manual/reference/method/ObjectId/). Please only use it for identification instead of codename or model_name if it\'s possible. You would find two Device ID query parameters here, the _id one is left deprecated due to historical reasons,  please use id instead.  Please note that using model_name is unrecommended and considered deprecated as it\'s very inconsistent around some  OEMs that play with the names around. As of the current moment, the API won\'t support unified model names at all! In short, do not use model_name as device\'s identification.  Be careful using codenames, there are a lot of problems and pain about those. Some OEMs keep releasing new phones with the same hardware as the old ones and may or may not update or change the codename for those. Currently, API doesn\'t support unified devices; they would have only one codename.  Our OEMs database would not include subbrands, they instead would be added to the model name. Like oem_name: \"Xiaomi\" model_name: \"Poco F5 Pro\". The exclusions are merged ones, like OnePlus, as calling those BBK OnePlus is really weird in the respective  communities.  Note: You will get only a shortened device object with this method, if you want to get a full one, use \"/device/<device_id>\" or \"/device/get\" method instead.
-     * Get Devices
+     * GET /devices/ - List devices with filters.
      */
-    async getDevices(requestParameters: GetDevicesRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListResponseShortDeviceResponse> {
-        const response = await this.getDevicesRaw(requestParameters, initOverrides);
-        return await response.value();
-    }
+    async listDevicesRaw(requestParameters: ListDevicesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListResponseShortDeviceResponse>> {
+        const requestOptions = await this.listDevicesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
 
-    /**
-     * Lists all OEM names
-     * Get Oems
-     */
-    async getOemsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListResponseStr>> {
-        const queryParameters: any = {};
-
-        const headerParameters: runtime.HTTPHeaders = {};
-
-
-        let urlPath = `/oems/`;
-
-        const response = await this.request({
-            path: urlPath,
-            method: 'GET',
-            headers: headerParameters,
-            query: queryParameters,
-        }, initOverrides);
-
-        return new runtime.JSONApiResponse(response, (jsonValue) => ListResponseStrFromJSON(jsonValue));
+        return new runtime.JSONApiResponse(response, (jsonValue) => ListResponseShortDeviceResponseFromJSON(jsonValue));
     }
 
     /**
-     * Lists all OEM names
-     * Get Oems
+     * GET /devices/ - List devices with filters.
      */
-    async getOems(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListResponseStr> {
-        const response = await this.getOemsRaw(initOverrides);
+    async listDevices(requestParameters: ListDevicesRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListResponseShortDeviceResponse> {
+        const response = await this.listDevicesRaw(requestParameters, initOverrides);
         return await response.value();
     }