assemblyai 3.0.0 → 3.0.1

package/dist/index.js

@@ -1,26 +1,9 @@
 'use strict';
 
-var axios = require('axios');
 var WebSocket = require('ws');
-var stream = require('stream');
+var Stream = require('stream');
 var fs = require('fs');
 
-function createAxiosClient(params) {
-    const client = axios.create({
-        baseURL: params.baseUrl,
-        headers: { Authorization: params.apiKey },
-    });
-    client.interceptors.response.use(undefined, throwApiError);
-    return client;
-}
-function throwApiError(error) {
-    var _a, _b;
-    if (axios.isAxiosError(error) && ((_b = (_a = error.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.error)) {
-        return Promise.reject(new Error(error.response.data.error));
-    }
-    return Promise.reject(error);
-}
-
 /******************************************************************************
 Copyright (c) Microsoft Corporation.
 
@@ -59,36 +42,70 @@ typeof SuppressedError === "function" ? SuppressedError : function (error, suppr
 class BaseService {
     /**
      * Create a new service.
-     * @param params The AxiosInstance to send HTTP requests to the API.
+     * @param params The parameters to use for the service.
      */
-    constructor(client) {
-        this.client = client;
+    constructor(params) {
+        this.params = params;
+    }
+    fetch(input, init) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            init = init !== null && init !== void 0 ? init : {};
+            init.headers = (_a = init.headers) !== null && _a !== void 0 ? _a : {};
+            init.headers = Object.assign({ Authorization: this.params.apiKey, "Content-Type": "application/json" }, init.headers);
+            if (!input.startsWith("http"))
+                input = this.params.baseUrl + input;
+            const response = yield fetch(input, init);
+            if (response.status >= 400) {
+                let json;
+                const text = yield response.text();
+                if (text) {
+                    try {
+                        json = JSON.parse(text);
+                    }
+                    catch (_b) {
+                        /* empty */
+                    }
+                    if (json === null || json === void 0 ? void 0 : json.error)
+                        throw new Error(json.error);
+                    throw new Error(text);
+                }
+                throw new Error(`HTTP Error: ${response.status} ${response.statusText}`);
+            }
+            return response;
+        });
+    }
+    fetchJson(input, init) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.fetch(input, init);
+            return response.json();
+        });
     }
 }
 
 class LemurService extends BaseService {
     summary(params) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { data } = yield this.client.post("/lemur/v3/generate/summary", params);
-            return data;
+        return this.fetchJson("/lemur/v3/generate/summary", {
+            method: "POST",
+            body: JSON.stringify(params),
         });
     }
     questionAnswer(params) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { data } = yield this.client.post("/lemur/v3/generate/question-answer", params);
-            return data;
+        return this.fetchJson("/lemur/v3/generate/question-answer", {
+            method: "POST",
+            body: JSON.stringify(params),
         });
     }
     actionItems(params) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { data } = yield this.client.post("/lemur/v3/generate/action-items", params);
-            return data;
+        return this.fetchJson("/lemur/v3/generate/action-items", {
+            method: "POST",
+            body: JSON.stringify(params),
         });
     }
     task(params) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { data } = yield this.client.post("/lemur/v3/generate/task", params);
-            return data;
+        return this.fetchJson("/lemur/v3/generate/task", {
+            method: "POST",
+            body: JSON.stringify(params),
         });
     }
     /**
@@ -96,9 +113,8 @@ class LemurService extends BaseService {
      * @param id ID of the LeMUR request
      */
     purgeRequestData(id) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { data } = yield this.client.delete(`/lemur/v3/${id}`);
-            return data;
+        return this.fetchJson(`/lemur/v3/${id}`, {
+            method: "DELETE",
         });
     }
 }
