@orangefox-recovery/foxinternalclient 5.2.1

package/docs/FoxFactoryApi.md

@@ -0,0 +1,375 @@
+# FoxFactoryApi
+
+All URIs are relative to *https://api.orangefox.download*
+
+|Method | HTTP request | Description|
+|------------- | ------------- | -------------|
+|[**cancelTaskFactoryTaskIdCancelPost**](#canceltaskfactorytaskidcancelpost) | **POST** /factory/{task_id}/cancel | Cancel Task|
+|[**deleteTaskFactoryTaskIdDelete**](#deletetaskfactorytaskiddelete) | **DELETE** /factory/{task_id} | Delete Task|
+|[**factoryStatusFactoryStatusGet**](#factorystatusfactorystatusget) | **GET** /factory/status | Factory Status|
+|[**getTaskFactoryTaskIdGet**](#gettaskfactorytaskidget) | **GET** /factory/{task_id} | Get Task|
+|[**listTasksFactoryGet**](#listtasksfactoryget) | **GET** /factory/ | List Tasks|
+|[**newTaskFactoryPost**](#newtaskfactorypost) | **POST** /factory/ | New Task|
+|[**updateTaskFactoryTaskIdPatch**](#updatetaskfactorytaskidpatch) | **PATCH** /factory/{task_id} | Update Task|
+
+# **cancelTaskFactoryTaskIdCancelPost**
+> BuildTaskResponse cancelTaskFactoryTaskIdCancelPost()
+
+Cancels a build task given its identifier. The task\'s status is updated to indicate that it is in the process of cancellation. If the task with the specified ID is not found, a 404 HTTP exception is raised.
+
+### Example
+
+```typescript
+import {
+    FoxFactoryApi,
+    Configuration
+} from '@orangefox-recovery/foxinternalclient';
+
+const configuration = new Configuration();
+const apiInstance = new FoxFactoryApi(configuration);
+
+let taskId: any; // (default to undefined)
+
+const { status, data } = await apiInstance.cancelTaskFactoryTaskIdCancelPost(
+    taskId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **taskId** | **any** |  | defaults to undefined|
+
+
+### Return type
+
+**BuildTaskResponse**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Successful Response |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **deleteTaskFactoryTaskIdDelete**
+> boolean deleteTaskFactoryTaskIdDelete()
+
+Deletes a build task given its identifier. If the task with the specified ID is not found, a 404 HTTP exception is raised.
+
+### Example
+
+```typescript
+import {
+    FoxFactoryApi,
+    Configuration
+} from '@orangefox-recovery/foxinternalclient';
+
+const configuration = new Configuration();
+const apiInstance = new FoxFactoryApi(configuration);
+
+let taskId: any; // (default to undefined)
+
+const { status, data } = await apiInstance.deleteTaskFactoryTaskIdDelete(
+    taskId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **taskId** | **any** |  | defaults to undefined|
+
+
+### Return type
+
+**boolean**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Successful Response |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **factoryStatusFactoryStatusGet**
+> FFStatusResponse factoryStatusFactoryStatusGet()
+
+
+### Example
+
+```typescript
+import {
+    FoxFactoryApi,
+    Configuration
+} from '@orangefox-recovery/foxinternalclient';
+
+const configuration = new Configuration();
+const apiInstance = new FoxFactoryApi(configuration);
+
+const { status, data } = await apiInstance.factoryStatusFactoryStatusGet();
+```
+
+### Parameters
+This endpoint does not have any parameters.
+
+
+### Return type
+
+**FFStatusResponse**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Successful Response |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **getTaskFactoryTaskIdGet**
+> BuildTaskResponse getTaskFactoryTaskIdGet()
+
+Retrieves the details of a specific build task.  This endpoint allows a user to fetch detailed information about a build task by its ID. Access to this endpoint is restricted to users with the \'maintainer\' or \'foxworker\' roles. Depending on the user\'s roles, returned task details may differ. Admin users will receive all task details, while others will have some fields excluded.
+
+### Example
+
+```typescript
+import {
+    FoxFactoryApi,
+    Configuration
+} from '@orangefox-recovery/foxinternalclient';
+
+const configuration = new Configuration();
+const apiInstance = new FoxFactoryApi(configuration);
+
+let taskId: any; // (default to undefined)
+
+const { status, data } = await apiInstance.getTaskFactoryTaskIdGet(
+    taskId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **taskId** | **any** |  | defaults to undefined|
+
+
+### Return type
+
+**BuildTaskResponse**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Successful Response |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **listTasksFactoryGet**
+> Array<BuildTaskShortResponse> listTasksFactoryGet()
+
+Get a list of all build tasks.  This endpoint retrieves all build tasks from the database and returns them as a list of abbreviated responses.  Parameters:     device_id (ObjectId, optional): Filter tasks by device ID
+
+### Example
+
+```typescript
+import {
+    FoxFactoryApi,
+    Configuration,
+    
+} from '@orangefox-recovery/foxinternalclient';
+
+const configuration = new Configuration();
+const apiInstance = new FoxFactoryApi(configuration);
+
+let deviceId: ; // (optional) (default to undefined)
+
+const { status, data } = await apiInstance.listTasksFactoryGet(
+    deviceId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **deviceId** | **** |  | (optional) defaults to undefined|
+
+
+### Return type
+
+**Array<BuildTaskShortResponse>**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Successful Response |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **newTaskFactoryPost**
+> boolean newTaskFactoryPost(newBuildTaskBody)
+
+Handles the creation of a new build task including validations for the device existence and its connection to GitLab. It initializes a new task with a pending status and the required details, then saves it to the database before returning the task model.
+
+### Example
+
+```typescript
+import {
+    FoxFactoryApi,
+    Configuration,
+    NewBuildTaskBody
+} from '@orangefox-recovery/foxinternalclient';
+
+const configuration = new Configuration();
+const apiInstance = new FoxFactoryApi(configuration);
+
+let newBuildTaskBody: NewBuildTaskBody; //
+
+const { status, data } = await apiInstance.newTaskFactoryPost(
+    newBuildTaskBody
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **newBuildTaskBody** | **NewBuildTaskBody**|  | |
+
+
+### Return type
+
+**boolean**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Successful Response |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **updateTaskFactoryTaskIdPatch**
+> boolean updateTaskFactoryTaskIdPatch(taskUpdateBody)
+
+Updates an existing build task by its unique identifier. The function allows updates to the task\'s status and logs. If the task\'s status is set to a value indicating completion, the finished timestamp is also updated.  Allowed only for foxworker users.
+
+### Example
+
+```typescript
+import {
+    FoxFactoryApi,
+    Configuration,
+    TaskUpdateBody
+} from '@orangefox-recovery/foxinternalclient';
+
+const configuration = new Configuration();
+const apiInstance = new FoxFactoryApi(configuration);
+
+let taskId: any; // (default to undefined)
+let taskUpdateBody: TaskUpdateBody; //
+
+const { status, data } = await apiInstance.updateTaskFactoryTaskIdPatch(
+    taskId,
+    taskUpdateBody
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **taskUpdateBody** | **TaskUpdateBody**|  | |
+| **taskId** | **any** |  | defaults to undefined|
+
+
+### Return type
+
+**boolean**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Successful Response |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+

package/docs/GitlabApi.md

@@ -0,0 +1,62 @@
+# GitlabApi
+
+All URIs are relative to *https://api.orangefox.download*
+
+|Method | HTTP request | Description|
+|------------- | ------------- | -------------|
+|[**deviceAddGitlabRepoGitlabDeviceDeviceIdGitlabPost**](#deviceaddgitlabrepogitlabdevicedeviceidgitlabpost) | **POST** /gitlab/device/{device_id}/gitlab | Device Add Gitlab Repo|
+
+# **deviceAddGitlabRepoGitlabDeviceDeviceIdGitlabPost**
+> boolean deviceAddGitlabRepoGitlabDeviceDeviceIdGitlabPost()
+
+
+### Example
+
+```typescript
+import {
+    GitlabApi,
+    Configuration
+} from '@orangefox-recovery/foxinternalclient';
+
+const configuration = new Configuration();
+const apiInstance = new GitlabApi(configuration);
+
+let deviceId: string; // (default to undefined)
+let glProjectUrl: string; // (default to undefined)
+
+const { status, data } = await apiInstance.deviceAddGitlabRepoGitlabDeviceDeviceIdGitlabPost(
+    deviceId,
+    glProjectUrl
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **deviceId** | [**string**] |  | defaults to undefined|
+| **glProjectUrl** | [**string**] |  | defaults to undefined|
+
+
+### Return type
+
+**boolean**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Successful Response |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+

package/docs/GlobalStatsAggregationModel.md

@@ -0,0 +1,26 @@
+# GlobalStatsAggregationModel
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**count** | **number** |  | [default to undefined]
+**deviceCount** | **number** |  | [default to undefined]
+**releaseCount** | **number** |  | [default to undefined]
+**days** | **{ [key: string]: number; }** |  | [default to undefined]
+
+## Example
+
+```typescript
+import { GlobalStatsAggregationModel } from '@orangefox-recovery/foxinternalclient';
+
+const instance: GlobalStatsAggregationModel = {
+    count,
+    deviceCount,
+    releaseCount,
+    days,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/HTTPValidationError.md

@@ -0,0 +1,20 @@
+# HTTPValidationError
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**detail** | [**Array<ValidationError>**](ValidationError.md) |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { HTTPValidationError } from '@orangefox-recovery/foxinternalclient';
+
+const instance: HTTPValidationError = {
+    detail,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)