@cloudparker/moldex.js 4.1.7 → 4.1.8

package/dist/services/utils/file-service.d.ts

@@ -0,0 +1,140 @@
+export declare const FILE_EXTENTIONS: string[];
+export declare const FILE_VIEWER_HOST = "https://viewer.cloudparker.com";
+/**
+ * Reads a file as a data URL.
+ * @param file - The file to read.
+ * @returns A promise that resolves to a data URL string.
+ */
+export declare function readFileAsDataURL(file: File): Promise<string>;
+/**
+ * Reads the contents of a given File object as a text string.
+ *
+ * This function uses the FileReader API to read the file content and returns it as a string.
+ *
+ * @param file - The File object to be read.
+ * @returns A promise that resolves to the text content of the file as a string.
+ *
+ * @throws An error if the file could not be read.
+ *
+ * @example
+ * // Create a file and read its content as text
+ * const myFile = new File(['Hello, world!'], 'example.txt', { type: 'text/plain' });
+ * readFileAsText(myFile).then((text) => {
+ *     console.log(text); // Output: "Hello, world!"
+ * });
+ */
+export declare function readFileAsText(file: File): Promise<string>;
+/**
+ * Reads the contents of a given File object as an ArrayBuffer.
+ *
+ * This function uses the FileReader API to read the file content as a binary ArrayBuffer.
+ *
+ * @param file - The File object to be read.
+ * @returns A promise that resolves to the binary content of the file as an ArrayBuffer.
+ *
+ * @throws An error if the file could not be read.
+ *
+ * @example
+ * // Create a file and read its content as an ArrayBuffer
+ * const myFile = new File(['Hello, world!'], 'example.txt', { type: 'text/plain' });
+ * readFileAsBuffer(myFile).then((buffer) => {
+ *     console.log(buffer); // Output: ArrayBuffer { ... }
+ * });
+ */
+export declare function readFileAsBuffer(file: File): Promise<ArrayBuffer>;
+/**
+ * Converts a given URL to a File object by downloading the content from the URL.
+ *
+ * This function fetches the file content from the provided URL and converts it into a File object.
+ * It attempts to extract the filename and MIME type from the HTTP headers. If these are not available,
+ * it falls back to using the provided filename and MIME type or extracts the filename from the URL.
+ *
+ * @param url - The URL to download the file from.
+ * @param givenFileName - Optional. The fallback name for the file if no name can be extracted from the URL or headers.
+ * @param givenMimeType - Optional. The fallback MIME type for the file if no MIME type is available in the headers.
+ * @returns A promise that resolves to a File object containing the downloaded content.
+ *
+ * @throws An error if the download fails or the file cannot be converted.
+ *
+ * @example
+ * // Convert an image URL to a File object and log its properties
+ * readUrlAsFile('https://example.com/image.png', 'downloaded-image.png', 'image/png')
+ *     .then((file) => {
+ *         console.log(file.name);  // Output: "downloaded-image.png"
+ *         console.log(file.type);  // Output: "image/png"
+ *     })
+ *     .catch((error) => console.error('Error converting URL to file:', error.message));
+ */
+export declare function readUrlAsFile(url: string, givenFileName?: string, givenMimeType?: string): Promise<File>;
+/**
+ * Converts a given Data URL (Base64 or Data URL format) to a File object.
+ *
+ * @param dataUrl - The Data URL string to convert into a File object.
+ * @param fileName - Optional. The name for the created file.
+ * @param mimeType - Optional. The MIME type of the file. If not provided, it will be extracted from the Data URL.
+ * @returns A promise that resolves to a File object containing the content of the Data URL.
+ *
+ * @example
+ * // Convert a Base64 string to a File object
+ * const base64String = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...';
+ * readDataUrlAsFile(base64String, 'example.png', 'image/png')
+ *     .then((file) => {
+ *         console.log(file.name);  // Output: "example.png"
+ *         console.log(file.type);  // Output: "image/png"
+ *     });
+ */
+export declare function readDataUrlAsFile(dataUrl: string, fileName?: string, mimeType?: string): Promise<File>;
+/**
+ * Converts a given ArrayBuffer to a File object.
+ *
+ * This function wraps an ArrayBuffer in a File object with the provided filename and MIME type.
+ *
+ * @param buffer - The ArrayBuffer containing the file data.
+ * @param fileName - The name for the created file.
+ * @param mimeType - The MIME type for the created file.
+ * @returns A promise that resolves to a File object created from the ArrayBuffer.
+ *
+ * @example
+ * // Convert an ArrayBuffer to a File object
+ * const buffer = new ArrayBuffer(8);
+ * convertBufferToFile(buffer, 'example.bin', 'application/octet-stream').then((file) => {
+ *     console.log(file.name);  // Output: "example.bin"
+ *     console.log(file.type);  // Output: "application/octet-stream"
+ * });
+ */
+export declare function convertBufferToFile(buffer: ArrayBuffer, fileName: string, mimeType: string): Promise<File>;
+/**
+ * Extracts the filename and extension from a given filename string.
+ *
+ * This function splits a filename into its base name and extension parts.
+ * If no extension is present, the extension will be `undefined`.
+ *
+ * @param filename - The filename string to be processed.
+ * @returns An object containing the base name and extension of the filename.
+ *
+ * @example
+ * // Extract filename and extension
+ * const { name, ext } = getFilenameExtension('example.txt');
+ * console.log(name); // Output: "example"
+ * console.log(ext);  // Output: "txt"
+ */
+export declare function getFilenameExtension(filename: string): {
+    name: string;
+    ext: string | undefined;
+};
+/**
+ * Converts a file size in bytes to a human-readable string.
+ *
+ * This function converts a file size in bytes to a string representation with appropriate units
+ * (e.g., B, kB, MB, GB, TB) based on the size.
+ *
+ * @param size - The file size in bytes.
+ * @returns A human-readable string representing the file size.
+ *
+ * @example
+ * const sizeString = fileSizeString(1024);
+ * console.log(sizeString); // Output: "1 kB"
+ */
+export declare function formatFileSize(bytes?: number): string;
+export declare function getExtFromFileType(type: string): string | null;
+export declare function ellipsisFileNameAtCenter(name: string, sizeLimit?: number, startLength?: number, endLength?: number): string;