@@ -147,12 +163,11 @@ class RealtimeError extends Error {
 const defaultRealtimeUrl = "wss://api.assemblyai.com/v2/realtime/ws";
 class RealtimeService {
     constructor(params) {
-        var _a, _b, _c;
+        var _a, _b;
         this.listeners = {};
         this.realtimeUrl = (_a = params.realtimeUrl) !== null && _a !== void 0 ? _a : defaultRealtimeUrl;
         this.sampleRate = (_b = params.sampleRate) !== null && _b !== void 0 ? _b : 16000;
         this.wordBoost = params.wordBoost;
-        this.realtimeUrl = (_c = params.realtimeUrl) !== null && _c !== void 0 ? _c : defaultRealtimeUrl;
         if ("apiKey" in params)
             this.apiKey = params.apiKey;
         if ("token" in params)
@@ -260,13 +275,13 @@ class RealtimeService {
         this.socket.send(JSON.stringify(payload));
     }
     stream() {
-        const stream$1 = new stream.Writable({
+        const stream = new Stream.Writable({
             write: (chunk, encoding, next) => {
                 this.sendAudio(chunk);
                 next();
             },
         });
-        return stream$1;
+        return stream;
     }
     close(waitForSessionTermination = true) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -293,30 +308,33 @@ class RealtimeService {
     }
 }
 
-class RealtimeServiceFactory {
-    constructor(client, params) {
-        this.client = client;
-        this.params = params;
+class RealtimeServiceFactory extends BaseService {
+    constructor(params) {
+        super(params);
+        this.rtFactoryParams = params;
     }
     createService(params) {
         if (!params)
-            params = { apiKey: this.params.apiKey };
+            params = { apiKey: this.rtFactoryParams.apiKey };
         else if (!("token" in params) && !params.apiKey) {
-            params.apiKey = this.params.apiKey;
+            params.apiKey = this.rtFactoryParams.apiKey;
         }
         return new RealtimeService(params);
     }
     createTemporaryToken(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.client.post("/v2/realtime/token", params);
-            return response.data.token;
+            const data = yield this.fetchJson("/v2/realtime/token", {
+                method: "POST",
+                body: JSON.stringify(params),
+            });
+            return data.token;
         });
     }
 }
 
 class TranscriptService extends BaseService {
-    constructor(client, files) {
-        super(client);
+    constructor(params, files) {
+        super(params);
         this.files = files;
     }
     /**
@@ -333,11 +351,14 @@ class TranscriptService extends BaseService {
                 const uploadUrl = yield this.files.upload(path);
                 params.audio_url = uploadUrl;
             }
-            const res = yield this.client.post("/v2/transcript", params);
+            const data = yield this.fetchJson("/v2/transcript", {
+                method: "POST",
+                body: JSON.stringify(params),
+            });
             if ((_a = options === null || options === void 0 ? void 0 : options.poll) !== null && _a !== void 0 ? _a : true) {
-                return yield this.poll(res.data.id, options);
+                return yield this.poll(data.id, options);
             }
-            return res.data;
+            return data;
         });
     }
     poll(transcriptId, options) {
@@ -366,10 +387,7 @@ class TranscriptService extends BaseService {
      * @returns A promise that resolves to the transcript.
      */
     get(id) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const res = yield this.client.get(`/v2/transcript/${id}`);
-            return res.data;
-        });
+        return this.fetchJson(`/v2/transcript/${id}`);
     }
     /**
      * Retrieves a page of transcript listings.
@@ -378,16 +396,19 @@ class TranscriptService extends BaseService {
     list(parameters) {
         return __awaiter(this, void 0, void 0, function* () {
             let url = "/v2/transcript";
-            let query;
             if (typeof parameters === "string") {
                 url = parameters;
             }
             else if (parameters) {
-                query = parameters;
+                url = `${url}?${new URLSearchParams(Object.keys(parameters).map((key) => {
+                    var _a;
+                    return [
+                        key,
+                        ((_a = parameters[key]) === null || _a === void 0 ? void 0 : _a.toString()) || "",
+                    ];
+                }))}`;
             }
-            const { data } = yield this.client.get(url, {
-                params: query,
-            });
+            const data = yield this.fetchJson(url);
             for (const transcriptListItem of data.transcripts) {
                 transcriptListItem.created = new Date(transcriptListItem.created);
                 if (transcriptListItem.completed) {
@@ -403,27 +424,17 @@ class TranscriptService extends BaseService {
      * @returns A promise that resolves to the transcript.
      */
     delete(id) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const res = yield this.client.delete(`/v2/transcript/${id}`);
-            return res.data;
-        });
+        return this.fetchJson(`/v2/transcript/${id}`, { method: "DELETE" });
     }
     /**
      * Search through the transcript for a specific set of keywords.
      * You can search for individual words, numbers, or phrases containing up to five words or numbers.
      * @param id The identifier of the transcript.
-     * @param id Keywords to search for.
+     * @param words Keywords to search for.
      * @return A promise that resolves to the sentences.
      */
     wordSearch(id, words) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { data } = yield this.client.get(`/v2/transcript/${id}/word-search`, {
-                params: {
-                    words: JSON.stringify(words),
-                },
-            });
-            return data;
-        });
+        return this.fetchJson(`/v2/transcript/${id}/word-search?words=${JSON.stringify(words)}`);
     }
     /**
      * Retrieve all sentences of a transcript.
@@ -431,10 +442,7 @@ class TranscriptService extends BaseService {
      * @return A promise that resolves to the sentences.
      */
     sentences(id) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { data } = yield this.client.get(`/v2/transcript/${id}/sentences`);
