cwmsjs/src/apis/TimeSeriesGroupsApi.ts

CWMS Data API Library for JavaScript/TypeScript created with OpenAPI generator for use with browser webapps

/* tslint:disable */
/* eslint-disable */
/**
 * CWMS Data API
 * CWMS REST API for Data Retrieval
 *
 * The version of the OpenAPI document: 2.4.0-2026.3.16
 * 
 *
 * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
 * https://openapi-generator.tech
 * Do not edit the class manually.
 */


import * as runtime from '../runtime';
import {
    CdaError,
    CdaErrorFromJSON,
    CdaErrorToJSON,
    TimeSeriesGroup,
    TimeSeriesGroupFromJSON,
    TimeSeriesGroupToJSON,
} from '../models';

export interface DeleteTimeSeriesGroupWithGroupIdRequest {
    groupId: string;
    categoryId: string;
    office: string;
}

export interface GetTimeSeriesGroupRequest {
    office?: string;
    includeAssigned?: boolean;
    timeseriesCategoryLike?: string;
    categoryOfficeId?: string;
    timeseriesGroupLike?: string;
}

export interface GetTimeSeriesGroupWithGroupIdRequest {
    groupId: string;
    office: string;
    categoryOfficeId: string;
    groupOfficeId: string;
    categoryId: string;
}

export interface PatchTimeSeriesGroupWithGroupIdRequest {
    groupId: string;
    office: string;
    timeSeriesGroup: TimeSeriesGroup;
    replaceAssignedTs?: boolean;
}

export interface PostTimeSeriesGroupRequest {
    timeSeriesGroup: TimeSeriesGroup;
    failIfExists?: boolean;
}

/**
 * 
 */
export class TimeSeriesGroupsApi extends runtime.BaseAPI {