package/dist/services/utils/file-service.js

@@ -0,0 +1,301 @@
+export const FILE_EXTENTIONS = [
+    "java", "js", "ts", "json", "c", "cpp", "cs", "py", "ts", "php", "rb", "swift", "go",
+    "rs", "kt", "scala", "pl", "lua", "hs", "sh", "ps1", "dart", "jl", "m", "f90", "txt",
+    "r", "groovy", "asm", "pas", "ada", "sql", "md", "html", "css", "xml", "yaml", "xml",
+    "bat",
+];
+export const FILE_VIEWER_HOST = 'https://viewer.cloudparker.com';
+/**
+ * Reads a file as a data URL.
+ * @param file - The file to read.
+ * @returns A promise that resolves to a data URL string.
+ */
+export function readFileAsDataURL(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(reader.result);
+        reader.onerror = () => reject(reader.error);
+        reader.readAsDataURL(file);
+    });
+}
+/**
+ * Reads the contents of a given File object as a text string.
+ *
+ * This function uses the FileReader API to read the file content and returns it as a string.
+ *
+ * @param file - The File object to be read.
+ * @returns A promise that resolves to the text content of the file as a string.
+ *
+ * @throws An error if the file could not be read.
+ *
+ * @example
+ * // Create a file and read its content as text
+ * const myFile = new File(['Hello, world!'], 'example.txt', { type: 'text/plain' });
+ * readFileAsText(myFile).then((text) => {
+ *     console.log(text); // Output: "Hello, world!"
+ * });
+ */
+export async function readFileAsText(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        // Event handler executed when the file reading operation is completed
+        reader.onloadend = function () {
+            // Check if the file was read successfully
+            if (reader.readyState === FileReader.DONE) {
+                resolve(reader.result);
+            }
+            else {
+                reject(new Error('Failed to read file as text.'));
+            }
+        };
+        // Event handler executed when an error occurs while reading the file
+        reader.onerror = function () {
+            reject(new Error(`Error reading file: ${reader.error?.message || 'Unknown error'}`));
+        };
+        // Read the file content as a text string
+        reader.readAsText(file);
+    });
+}
+/**
+ * Reads the contents of a given File object as an ArrayBuffer.
+ *
+ * This function uses the FileReader API to read the file content as a binary ArrayBuffer.
+ *
+ * @param file - The File object to be read.
+ * @returns A promise that resolves to the binary content of the file as an ArrayBuffer.
+ *
+ * @throws An error if the file could not be read.
+ *
+ * @example
+ * // Create a file and read its content as an ArrayBuffer
+ * const myFile = new File(['Hello, world!'], 'example.txt', { type: 'text/plain' });
+ * readFileAsBuffer(myFile).then((buffer) => {
+ *     console.log(buffer); // Output: ArrayBuffer { ... }
+ * });
+ */
+export async function readFileAsBuffer(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        // Event handler executed when the file reading operation is completed
+        reader.onloadend = () => {
+            if (reader.readyState === FileReader.DONE) {
+                resolve(reader.result);
+            }
+            else {
+                reject(new Error('Failed to read file as ArrayBuffer.'));
+            }
+        };
+        // Event handler executed when an error occurs while reading the file
+        reader.onerror = () => {
+            reject(new Error(`Error reading file as ArrayBuffer: ${reader.error?.message || 'Unknown error'}`));
+        };
+        // Read the file content as a binary ArrayBuffer
+        reader.readAsArrayBuffer(file);
+    });
+}
+/**
+ * Converts a given URL to a File object by downloading the content from the URL.
+ *
+ * This function fetches the file content from the provided URL and converts it into a File object.
+ * It attempts to extract the filename and MIME type from the HTTP headers. If these are not available,
+ * it falls back to using the provided filename and MIME type or extracts the filename from the URL.
+ *
+ * @param url - The URL to download the file from.
+ * @param givenFileName - Optional. The fallback name for the file if no name can be extracted from the URL or headers.
+ * @param givenMimeType - Optional. The fallback MIME type for the file if no MIME type is available in the headers.
+ * @returns A promise that resolves to a File object containing the downloaded content.
+ *
+ * @throws An error if the download fails or the file cannot be converted.
+ *
+ * @example
+ * // Convert an image URL to a File object and log its properties
+ * readUrlAsFile('https://example.com/image.png', 'downloaded-image.png', 'image/png')
+ *     .then((file) => {
+ *         console.log(file.name);  // Output: "downloaded-image.png"
+ *         console.log(file.type);  // Output: "image/png"
+ *     })
+ *     .catch((error) => console.error('Error converting URL to file:', error.message));
+ */
+export async function readUrlAsFile(url, givenFileName, givenMimeType) {
+    try {
+        const response = await fetch(url);
+        // Check if the fetch request was successful
+        if (!response.ok) {
+            throw new Error(`Failed to fetch file from URL: ${response.statusText}`);
+        }
+        // Extract filename from the Content-Disposition header if available
+        const contentDisposition = response.headers.get('Content-Disposition');
+        let fileName = "";
+        if (contentDisposition) {
+            const filenameMatch = contentDisposition.match(/filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/);
+            if (filenameMatch && filenameMatch[1]) {
+                fileName = filenameMatch[1].replace(/['"]/g, '');
+            }
+        }
+        // Fallback to using the URL's last segment as the filename if Content-Disposition is not available
+        if (!fileName) {
+            const urlSegments = url.split('/');
+            fileName = urlSegments[urlSegments.length - 1] || 'downloaded-file';
+        }
+        // Get MIME type from the Content-Type header, if available
+        const mimeType = response.headers.get('Content-Type') || givenMimeType || 'application/octet-stream';
+        // Read the file content as an ArrayBuffer
+        const buffer = await response.arrayBuffer();
+        // Create a File object with the buffer, filename, and MIME type
+        return new File([buffer], givenFileName || fileName, { type: mimeType });
+    }
+    catch (error) {
+        throw new Error(`Error converting URL to file: ${error.message}`);
+    }
+}
+/**
+ * Converts a given Data URL (Base64 or Data URL format) to a File object.
+ *
+ * @param dataUrl - The Data URL string to convert into a File object.
+ * @param fileName - Optional. The name for the created file.
+ * @param mimeType - Optional. The MIME type of the file. If not provided, it will be extracted from the Data URL.
+ * @returns A promise that resolves to a File object containing the content of the Data URL.
+ *
+ * @example
+ * // Convert a Base64 string to a File object
+ * const base64String = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...';
+ * readDataUrlAsFile(base64String, 'example.png', 'image/png')
+ *     .then((file) => {
+ *         console.log(file.name);  // Output: "example.png"
+ *         console.log(file.type);  // Output: "image/png"
+ *     });
+ */
+export async function readDataUrlAsFile(dataUrl, fileName = 'file', mimeType) {
+    try {
+        // Extract the MIME type from the Data URL if not provided
+        const mimeTypeMatch = dataUrl.match(/^data:([^;]+);/);
+        const extractedMimeType = mimeTypeMatch ? mimeTypeMatch[1] : mimeType;
+        // Convert the Base64 portion of the Data URL to a binary string
+        const binaryString = atob(dataUrl.split(',')[1]);
+        // Convert the binary string to an ArrayBuffer
+        const length = binaryString.length;
+        const buffer = new Uint8Array(length);
+        for (let i = 0; i < length; i++) {
+            buffer[i] = binaryString.charCodeAt(i);
+        }
+        // Create and return a File object
+        return new File([buffer], fileName, { type: extractedMimeType || 'application/octet-stream' });
+    }
+    catch (error) {
+        throw new Error(`Error converting Data URL to file: ${error.message}`);
+    }
+}
+/**
+ * Converts a given ArrayBuffer to a File object.
+ *
+ * This function wraps an ArrayBuffer in a File object with the provided filename and MIME type.
+ *
+ * @param buffer - The ArrayBuffer containing the file data.
+ * @param fileName - The name for the created file.
+ * @param mimeType - The MIME type for the created file.
+ * @returns A promise that resolves to a File object created from the ArrayBuffer.
+ *
+ * @example
+ * // Convert an ArrayBuffer to a File object
+ * const buffer = new ArrayBuffer(8);
+ * convertBufferToFile(buffer, 'example.bin', 'application/octet-stream').then((file) => {
+ *     console.log(file.name);  // Output: "example.bin"
+ *     console.log(file.type);  // Output: "application/octet-stream"
+ * });
+ */
+export async function convertBufferToFile(buffer, fileName, mimeType) {
+    try {
+        // Create and return a File object from the ArrayBuffer
+        return new File([buffer], fileName, { type: mimeType });
+    }
+    catch (error) {
+        throw new Error(`Error converting ArrayBuffer to file: ${error.message}`);
+    }
+}
+/**
+ * Extracts the filename and extension from a given filename string.
+ *
+ * This function splits a filename into its base name and extension parts.
+ * If no extension is present, the extension will be `undefined`.
+ *
+ * @param filename - The filename string to be processed.
+ * @returns An object containing the base name and extension of the filename.
+ *
+ * @example
+ * // Extract filename and extension
+ * const { name, ext } = getFilenameExtension('example.txt');
+ * console.log(name); // Output: "example"
+ * console.log(ext);  // Output: "txt"
+ */
+export function getFilenameExtension(filename) {
+    if (!filename)
+        return { name: '', ext: undefined };
+    const parts = filename.split('.');
+    const ext = parts.length > 1 ? parts.pop() : undefined;
+    const name = parts.join('.');
+    return { name, ext };
+}
+/**
+ * Converts a file size in bytes to a human-readable string.
+ *
+ * This function converts a file size in bytes to a string representation with appropriate units
+ * (e.g., B, kB, MB, GB, TB) based on the size.
+ *
+ * @param size - The file size in bytes.
+ * @returns A human-readable string representing the file size.
+ *
+ * @example
+ * const sizeString = fileSizeString(1024);
+ * console.log(sizeString); // Output: "1 kB"
+ */
+export function formatFileSize(bytes = 0) {
+    if (bytes < 1024) {
+        return bytes + ' Bytes';
+    }
+    else if (bytes < 1024 * 1024) {
+        return (bytes / 1024).toFixed(2) + ' KB';
+    }
+    else if (bytes < 1024 * 1024 * 1024) {
+        return (bytes / (1024 * 1024)).toFixed(2) + ' MB';
+    }
+    else {
+        return (bytes / (1024 * 1024 * 1024)).toFixed(2) + ' GB';
+    }
+}
+export function getExtFromFileType(type) {
+    const mimeTypes = {
+        "image/jpeg": "jpg",
+        "image/png": "png",
+        "image/gif": "gif",
+        "image/webp": "webp",
+        "image/svg+xml": "svg",
+        "video/mp4": "mp4",
+        "video/webm": "webm",
+        "video/ogg": "ogv",
+        "audio/mpeg": "mp3",
+        "audio/ogg": "ogg",
+        "audio/wav": "wav",
+        "application/pdf": "pdf",
+        "application/json": "json",
+        "application/javascript": "js",
+        "text/html": "html",
+        "text/css": "css",
+        "text/plain": "txt",
+        "application/zip": "zip",
+        "application/x-rar-compressed": "rar",
+        "application/xml": "xml"
+    };
+    return mimeTypes[type] || null;
+}
+export function ellipsisFileNameAtCenter(name, sizeLimit = 15, startLength = 5, endLength = 3) {
+    name = name || '';
+    if (name.length > sizeLimit) {
+        name = [
+            name.substring(0, startLength),
+            '…',
+            name.substring(name.lastIndexOf('.') - endLength, name.length)
+        ].join('');
+        return name;
+    }
+    return name;
+}

package/dist/services/utils/http-service.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Sends a GET request to the specified URL.
+ *
+ * @param url - The URL to send the GET request to.
+ * @param headers - Optional headers to include in the request.
+ * @returns A promise that resolves to the JSON response from the server.
+ *
+ * @throws An error if the request fails or the response cannot be parsed as JSON.
+ *
+ * @example
+ * httpGet('https://api.example.com/data')
+ *   .then((response) => console.log(response))
+ *   .catch((error) => console.error('Error fetching data:', error));
+ */
+export declare function httpGet(url: string, headers?: HeadersInit): Promise<any>;
+/**
+ * Sends a POST request with JSON data to the specified URL.
+ *
+ * @param url - The endpoint URL to send the POST request to.
+ * @param data - The data object to be sent as the request body.
+ * @param headers - Optional headers to include in the request.
+ * @returns A promise that resolves to the JSON response from the server.
+ *
+ * @throws An error if the request fails or the response cannot be parsed as JSON.
+ */
+export declare function httpPost(url: string, data?: Record<string, any>, headers?: HeadersInit): Promise<any>;
+/**
+ * Sends a PUT request with JSON data to the specified URL.
+ *
+ * @param url - The endpoint URL to send the PUT request to.
+ * @param data - The data object to be sent as the request body.
+ * @param headers - Optional headers to include in the request.
+ * @returns A promise that resolves to the JSON response from the server.
+ *
+ * @throws An error if the request fails or the response cannot be parsed as JSON.
+ */
+export declare function httpPut(url: string, data?: Record<string, any>, headers?: HeadersInit): Promise<any>;
+/**
+ * Sends a PATCH request with JSON data to the specified URL.
+ *
+ * @param url - The endpoint URL to send the PATCH request to.
+ * @param data - The data object to be sent as the request body.
+ * @param headers - Optional headers to include in the request.
+ * @returns A promise that resolves to the JSON response from the server.
+ *
+ * @throws An error if the request fails or the response cannot be parsed as JSON.
+ */
+export declare function httpPatch(url: string, data?: Record<string, any>, headers?: HeadersInit): Promise<any>;
+/**
+ * Sends a DELETE request to the specified URL.
+ *
+ * @param url - The endpoint URL to send the DELETE request to.
+ * @param headers - Optional headers to include in the request.
+ * @returns A promise that resolves to the JSON response from the server.
+ *
+ * @throws An error if the request fails or the response cannot be parsed as JSON.
+ */
+export declare function httpDelete(url: string, headers?: HeadersInit): Promise<any>;
+/**
+ * Fetches text content from a given URL with a default timeout of 60 seconds.
+ *
+ * This function sends a GET request to the provided URL and returns the response as text.
+ * It throws an error if the request fails or the response cannot be read as text.
+ * The request will be aborted if it exceeds the default timeout of 60 seconds.
+ *
+ * @param url - The URL to fetch the text content from.
+ * @param timeout - Optional. The timeout duration in milliseconds. Default is 60 seconds (60000ms).
+ * @returns A promise that resolves to the text content of the URL.
+ *
+ * @throws An error if the fetch request fails or if the request times out.
+ *
+ * @example
+ * fetchText('https://example.com/data.txt').then((text) => {
+ *     console.log(text); // Outputs the text content of the file.
+ * }).catch((error) => console.error('Failed to fetch text:', error));
+ */
+export declare function fetchText(url: string, timeout?: number): Promise<string>;

package/dist/services/utils/http-service.js

@@ -0,0 +1,158 @@
+// Default timeout duration in milliseconds (60 seconds)
+const DEFAULT_TIMEOUT = 60000;
+/**
+ * Sends a GET request to the specified URL.
+ *
+ * @param url - The URL to send the GET request to.
+ * @param headers - Optional headers to include in the request.
+ * @returns A promise that resolves to the JSON response from the server.
+ *
+ * @throws An error if the request fails or the response cannot be parsed as JSON.
+ *
+ * @example
+ * httpGet('https://api.example.com/data')
+ *   .then((response) => console.log(response))
+ *   .catch((error) => console.error('Error fetching data:', error));
+ */
+export async function httpGet(url, headers = {}) {
+    return httpRequest(url, { method: 'GET', headers });
+}
+/**
+ * Sends a POST request with JSON data to the specified URL.
+ *
+ * @param url - The endpoint URL to send the POST request to.
+ * @param data - The data object to be sent as the request body.
+ * @param headers - Optional headers to include in the request.
+ * @returns A promise that resolves to the JSON response from the server.
+ *
+ * @throws An error if the request fails or the response cannot be parsed as JSON.
+ */
+export async function httpPost(url, data = {}, headers = {}) {
+    return httpRequest(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...headers },
+        body: JSON.stringify(data),
+    });
+}
+/**
+ * Sends a PUT request with JSON data to the specified URL.
+ *
+ * @param url - The endpoint URL to send the PUT request to.
+ * @param data - The data object to be sent as the request body.
+ * @param headers - Optional headers to include in the request.
+ * @returns A promise that resolves to the JSON response from the server.
+ *
+ * @throws An error if the request fails or the response cannot be parsed as JSON.
+ */
+export async function httpPut(url, data = {}, headers = {}) {
+    return httpRequest(url, {
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json', ...headers },
+        body: JSON.stringify(data),
+    });
+}
+/**
+ * Sends a PATCH request with JSON data to the specified URL.
+ *
+ * @param url - The endpoint URL to send the PATCH request to.
+ * @param data - The data object to be sent as the request body.
+ * @param headers - Optional headers to include in the request.
+ * @returns A promise that resolves to the JSON response from the server.
+ *
+ * @throws An error if the request fails or the response cannot be parsed as JSON.
+ */
+export async function httpPatch(url, data = {}, headers = {}) {
+    return httpRequest(url, {
+        method: 'PATCH',
+        headers: { 'Content-Type': 'application/json', ...headers },
+        body: JSON.stringify(data),
+    });
+}
+/**
+ * Sends a DELETE request to the specified URL.
+ *
+ * @param url - The endpoint URL to send the DELETE request to.
+ * @param headers - Optional headers to include in the request.
+ * @returns A promise that resolves to the JSON response from the server.
+ *
+ * @throws An error if the request fails or the response cannot be parsed as JSON.
+ */
+export async function httpDelete(url, headers = {}) {
+    return httpRequest(url, { method: 'DELETE', headers });
+}
+/**
+ * Generic function to handle HTTP requests with a timeout.
+ *
+ * @param url - The URL to send the request to.
+ * @param options - The request options (method, headers, body, etc.).
+ * @param timeout - Optional timeout duration in milliseconds. Default is 60 seconds.
+ * @returns A promise that resolves to the JSON response from the server.
+ *
+ * @throws An error if the request times out or if the response cannot be parsed as JSON.
+ */
+async function httpRequest(url, options, timeout = DEFAULT_TIMEOUT) {
+    // Create an AbortController to handle request timeout
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    options.signal = controller.signal;
+    try {
+        const response = await fetch(url, options);
+        // Check if the response is successful (status in the range 200–299)
+        if (!response.ok) {
+            throw new Error(`HTTP error! Status: ${response.status} ${response.statusText}`);
+        }
+        // Parse and return the response as JSON
+        return await response.json();
+    }
+    catch (error) {
+        if (error.name === 'AbortError') {
+            throw new Error(`Request to ${url} timed out after ${timeout / 1000} seconds.`);
+        }
+        throw new Error(`Failed to fetch ${url}: ${error.message}`);
+    }
+    finally {
+        clearTimeout(timeoutId); // Clear the timeout to prevent memory leaks
+    }
+}
+/**
+ * Fetches text content from a given URL with a default timeout of 60 seconds.
+ *
+ * This function sends a GET request to the provided URL and returns the response as text.
+ * It throws an error if the request fails or the response cannot be read as text.
+ * The request will be aborted if it exceeds the default timeout of 60 seconds.
+ *
+ * @param url - The URL to fetch the text content from.
+ * @param timeout - Optional. The timeout duration in milliseconds. Default is 60 seconds (60000ms).
+ * @returns A promise that resolves to the text content of the URL.
+ *
+ * @throws An error if the fetch request fails or if the request times out.
+ *
+ * @example
+ * fetchText('https://example.com/data.txt').then((text) => {
+ *     console.log(text); // Outputs the text content of the file.
+ * }).catch((error) => console.error('Failed to fetch text:', error));
+ */
+export async function fetchText(url, timeout = DEFAULT_TIMEOUT) {
+    // Create an AbortController to handle request timeout
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        // Check if the response is successful (status in the range 200–299)
+        if (!response.ok) {
+            throw new Error(`Failed to fetch text. Status: ${response.status} ${response.statusText}`);
+        }
+        // Return the response as text
+        return await response.text();
+    }
+    catch (error) {
+        if (error.name === 'AbortError') {
+            throw new Error(`Request to ${url} timed out after ${timeout / 1000} seconds.`);
+        }
+        console.error('Error fetching text from URL:', error);
+        throw new Error(`Failed to fetch text from ${url}: ${error.message}`);
+    }
+    finally {
+        clearTimeout(timeoutId); // Clear the timeout to prevent memory leaks
+    }
+}