-            return data;
-        });
+        return this.fetchJson(`/v2/transcript/${id}/sentences`);
     }
     /**
      * Retrieve all paragraphs of a transcript.
@@ -442,10 +450,7 @@ class TranscriptService extends BaseService {
      * @return A promise that resolves to the paragraphs.
      */
     paragraphs(id) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { data } = yield this.client.get(`/v2/transcript/${id}/paragraphs`);
-            return data;
-        });
+        return this.fetchJson(`/v2/transcript/${id}/paragraphs`);
     }
     /**
      * Retrieve subtitles of a transcript.
@@ -455,8 +460,8 @@ class TranscriptService extends BaseService {
      */
     subtitles(id, format = "srt") {
         return __awaiter(this, void 0, void 0, function* () {
-            const { data } = yield this.client.get(`/v2/transcript/${id}/${format}`);
-            return data;
+            const response = yield this.fetch(`/v2/transcript/${id}/${format}`);
+            return yield response.text();
         });
     }
     /**
@@ -465,10 +470,7 @@ class TranscriptService extends BaseService {
      * @return A promise that resolves to the subtitles text.
      */
     redactions(id) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { data } = yield this.client.get(`/v2/transcript/${id}/redacted-audio`);
-            return data;
-        });
+        return this.fetchJson(`/v2/transcript/${id}/redacted-audio`);
     }
 }
 function getPath(path) {
@@ -498,28 +500,33 @@ class FileService extends BaseService {
                 fileData = fs.createReadStream(input);
             else
                 fileData = input;
-            const { data } = yield this.client.post("/v2/upload", fileData, {
+            const data = yield this.fetchJson("/v2/upload", {
+                method: "POST",
+                body: fileData,
                 headers: {
                     "Content-Type": "application/octet-stream",
                 },
+                duplex: "half",
             });
             return data.upload_url;
         });
     }
 }
 
+const defaultBaseUrl = "https://api.assemblyai.com";
 class AssemblyAI {
     /**
      * Create a new AssemblyAI client.
      * @param params The parameters for the service, including the API key and base URL, if any.
      */
     constructor(params) {
-        params.baseUrl = params.baseUrl || "https://api.assemblyai.com";
-        const client = createAxiosClient(params);
-        this.files = new FileService(client);
-        this.transcripts = new TranscriptService(client, this.files);
-        this.lemur = new LemurService(client);
-        this.realtime = new RealtimeServiceFactory(client, params);
+        params.baseUrl = params.baseUrl || defaultBaseUrl;
+        if (params.baseUrl && params.baseUrl.endsWith("/"))
+            params.baseUrl = params.baseUrl.slice(0, -1);
+        this.files = new FileService(params);
+        this.transcripts = new TranscriptService(params, this.files);
+        this.lemur = new LemurService(params);
+        this.realtime = new RealtimeServiceFactory(params);
     }
 }
 

package/dist/services/base.d.ts

@@ -1,12 +1,14 @@
-import { AxiosInstance } from "axios";
+import { BaseServiceParams } from "..";
 /**
  * Base class for services that communicate with the API.
  */
 export declare abstract class BaseService {
-    protected client: AxiosInstance;
+    private params;
     /**
      * Create a new service.
-     * @param params The AxiosInstance to send HTTP requests to the API.
+     * @param params The parameters to use for the service.
      */
-    constructor(client: AxiosInstance);
+    constructor(params: BaseServiceParams);
+    protected fetch(input: string, init?: RequestInit | undefined): Promise<Response>;
+    protected fetchJson<T>(input: string, init?: RequestInit | undefined): Promise<T>;
 }

