@cascateer/sterio 1.0.1

package/src/api/models/SterioAlbumSongs.ts

@@ -0,0 +1,38 @@
+// tslint:disable
+/**
+ * @cascateer/sterio
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import type {
+    SterioAlbumSongsVideoIdsInner,
+} from './';
+
+/**
+ * @export
+ * @interface SterioAlbumSongs
+ */
+export interface SterioAlbumSongs {
+    /**
+     * @type {Array<number>}
+     * @memberof SterioAlbumSongs
+     */
+    exclude?: Array<number>;
+    /**
+     * @type {Array<number>}
+     * @memberof SterioAlbumSongs
+     */
+    include?: Array<number>;
+    /**
+     * @type {Array<SterioAlbumSongsVideoIdsInner>}
+     * @memberof SterioAlbumSongs
+     */
+    videoIds?: Array<SterioAlbumSongsVideoIdsInner>;
+}

package/src/api/models/SterioAlbumSongsVideoIdsInner.ts

@@ -0,0 +1,34 @@
+// tslint:disable
+/**
+ * @cascateer/sterio
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * @export
+ * @interface SterioAlbumSongsVideoIdsInner
+ */
+export interface SterioAlbumSongsVideoIdsInner {
+    /**
+     * @type {string}
+     * @memberof SterioAlbumSongsVideoIdsInner
+     */
+    newValue: string;
+    /**
+     * @type {string}
+     * @memberof SterioAlbumSongsVideoIdsInner
+     */
+    expectedValue: string;
+    /**
+     * @type {number}
+     * @memberof SterioAlbumSongsVideoIdsInner
+     */
+    index: number;
+}

package/src/api/models/YoutubePlaylist.ts

@@ -0,0 +1,38 @@
+// tslint:disable
+/**
+ * @cascateer/sterio
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import type {
+    YoutubeV3Schema36PlaylistItem,
+} from './';
+
+/**
+ * @export
+ * @interface YoutubePlaylist
+ */
+export interface YoutubePlaylist {
+    /**
+     * @type {string}
+     * @memberof YoutubePlaylist
+     */
+    id: string;
+    /**
+     * @type {string}
+     * @memberof YoutubePlaylist
+     */
+    title?: string;
+    /**
+     * @type {Array<YoutubeV3Schema36PlaylistItem>}
+     * @memberof YoutubePlaylist
+     */
+    items: Array<YoutubeV3Schema36PlaylistItem>;
+}

package/src/api/models/YoutubeV3Schema36PlaylistItem.ts

@@ -0,0 +1,59 @@
+// tslint:disable
+/**
+ * @cascateer/sterio
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import type {
+    YoutubeV3Schema36PlaylistItemContentDetails,
+    YoutubeV3Schema36PlaylistItemSnippet,
+    YoutubeV3Schema36PlaylistItemStatus,
+} from './';
+
+/**
+ * A *playlistItem* resource identifies another resource, such as a video, that is included in a playlist. In addition, the playlistItem resource contains details about the included resource that pertain specifically to how that resource is used in that playlist. YouTube uses playlists to identify special collections of videos for a channel, such as: - uploaded videos - favorite videos - positively rated (liked) videos - watch history - watch later To be more specific, these lists are associated with a channel, which is a collection of a person, group, or company\'s videos, playlists, and other YouTube information. You can retrieve the playlist IDs for each of these lists from the channel resource for a given channel. You can then use the playlistItems.list method to retrieve any of those lists. You can also add or remove items from those lists by calling the playlistItems.insert and playlistItems.delete methods. For example, if a user gives a positive rating to a video, you would insert that video into the liked videos playlist for that user\'s channel.
+ * @export
+ * @interface YoutubeV3Schema36PlaylistItem
+ */
+export interface YoutubeV3Schema36PlaylistItem {
+    /**
+     * @type {YoutubeV3Schema36PlaylistItemContentDetails}
+     * @memberof YoutubeV3Schema36PlaylistItem
+     */
+    contentDetails?: YoutubeV3Schema36PlaylistItemContentDetails;
+    /**
+     * Etag of this resource.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItem
+     */
+    etag?: string | null;
+    /**
+     * The ID that YouTube uses to uniquely identify the playlist item.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItem
+     */
+    id?: string | null;
+    /**
+     * Identifies what kind of resource this is. Value: the fixed string \"youtube#playlistItem\".
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItem
+     */
+    kind?: string | null;
+    /**
+     * @type {YoutubeV3Schema36PlaylistItemSnippet}
+     * @memberof YoutubeV3Schema36PlaylistItem
+     */
+    snippet?: YoutubeV3Schema36PlaylistItemSnippet;
+    /**
+     * @type {YoutubeV3Schema36PlaylistItemStatus}
+     * @memberof YoutubeV3Schema36PlaylistItem
+     */
+    status?: YoutubeV3Schema36PlaylistItemStatus;
+}