    /**
     * Deletes requested time series group
     * Delete timeseries group with groupId
     */
    async deleteTimeSeriesGroupWithGroupIdRaw(requestParameters: DeleteTimeSeriesGroupWithGroupIdRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<void>> {
        if (requestParameters.groupId === null || requestParameters.groupId === undefined) {
            throw new runtime.RequiredError('groupId','Required parameter requestParameters.groupId was null or undefined when calling deleteTimeSeriesGroupWithGroupId.');
        }

        if (requestParameters.categoryId === null || requestParameters.categoryId === undefined) {
            throw new runtime.RequiredError('categoryId','Required parameter requestParameters.categoryId was null or undefined when calling deleteTimeSeriesGroupWithGroupId.');
        }

        if (requestParameters.office === null || requestParameters.office === undefined) {
            throw new runtime.RequiredError('office','Required parameter requestParameters.office was null or undefined when calling deleteTimeSeriesGroupWithGroupId.');
        }

        const queryParameters: any = {};

        if (requestParameters.categoryId !== undefined) {
            queryParameters['category-id'] = requestParameters.categoryId;
        }

        if (requestParameters.office !== undefined) {
            queryParameters['office'] = requestParameters.office;
        }

        const headerParameters: runtime.HTTPHeaders = {};

        if (this.configuration && this.configuration.apiKey) {
            headerParameters["Authorization"] = this.configuration.apiKey("Authorization"); // ApiKey authentication
        }

        const response = await this.request({
            path: `/timeseries/group/{group-id}`.replace(`{${"group-id"}}`, encodeURIComponent(String(requestParameters.groupId))),
            method: 'DELETE',
            headers: headerParameters,
            query: queryParameters,
        }, initOverrides);

        return new runtime.VoidApiResponse(response);
    }

    /**
     * Deletes requested time series group
     * Delete timeseries group with groupId
     */
    async deleteTimeSeriesGroupWithGroupId(requestParameters: DeleteTimeSeriesGroupWithGroupIdRequest, initOverrides?: RequestInit): Promise<void> {
        await this.deleteTimeSeriesGroupWithGroupIdRaw(requestParameters, initOverrides);
    }

    /**
     * Returns CWMS TimeSeries Groups Data
     * Get timeseries group
     */
    async getTimeSeriesGroupRaw(requestParameters: GetTimeSeriesGroupRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<Array<TimeSeriesGroup>>> {
        const queryParameters: any = {};

        if (requestParameters.office !== undefined) {
            queryParameters['office'] = requestParameters.office;
        }

        if (requestParameters.includeAssigned !== undefined) {
            queryParameters['include-assigned'] = requestParameters.includeAssigned;
        }

        if (requestParameters.timeseriesCategoryLike !== undefined) {
            queryParameters['timeseries-category-like'] = requestParameters.timeseriesCategoryLike;
        }

        if (requestParameters.categoryOfficeId !== undefined) {
            queryParameters['category-office-id'] = requestParameters.categoryOfficeId;
        }

        if (requestParameters.timeseriesGroupLike !== undefined) {
            queryParameters['timeseries-group-like'] = requestParameters.timeseriesGroupLike;
        }

        const headerParameters: runtime.HTTPHeaders = {};

        if (this.configuration && this.configuration.apiKey) {
            headerParameters["Authorization"] = this.configuration.apiKey("Authorization"); // ApiKey authentication
        }

        const response = await this.request({
            path: `/timeseries/group`,
            method: 'GET',
            headers: headerParameters,
            query: queryParameters,
        }, initOverrides);

        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(TimeSeriesGroupFromJSON));
    }

    /**
     * Returns CWMS TimeSeries Groups Data
     * Get timeseries group
     */
    async getTimeSeriesGroup(requestParameters: GetTimeSeriesGroupRequest = {}, initOverrides?: RequestInit): Promise<Array<TimeSeriesGroup>> {
        const response = await this.getTimeSeriesGroupRaw(requestParameters, initOverrides);
        return await response.value();
    }

    /**
     * Retrieves requested timeseries group
     * Get timeseries group with groupId
     */
    async getTimeSeriesGroupWithGroupIdRaw(requestParameters: GetTimeSeriesGroupWithGroupIdRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<TimeSeriesGroup>> {
        if (requestParameters.groupId === null || requestParameters.groupId === undefined) {
            throw new runtime.RequiredError('groupId','Required parameter requestParameters.groupId was null or undefined when calling getTimeSeriesGroupWithGroupId.');
        }

        if (requestParameters.office === null || requestParameters.office === undefined) {
            throw new runtime.RequiredError('office','Required parameter requestParameters.office was null or undefined when calling getTimeSeriesGroupWithGroupId.');
        }

        if (requestParameters.categoryOfficeId === null || requestParameters.categoryOfficeId === undefined) {
            throw new runtime.RequiredError('categoryOfficeId','Required parameter requestParameters.categoryOfficeId was null or undefined when calling getTimeSeriesGroupWithGroupId.');
        }

        if (requestParameters.groupOfficeId === null || requestParameters.groupOfficeId === undefined) {
            throw new runtime.RequiredError('groupOfficeId','Required parameter requestParameters.groupOfficeId was null or undefined when calling getTimeSeriesGroupWithGroupId.');
        }

        if (requestParameters.categoryId === null || requestParameters.categoryId === undefined) {
            throw new runtime.RequiredError('categoryId','Required parameter requestParameters.categoryId was null or undefined when calling getTimeSeriesGroupWithGroupId.');
        }

        const queryParameters: any = {};

        if (requestParameters.office !== undefined) {
            queryParameters['office'] = requestParameters.office;
        }

        if (requestParameters.categoryOfficeId !== undefined) {
            queryParameters['category-office-id'] = requestParameters.categoryOfficeId;
        }

        if (requestParameters.groupOfficeId !== undefined) {
            queryParameters['group-office-id'] = requestParameters.groupOfficeId;
        }

        if (requestParameters.categoryId !== undefined) {
            queryParameters['category-id'] = requestParameters.categoryId;
        }

        const headerParameters: runtime.HTTPHeaders = {};

        if (this.configuration && this.configuration.apiKey) {
            headerParameters["Authorization"] = this.configuration.apiKey("Authorization"); // ApiKey authentication
        }

        const response = await this.request({
            path: `/timeseries/group/{group-id}`.replace(`{${"group-id"}}`, encodeURIComponent(String(requestParameters.groupId))),
            method: 'GET',
            headers: headerParameters,
            query: queryParameters,
        }, initOverrides);

        return new runtime.JSONApiResponse(response, (jsonValue) => TimeSeriesGroupFromJSON(jsonValue));
    }

    /**
     * Retrieves requested timeseries group
     * Get timeseries group with groupId
     */
    async getTimeSeriesGroupWithGroupId(requestParameters: GetTimeSeriesGroupWithGroupIdRequest, initOverrides?: RequestInit): Promise<TimeSeriesGroup> {
        const response = await this.getTimeSeriesGroupWithGroupIdRaw(requestParameters, initOverrides);
        return await response.value();
    }

    /**
     * Update existing TimeSeriesGroup. Allows for renaming of the group, assigning new time series, and unassigning all time series from the group.
     * Patch timeseries group with groupId
     */
    async patchTimeSeriesGroupWithGroupIdRaw(requestParameters: PatchTimeSeriesGroupWithGroupIdRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<void>> {
        if (requestParameters.groupId === null || requestParameters.groupId === undefined) {
            throw new runtime.RequiredError('groupId','Required parameter requestParameters.groupId was null or undefined when calling patchTimeSeriesGroupWithGroupId.');
        }

        if (requestParameters.office === null || requestParameters.office === undefined) {
            throw new runtime.RequiredError('office','Required parameter requestParameters.office was null or undefined when calling patchTimeSeriesGroupWithGroupId.');
        }

        if (requestParameters.timeSeriesGroup === null || requestParameters.timeSeriesGroup === undefined) {
            throw new runtime.RequiredError('timeSeriesGroup','Required parameter requestParameters.timeSeriesGroup was null or undefined when calling patchTimeSeriesGroupWithGroupId.');
        }

        const queryParameters: any = {};

        if (requestParameters.replaceAssignedTs !== undefined) {
            queryParameters['replace-assigned-ts'] = requestParameters.replaceAssignedTs;
        }

        if (requestParameters.office !== undefined) {
            queryParameters['office'] = requestParameters.office;
        }

        const headerParameters: runtime.HTTPHeaders = {};

        headerParameters['Content-Type'] = 'application/json';

        if (this.configuration && this.configuration.apiKey) {
            headerParameters["Authorization"] = this.configuration.apiKey("Authorization"); // ApiKey authentication
        }

        const response = await this.request({
            path: `/timeseries/group/{group-id}`.replace(`{${"group-id"}}`, encodeURIComponent(String(requestParameters.groupId))),
            method: 'PATCH',
            headers: headerParameters,
            query: queryParameters,
            body: TimeSeriesGroupToJSON(requestParameters.timeSeriesGroup),
        }, initOverrides);

        return new runtime.VoidApiResponse(response);
    }

    /**
     * Update existing TimeSeriesGroup. Allows for renaming of the group, assigning new time series, and unassigning all time series from the group.
     * Patch timeseries group with groupId
     */
    async patchTimeSeriesGroupWithGroupId(requestParameters: PatchTimeSeriesGroupWithGroupIdRequest, initOverrides?: RequestInit): Promise<void> {
        await this.patchTimeSeriesGroupWithGroupIdRaw(requestParameters, initOverrides);
    }

    /**
     * Create new TimeSeriesGroup
     * Post timeseries group
     */
    async postTimeSeriesGroupRaw(requestParameters: PostTimeSeriesGroupRequest, initOverrides?: RequestInit): Promise<runtime.ApiResponse<void>> {
        if (requestParameters.timeSeriesGroup === null || requestParameters.timeSeriesGroup === undefined) {
            throw new runtime.RequiredError('timeSeriesGroup','Required parameter requestParameters.timeSeriesGroup was null or undefined when calling postTimeSeriesGroup.');
        }

        const queryParameters: any = {};

        if (requestParameters.failIfExists !== undefined) {
            queryParameters['fail-if-exists'] = requestParameters.failIfExists;
        }

        const headerParameters: runtime.HTTPHeaders = {};

        headerParameters['Content-Type'] = 'application/json';

        if (this.configuration && this.configuration.apiKey) {
            headerParameters["Authorization"] = this.configuration.apiKey("Authorization"); // ApiKey authentication
        }

        const response = await this.request({
            path: `/timeseries/group`,
            method: 'POST',
            headers: headerParameters,
            query: queryParameters,
            body: TimeSeriesGroupToJSON(requestParameters.timeSeriesGroup),
        }, initOverrides);

        return new runtime.VoidApiResponse(response);
    }

    /**
     * Create new TimeSeriesGroup
     * Post timeseries group
     */
    async postTimeSeriesGroup(requestParameters: PostTimeSeriesGroupRequest, initOverrides?: RequestInit): Promise<void> {
        await this.postTimeSeriesGroupRaw(requestParameters, initOverrides);
    }

}