package/dist/services/files/index.d.ts

@@ -1,5 +1,5 @@
-import { BaseService } from "@/services/base";
-import { FileUploadParameters } from "@/types";
+import { BaseService } from "../base";
+import { FileUploadParameters } from "../..";
 export declare class FileService extends BaseService {
     /**
      * Upload a local file to AssemblyAI.

package/dist/services/index.d.ts

@@ -1,4 +1,4 @@
-import { BaseServiceParams } from "@/types";
+import { BaseServiceParams } from "..";
 import { LemurService } from "./lemur";
 import { RealtimeService, RealtimeServiceFactory } from "./realtime";
 import { TranscriptService } from "./transcripts";

package/dist/services/lemur/index.d.ts

@@ -1,5 +1,5 @@
-import { LemurSummaryParameters, LemurActionItemsParameters, LemurQuestionAnswerParameters, LemurTaskParameters, LemurSummaryResponse, LemurQuestionAnswerResponse, LemurActionItemsResponse, LemurTaskResponse, PurgeLemurRequestDataResponse } from "@/types";
-import { BaseService } from "@/services/base";
+import { LemurSummaryParameters, LemurActionItemsParameters, LemurQuestionAnswerParameters, LemurTaskParameters, LemurSummaryResponse, LemurQuestionAnswerResponse, LemurActionItemsResponse, LemurTaskResponse, PurgeLemurRequestDataResponse } from "../..";
+import { BaseService } from "../base";
 export declare class LemurService extends BaseService {
     summary(params: LemurSummaryParameters): Promise<LemurSummaryResponse>;
     questionAnswer(params: LemurQuestionAnswerParameters): Promise<LemurQuestionAnswerResponse>;

package/dist/services/realtime/factory.d.ts

@@ -1,10 +1,9 @@
-import { BaseServiceParams, RealtimeTokenParams, CreateRealtimeServiceParams } from "@/types";
-import { AxiosInstance } from "axios";
+import { BaseServiceParams, RealtimeTokenParams, CreateRealtimeServiceParams } from "../..";
 import { RealtimeService } from "./service";
-export declare class RealtimeServiceFactory {
-    private client;
-    private params;
-    constructor(client: AxiosInstance, params: BaseServiceParams);
+import { BaseService } from "../base";
+export declare class RealtimeServiceFactory extends BaseService {
+    private rtFactoryParams;
+    constructor(params: BaseServiceParams);
     createService(params?: CreateRealtimeServiceParams): RealtimeService;
     createTemporaryToken(params: RealtimeTokenParams): Promise<string>;
 }

package/dist/services/realtime/index.d.ts

@@ -1,2 +1,2 @@
-export * from "@/services/realtime/factory";
-export * from "@/services/realtime/service";
+export * from "./factory";
+export * from "./service";

package/dist/services/realtime/service.d.ts

@@ -1,6 +1,5 @@
 /// <reference types="node" />
-import { RealtimeServiceParams, RealtimeTranscript, PartialTranscript, FinalTranscript, SessionBeginsEventData } from "@/types";
-import { Writable } from "stream";
+import { RealtimeServiceParams, RealtimeTranscript, PartialTranscript, FinalTranscript, SessionBeginsEventData } from "../..";
 export declare class RealtimeService {
     private realtimeUrl;
     private sampleRate;
@@ -20,6 +19,6 @@ export declare class RealtimeService {
     on(event: "close", listener: (code: number, reason: string) => void): void;
     connect(): Promise<SessionBeginsEventData>;
     sendAudio(audio: ArrayBuffer): void;
-    stream(): Writable;
+    stream(): NodeJS.WritableStream;
     close(waitForSessionTermination?: boolean): Promise<void>;
 }

package/dist/services/transcripts/index.d.ts

@@ -1,10 +1,9 @@
-import { BaseService } from "@/services/base";
-import { ParagraphsResponse, SentencesResponse, Transcript, TranscriptList, CreateTranscriptParameters, CreateTranscriptOptions, Createable, Deletable, Listable, Retrieveable, SubtitleFormat, RedactedAudioResponse, TranscriptListParameters, WordSearchResponse } from "@/types";
-import { AxiosInstance } from "axios";
+import { BaseService } from "../base";
+import { ParagraphsResponse, SentencesResponse, Transcript, TranscriptList, CreateTranscriptParameters, CreateTranscriptOptions, Createable, Deletable, Listable, Retrieveable, SubtitleFormat, RedactedAudioResponse, TranscriptListParameters, WordSearchResponse, BaseServiceParams } from "../..";
 import { FileService } from "../files";
 export declare class TranscriptService extends BaseService implements Createable<Transcript, CreateTranscriptParameters, CreateTranscriptOptions>, Retrieveable<Transcript>, Deletable<Transcript>, Listable<TranscriptList> {
     private files;
-    constructor(client: AxiosInstance, files: FileService);
+    constructor(params: BaseServiceParams, files: FileService);
     /**
      * Create a transcript.
      * @param params The parameters to create a transcript.
@@ -34,7 +33,7 @@ export declare class TranscriptService extends BaseService implements Createable
      * Search through the transcript for a specific set of keywords.
      * You can search for individual words, numbers, or phrases containing up to five words or numbers.
      * @param id The identifier of the transcript.
-     * @param id Keywords to search for.
+     * @param words Keywords to search for.
      * @return A promise that resolves to the sentences.
      */
     wordSearch(id: string, words: string[]): Promise<WordSearchResponse>;

package/dist/types/files/index.d.ts

@@ -1,5 +1,4 @@
 /// <reference types="node" />
-/// <reference types="node" />
 type FileUploadParameters = string | FileUploadData;
-type FileUploadData = NodeJS.ReadableStream | ReadableStream | Buffer | ArrayBufferView | ArrayBufferLike | Uint8Array;
+type FileUploadData = NodeJS.ReadableStream | ReadableStream | Blob | BufferSource | ArrayBufferView | ArrayBufferLike | Uint8Array;
 export type { FileUploadParameters, FileUploadData };

package/dist/types/openapi.generated.d.ts

@@ -64,19 +64,24 @@ export type ContentSafetyLabelResult = {
     sentences_idx_end: number;
     /** @description The sentence index at which the section begins */
     sentences_idx_start: number;
+    /** @description The transcript of the section flagged by the Content Moderation model */
+    text: string;
+    /** @description Timestamp information for the section */
+    timestamp: Timestamp;
+};
+export type ContentSafetyLabelsResult = {
+    results: ContentSafetyLabelResult[];
     /** @description A summary of the Content Moderation severity results for the entire audio file */
     severity_score_summary: {
         [key: string]: SeverityScoreSummary;
     };
+    /** @description Will be either success, or unavailable in the rare case that the Content Moderation model failed. */
+    status: AudioIntelligenceModelStatus;
     /** @description A summary of the Content Moderation confidence results for the entire audio file */
     summary: {
         [key: string]: number;
     };
-    /** @description The transcript of the section flagged by the Content Moderation model */
-    text: string;
-    /** @description Timestamp information for the section */
-    timestamp: Timestamp;
-};
+} | null;
 export type CreateRealtimeTemporaryTokenParameters = {
     /** @description The amount of time until the token expires in seconds. */
     expires_in: number;
@@ -347,7 +352,7 @@ export type SentimentAnalysisResult = {
     end: number;
     /** @description The detected sentiment for the sentence, one of POSITIVE, NEUTRAL, NEGATIVE */
     sentiment: Sentiment;
-    /** @description The speaker of the sentence if Speaker Diarization is enabled, else null */
+    /** @description The speaker of the sentence if [Speaker Diarization](https://www.assemblyai.com/docs/models/speaker-diarization) is enabled, else null */
     speaker?: string | null;
     /** @description The starting time, in milliseconds, of the sentence */
     start: number;
@@ -391,7 +396,7 @@ export type Timestamp = {
     /** @description The start time in milliseconds */
     start: number;
 };
-/** @description THe result of the topic detection model. */
+/** @description The result of the topic detection model. */
 export type TopicDetectionResult = {
     labels?: {
         /** @description The IAB taxonomical label for the label of the detected topic, where > denotes supertopic/subtopic relationship */
@@ -448,11 +453,7 @@ export type Transcript = {
      * @description An array of results for the Content Moderation model, if it was enabled during the transcription request.
      * See [Content moderation](https://www.assemblyai.com/docs/Models/content_moderation) for more information.
      */
-    content_safety_labels?: {
-        results: ContentSafetyLabelResult[];
-        /** @description Will be either success, or unavailable in the rare case that the Content Safety Labels model failed. */
-        status: AudioIntelligenceModelStatus;
-    } | null;
+    content_safety_labels?: ContentSafetyLabelsResult;
     /** @description Customize how words are spelled and formatted using to and from values */
     custom_spelling?: TranscriptCustomSpelling[] | null;
     /** @description Whether custom topics was enabled in the transcription request, either true or false */
@@ -477,7 +478,7 @@ export type Transcript = {
     /** @description Enable [Topic Detection](https://www.assemblyai.com/docs/Models/iab_classification), can be true or false */
     iab_categories?: boolean | null;
     /**
-     * @description An array of results for the Topic Detection model, if it was enabled during the transcription request.
+     * @description The result of the Topic Detection model, if it was enabled during the transcription request.
      * See [Topic Detection](https://www.assemblyai.com/docs/Models/iab_classification) for more information.
      */
     iab_categories_result?: {
@@ -663,12 +664,20 @@ export type TranscriptSentence = {
  */
 export type TranscriptStatus = "queued" | "processing" | "completed" | "error";
 export type TranscriptUtterance = {
-    channel: string;
-    /** Format: double */
+    /**
+     * Format: double
+     * @description The confidence score for the transcript of this utterance
+     */
     confidence: number;
+    /** @description The ending time, in milliseconds, of the utterance in the audio file */
     end: number;
+    /** @description The speaker of this utterance, where each speaker is assigned a sequential capital letter - e.g. "A" for Speaker A, "B" for Speaker B, etc. */
+    speaker: string;
+    /** @description The starting time, in milliseconds, of the utterance in the audio file */
     start: number;
+    /** @description The text for this utterance */
     text: string;
+    /** @description The words in the utterance. */
     words: TranscriptWord[];
 };
 export type TranscriptWord = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assemblyai",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "The AssemblyAI Node.js SDK provides an easy-to-use interface for interacting with the AssemblyAI API, which supports async and real-time transcription, as well as the latest LeMUR models.",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -51,6 +51,7 @@
     "i": "^0.3.7",
     "jest": "^29.5.0",
     "jest-cli": "^29.5.0",
+    "jest-fetch-mock": "^3.0.3",
     "jest-junit": "^16.0.0",
     "jest-mock-extended": "^3.0.4",
     "jest-websocket-mock": "^2.4.1",
@@ -67,7 +68,6 @@
     "typescript": "^5.2.2"
   },
   "dependencies": {
-    "axios": "^1.4.0",
     "ws": "^8.13.0"
   }
 }

package/src/services/base.ts

@@ -1,4 +1,5 @@
-import { AxiosInstance } from "axios";
+import { BaseServiceParams } from "..";
+import { Error as JsonError } from "..";
 
 /**
  * Base class for services that communicate with the API.
@@ -6,7 +7,47 @@ import { AxiosInstance } from "axios";
 export abstract class BaseService {
   /**
    * Create a new service.
-   * @param params The AxiosInstance to send HTTP requests to the API.
+   * @param params The parameters to use for the service.
    */
-  constructor(protected client: AxiosInstance) {}
+  constructor(private params: BaseServiceParams) {}
+  protected async fetch(
+    input: string,
+    init?: RequestInit | undefined
+  ): Promise<Response> {
+    init = init ?? {};
+    init.headers = init.headers ?? {};
+    init.headers = {
+      Authorization: this.params.apiKey,
+      "Content-Type": "application/json",
+      ...init.headers,
+    };
+    if (!input.startsWith("http")) input = this.params.baseUrl + input;
+
+    const response = await fetch(input, init);
+
+    if (response.status >= 400) {
+      let json: JsonError | undefined;
+      const text = await response.text();
+      if (text) {
+        try {
+          json = JSON.parse(text);
+        } catch {
+          /* empty */
+        }
+        if (json?.error) throw new Error(json.error);
+        throw new Error(text);
+      }
+      throw new Error(`HTTP Error: ${response.status} ${response.statusText}`);
+    }
+
+    return response;
+  }
+
+  protected async fetchJson<T>(
+    input: string,
+    init?: RequestInit | undefined
+  ): Promise<T> {
+    const response = await this.fetch(input, init);
+    return response.json() as Promise<T>;
+  }
 }