package/src/api/models/YoutubeV3Schema36PlaylistItemContentDetails.ts

@@ -0,0 +1,49 @@
+// tslint:disable
+/**
+ * @cascateer/sterio
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * @export
+ * @interface YoutubeV3Schema36PlaylistItemContentDetails
+ */
+export interface YoutubeV3Schema36PlaylistItemContentDetails {
+    /**
+     * The time, measured in seconds from the start of the video, when the video should stop playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) By default, assume that the video.endTime is the end of the video.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemContentDetails
+     */
+    endAt?: string | null;
+    /**
+     * A user-generated note for this item.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemContentDetails
+     */
+    note?: string | null;
+    /**
+     * The time, measured in seconds from the start of the video, when the video should start playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) The default value is 0.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemContentDetails
+     */
+    startAt?: string | null;
+    /**
+     * The ID that YouTube uses to uniquely identify a video. To retrieve the video resource, set the id query parameter to this value in your API request.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemContentDetails
+     */
+    videoId?: string | null;
+    /**
+     * The date and time that the video was published to YouTube.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemContentDetails
+     */
+    videoPublishedAt?: string | null;
+}

package/src/api/models/YoutubeV3Schema36PlaylistItemSnippet.ts

@@ -0,0 +1,89 @@
+// tslint:disable
+/**
+ * @cascateer/sterio
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import type {
+    YoutubeV3Schema36ResourceId,
+    YoutubeV3Schema36ThumbnailDetails,
+} from './';
+
+/**
+ * Basic details about a playlist, including title, description and thumbnails. Basic details of a YouTube Playlist item provided by the author. Next ID: 15
+ * @export
+ * @interface YoutubeV3Schema36PlaylistItemSnippet
+ */
+export interface YoutubeV3Schema36PlaylistItemSnippet {
+    /**
+     * The ID that YouTube uses to uniquely identify the user that added the item to the playlist.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemSnippet
+     */
+    channelId?: string | null;
+    /**
+     * Channel title for the channel that the playlist item belongs to.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemSnippet
+     */
+    channelTitle?: string | null;
+    /**
+     * The item\'s description.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemSnippet
+     */
+    description?: string | null;
+    /**
+     * The ID that YouTube uses to uniquely identify thGe playlist that the playlist item is in.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemSnippet
+     */
+    playlistId?: string | null;
+    /**
+     * The order in which the item appears in the playlist. The value uses a zero-based index, so the first item has a position of 0, the second item has a position of 1, and so forth.
+     * @type {number}
+     * @memberof YoutubeV3Schema36PlaylistItemSnippet
+     */
+    position?: number | null;
+    /**
+     * The date and time that the item was added to the playlist.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemSnippet
+     */
+    publishedAt?: string | null;
+    /**
+     * @type {YoutubeV3Schema36ResourceId}
+     * @memberof YoutubeV3Schema36PlaylistItemSnippet
+     */
+    resourceId?: YoutubeV3Schema36ResourceId;
+    /**
+     * @type {YoutubeV3Schema36ThumbnailDetails}
+     * @memberof YoutubeV3Schema36PlaylistItemSnippet
+     */
+    thumbnails?: YoutubeV3Schema36ThumbnailDetails;
+    /**
+     * The item\'s title.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemSnippet
+     */
+    title?: string | null;
+    /**
+     * Channel id for the channel this video belongs to.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemSnippet
+     */
+    videoOwnerChannelId?: string | null;
+    /**
+     * Channel title for the channel this video belongs to.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemSnippet
+     */
+    videoOwnerChannelTitle?: string | null;
+}

package/src/api/models/YoutubeV3Schema36PlaylistItemStatus.ts

@@ -0,0 +1,26 @@
+// tslint:disable
+/**
+ * @cascateer/sterio
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Information about the playlist item\'s privacy status.
+ * @export
+ * @interface YoutubeV3Schema36PlaylistItemStatus
+ */
+export interface YoutubeV3Schema36PlaylistItemStatus {
+    /**
+     * This resource\'s privacy status.
+     * @type {string}
+     * @memberof YoutubeV3Schema36PlaylistItemStatus
+     */
+    privacyStatus?: string | null;
+}

package/src/api/models/YoutubeV3Schema36ResourceId.ts

@@ -0,0 +1,44 @@
+// tslint:disable
+/**
+ * @cascateer/sterio
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * A resource id is a generic reference that points to another YouTube resource.
+ * @export
+ * @interface YoutubeV3Schema36ResourceId
+ */
+export interface YoutubeV3Schema36ResourceId {
+    /**
+     * The ID that YouTube uses to uniquely identify the referred resource, if that resource is a channel. This property is only present if the resourceId.kind value is youtube#channel.
+     * @type {string}
+     * @memberof YoutubeV3Schema36ResourceId
+     */
+    channelId?: string | null;
+    /**
+     * The type of the API resource.
+     * @type {string}
+     * @memberof YoutubeV3Schema36ResourceId
+     */
+    kind?: string | null;
+    /**
+     * The ID that YouTube uses to uniquely identify the referred resource, if that resource is a playlist. This property is only present if the resourceId.kind value is youtube#playlist.
+     * @type {string}
+     * @memberof YoutubeV3Schema36ResourceId
+     */
+    playlistId?: string | null;
+    /**
+     * The ID that YouTube uses to uniquely identify the referred resource, if that resource is a video. This property is only present if the resourceId.kind value is youtube#video.
+     * @type {string}
+     * @memberof YoutubeV3Schema36ResourceId
+     */
+    videoId?: string | null;
+}

package/src/api/models/YoutubeV3Schema36Thumbnail.ts

@@ -0,0 +1,38 @@
+// tslint:disable
+/**
+ * @cascateer/sterio
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * A thumbnail is an image representing a YouTube resource.
+ * @export
+ * @interface YoutubeV3Schema36Thumbnail
+ */
+export interface YoutubeV3Schema36Thumbnail {
+    /**
+     * (Optional) Height of the thumbnail image.
+     * @type {number}
+     * @memberof YoutubeV3Schema36Thumbnail
+     */
+    height?: number | null;
+    /**
+     * The thumbnail image\'s URL.
+     * @type {string}
+     * @memberof YoutubeV3Schema36Thumbnail
+     */
+    url?: string | null;
+    /**
+     * (Optional) Width of the thumbnail image.
+     * @type {number}
+     * @memberof YoutubeV3Schema36Thumbnail
+     */
+    width?: number | null;
+}

package/src/api/models/YoutubeV3Schema36ThumbnailDetails.ts

@@ -0,0 +1,49 @@
+// tslint:disable
+/**
+ * @cascateer/sterio
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import type {
+    YoutubeV3Schema36Thumbnail,
+} from './';
+
+/**
+ * Internal representation of thumbnails for a YouTube resource.
+ * @export
+ * @interface YoutubeV3Schema36ThumbnailDetails
+ */
+export interface YoutubeV3Schema36ThumbnailDetails {
+    /**
+     * @type {YoutubeV3Schema36Thumbnail}
+     * @memberof YoutubeV3Schema36ThumbnailDetails
+     */
+    _default?: YoutubeV3Schema36Thumbnail;
+    /**
+     * @type {YoutubeV3Schema36Thumbnail}
+     * @memberof YoutubeV3Schema36ThumbnailDetails
+     */
+    high?: YoutubeV3Schema36Thumbnail;
+    /**
+     * @type {YoutubeV3Schema36Thumbnail}
+     * @memberof YoutubeV3Schema36ThumbnailDetails
+     */
+    maxres?: YoutubeV3Schema36Thumbnail;
+    /**
+     * @type {YoutubeV3Schema36Thumbnail}
+     * @memberof YoutubeV3Schema36ThumbnailDetails
+     */
+    medium?: YoutubeV3Schema36Thumbnail;
+    /**
+     * @type {YoutubeV3Schema36Thumbnail}
+     * @memberof YoutubeV3Schema36ThumbnailDetails
+     */
+    standard?: YoutubeV3Schema36Thumbnail;
+}

package/src/api/models/index.ts

@@ -0,0 +1,20 @@
+export * from './GetYoutubeMusicAlbums200ResponseInner';
+export * from './PartialSterioAlbumResourcesFull';
+export * from './SpotifyApiAlbumObjectSimplified';
+export * from './SpotifyApiArtistObjectSimplified';
+export * from './SpotifyApiExternalUrlObject';
+export * from './SpotifyApiImageObject';
+export * from './SpotifyApiRestrictionsObject';
+export * from './SterioAlbum';
+export * from './SterioAlbumResource';
+export * from './SterioAlbumResourcesTable';
+export * from './SterioAlbumSongs';
+export * from './SterioAlbumSongsVideoIdsInner';
+export * from './YoutubePlaylist';
+export * from './YoutubeV3Schema36PlaylistItem';
+export * from './YoutubeV3Schema36PlaylistItemContentDetails';
+export * from './YoutubeV3Schema36PlaylistItemSnippet';
+export * from './YoutubeV3Schema36PlaylistItemStatus';
+export * from './YoutubeV3Schema36ResourceId';
+export * from './YoutubeV3Schema36Thumbnail';
+export * from './YoutubeV3Schema36ThumbnailDetails';

package/src/api/runtime.ts

@@ -0,0 +1,193 @@
+// tslint:disable
+/**
+ * @cascateer/sterio
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { of } from 'rxjs';
+import type { Observable } from 'rxjs';
+import { ajax } from 'rxjs/ajax';
+import type { AjaxConfig, AjaxResponse } from 'rxjs/ajax';
+import { map, concatMap } from 'rxjs/operators';
+import { servers } from './servers';
+
+export const BASE_PATH = servers[0].getUrl();
+
+export interface ConfigurationParameters {
+    basePath?: string; // override base path
+    middleware?: Middleware[]; // middleware to apply before/after rxjs requests
+    username?: string; // parameter for basic security
+    password?: string; // parameter for basic security
+    apiKey?: string | ((name: string) => string); // parameter for apiKey security
+    accessToken?: string | ((name?: string, scopes?: string[]) => string); // parameter for oauth2 security
+}
+
+export class Configuration {
+    constructor(private configuration: ConfigurationParameters = {}) {}
+
+    get basePath(): string {
+        return this.configuration.basePath ?? BASE_PATH;
+    }
+
+    get middleware(): Middleware[] {
+        return this.configuration.middleware ?? [];
+    }
+
+    get username(): string | undefined {
+        return this.configuration.username;
+    }
+
+    get password(): string | undefined {
+        return this.configuration.password;
+    }
+
+    get apiKey(): ((name: string) => string) | undefined {
+        const { apiKey } = this.configuration;
+        return apiKey ? (typeof apiKey === 'string' ? () => apiKey : apiKey) : undefined;
+    }
+
+    get accessToken(): ((name: string, scopes?: string[]) => string) | undefined {
+        const { accessToken } = this.configuration;
+        return accessToken ? (typeof accessToken === 'string' ? () => accessToken : accessToken) : undefined;
+    }
+}
+
+/**
+ * This is the base class for all generated API classes.
+ */
+export class BaseAPI {
+    private middleware: Middleware[] = [];
+
+    constructor(protected configuration = new Configuration()) {
+        this.middleware = configuration.middleware;
+    }
+
+    withMiddleware = (middlewares: Middleware[]): this => {
+        const next = this.clone();
+        next.middleware = next.middleware.concat(middlewares);
+        return next;
+    };
+
+    withPreMiddleware = (preMiddlewares: Array<Middleware['pre']>) =>
+        this.withMiddleware(preMiddlewares.map((pre) => ({ pre })));
+
+    withPostMiddleware = (postMiddlewares: Array<Middleware['post']>) =>
+        this.withMiddleware(postMiddlewares.map((post) => ({ post })));
+
+    protected request<T>(requestOpts: RequestOpts): Observable<T>
+    protected request<T>(requestOpts: RequestOpts, responseOpts?: ResponseOpts): Observable<AjaxResponse<T>>
+    protected request<T>(requestOpts: RequestOpts, responseOpts?: ResponseOpts): Observable<T | AjaxResponse<T>> {
+        return this.rxjsRequest<T>(this.createRequestArgs(requestOpts)).pipe(
+            map((res) => {
+                const { status, response } = res;
+                if (status >= 200 && status < 300) {
+                    return responseOpts?.response === 'raw' ? res : response;
+                }
+                throw res;
+            })
+        );
+    }
+
+    private createRequestArgs = ({ url: baseUrl, query, method, headers, body, responseType }: RequestOpts): AjaxConfig => {
+        // only add the queryString to the URL if there are query parameters.
+        // this is done to avoid urls ending with a '?' character which buggy webservers
+        // do not handle correctly sometimes.
+        const url = `${this.configuration.basePath}${baseUrl}${query && Object.keys(query).length ? `?${queryString(query)}`: ''}`;
+
+        return {
+            url,
+            method,
+            headers,
+            body: body instanceof FormData ? body : JSON.stringify(body),
+            responseType: responseType ?? 'json',
+        };
+    }
+
+    private rxjsRequest = <T>(params: AjaxConfig): Observable<AjaxResponse<T>> =>
+        of(params).pipe(
+            map((request) => {
+                this.middleware.filter((item) => item.pre).forEach((mw) => (request = mw.pre!(request)));
+                return request;
+            }),
+            concatMap((args) =>
+                ajax<T>(args).pipe(
+                    map((response) => {
+                        this.middleware.filter((item) => item.post).forEach((mw) => (response = mw.post!(response)));
+                        return response;
+                    })
+                )
+            )
+        );
+
+    /**
+     * Create a shallow clone of `this` by constructing a new instance
+     * and then shallow cloning data members.
+     */
+    private clone = (): this =>
+        Object.assign(Object.create(Object.getPrototypeOf(this)), this);
+}
+
+/**
+ * @deprecated
+ * export for not being a breaking change
+ */
+export class RequiredError extends Error {
+    override name: 'RequiredError' = 'RequiredError';
+}
+
+export const COLLECTION_FORMATS = {
+    csv: ',',
+    ssv: ' ',
+    tsv: '\t',
+    pipes: '|',
+};
+
+export type Json = any;
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+export type HttpHeaders = { [key: string]: string };
+export type HttpQuery = Partial<{ [key: string]: string | number | null | boolean | Array<string | number | null | boolean> }>; // partial is needed for strict mode
+export type HttpBody = Json | FormData;
+
+export interface RequestOpts extends AjaxConfig {
+    // TODO: replace custom 'query' prop with 'queryParams'
+    query?: HttpQuery; // additional prop
+    // the following props have improved types over AjaxRequest
+    method: HttpMethod;
+    headers?: HttpHeaders;
+    body?: HttpBody;
+}
+
+export interface ResponseOpts {
+    response?: 'raw';
+}
+
+export interface OperationOpts {
+    responseOpts?: ResponseOpts;
+}
+
+export const encodeURI = (value: any) => encodeURIComponent(`${value}`);
+
+const queryString = (params: HttpQuery): string => Object.entries(params)
+    .map(([key, value]) => value instanceof Array
+        ? value.map((val) => `${encodeURI(key)}=${encodeURI(val)}`).join('&')
+        : `${encodeURI(key)}=${encodeURI(value)}`
+    )
+    .join('&');
+
+export const throwIfNullOrUndefined = (value: any, paramName: string, nickname: string) => {
+    if (value == null) {
+        throw new Error(`Parameter "${paramName}" was null or undefined when calling "${nickname}".`);
+    }
+};
+
+export interface Middleware {
+    pre?(request: AjaxConfig): AjaxConfig;
+    post?(response: AjaxResponse<any>): AjaxResponse<any>;
+}