@vandenberghinc/volt 1.1.26 → 1.1.28

package/backend/dist/{cjs → esm/backend/src}/endpoint.d.ts

@@ -1,6 +1,10 @@
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
+ */
 import { View } from './view.js';
 import * as vlib from "@vandenberghinc/vlib";
-import { RateLimits, RateLimitGroup } from "./rate_limit.js";
+import { RateLimitGroup, RateLimitData } from "./rate_limit.js";
 import { Stream, AuthStream } from "./stream.js";
 import type { Server } from "./server.js";
 import { Route } from './route.js';
@@ -93,8 +97,7 @@ import { Route } from './route.js';
  *   and only have to be assigned once. The assigned attributes will be overridden when
  *   these attributes are reassigned for the same group.
  */
-export declare class Endpoint<const S extends vlib.scheme.Infer.Scheme.S = {}> {
-    static rate_limits: Map<string, any>;
+export declare class Endpoint<const M extends Endpoint.Method = "GET", const E extends string | RegExp = string, const S extends vlib.Schema.Entries.Opts = {}> {
     static compressed_content_types: string[];
     /** Route attributes */
     id: string;
@@ -102,17 +105,19 @@ export declare class Endpoint<const S extends vlib.scheme.Infer.Scheme.S = {}> {
     /** Requires authentication */
     authenticated: boolean;
     /** Parameter scheme validator */
-    params_val?: vlib.scheme.Validator<object, object, "object">;
+    params_schema?: vlib.Schema.Validator<object>;
     /** The default response headers */
     headers: [string, string][];
     /** Option 1) User callback - defined as method so a derived endpoint can do that as well. */
-    callback?(stream: Stream, params: vlib.scheme.Infer.Scheme<S>): any;
-    callback?(stream: AuthStream, params: vlib.scheme.Infer.Scheme<S>): any;
+    callback?(stream: Stream, params: vlib.Schema.Entries.Infer<S>): any;
+    callback?(stream: AuthStream, params: vlib.Schema.Entries.Infer<S>): any;
     /** Option 2) View based endpoint */
     view?: View;
     /** Option 3) Data endpoint, raw */
-    data: Buffer | string | any[] | Record<any, any>;
+    data?: Buffer | string | any[] | Record<any, any>;
     raw_data?: Buffer | string | any[] | Record<any, any>;
+    /** Option 4 Data endpoint by file path. */
+    file_path?: vlib.Path;
     /** Content length & type */
     content_length?: number;
     content_type?: string;
@@ -122,60 +127,78 @@ export declare class Endpoint<const S extends vlib.scheme.Infer.Scheme.S = {}> {
     allow_sitemap: boolean;
     allow_robots: boolean;
     /** Rate limit groups for internal use. */
-    rate_limit_groups: ReturnType<typeof RateLimits.add>[];
+    rate_limit_groups: RateLimitData[];
     /** Private attributes */
     private _compress;
     private _cache;
-    _static_path?: string;
-    private _templates;
     private ip_whitelist?;
     private _is_compressed?;
     private _initialized;
-    private _server?;
-    constructor({ method, endpoint, authenticated, rate_limit, params, callback, view, data, content_type, // = "text/plain",
-    compress, cache, ip_whitelist, sitemap, robots, allow_unknown_params, _templates, // only used in loading static files.
-    _static_path, _is_static, }: {
-        method?: string;
-        endpoint: string | RegExp;
-        authenticated?: boolean;
-        rate_limit?: string | RateLimitGroup | RateLimitGroup[];
+    /** A reference to the server. */
+    server?: Server;
+    constructor({ method, endpoint, authenticated, rate_limit, params, compress, cache, ip_whitelist, sitemap, robots, allow_unknown_params, _is_static, callback, view, data, file_path, content_type, }: Endpoint.Opts<M, E, S>);
+    /** Initialize with server. */
+    _initialize(server: Server): this;
+    _dynamic_initialize(): Promise<void>;
+    _set_headers(stream: Stream): void;
+    _serve_options(stream: Stream): Promise<void>;
+    _serve(stream: Stream, status_code?: number): Promise<void>;
+    private _load_data_by_path;
+}
+export declare namespace Endpoint {
+    /** The endpoint method. */
+    type Method = "GET" | "POST" | "DELETE" | "PUT" | "PATCH" | "OPTIONS";
+    /** Options for constructing an endpoint. */
+    type Opts<M extends Method = Method, E extends string | RegExp = string, S extends vlib.Schema.Entries.Opts = {}> = {
+        /**
+         * The endpoint method.
+         * @default "GET"
+         */
+        method?: M extends undefined ? "GET" : M;
+        endpoint: E;
+        rate_limit?: string | RateLimitGroup | (string | RateLimitGroup)[];
         params?: S;
-        callback?: ((stream: Stream, params: vlib.scheme.Infer.Scheme<S>) => any) | ((stream: AuthStream, params: vlib.scheme.Infer.Scheme<S>) => any);
-        data?: any;
         compress?: "auto" | boolean;
         cache?: boolean | number;
         ip_whitelist?: string[];
         sitemap?: boolean;
         robots?: boolean;
-        _templates?: Record<string, any>;
-        _static_path?: string;
         _is_static?: boolean;
         allow_unknown_params?: boolean;
     } & ({
-        view: View | View.Opts;
-        content_type?: string;
+        data?: Buffer | string | any[] | Record<any, any>;
+        file_path?: never;
+        view?: never;
+        authenticated?: boolean;
+        callback?: never;
+        content_type: string;
+    } | {
+        data?: never;
+        file_path: string | vlib.Path;
+        authenticated?: boolean;
+        callback?: never;
+        view?: never;
+        content_type: string;
     } | {
-        view?: null | undefined;
+        data?: never;
+        file_path?: never;
+        authenticated?: false;
+        callback: ((stream: Stream, params: vlib.Schema.Entries.Infer<S>) => any);
+        view?: never;
         content_type: string;
-    }));
-    /** Initialize with server. */
-    _initialize(server: Server): this;
-    /**
-     * Convert a RegExp into a readable path:
-     * - strips ^…$ anchors
-     * - unescapes `\/` → `/`
-     * - `(?<name>…)` → `:name`
-     * - anonymous captures `(…)` → `:param1`, `:param2`, …
-     */
-    _stringify_endpoint_regex(re: RegExp): string;
-    _load_data_by_path(server: any): this;
-    _set_headers(stream: any): void;
-    _refresh(server: any): Promise<void>;
-    _dynamic_initialize(): Promise<void>;
-    _serve_options(stream: Stream): Promise<void>;
-    _serve(stream: Stream, status_code?: number): Promise<void>;
-}
-export declare namespace Endpoint {
-    /** Constructor options without the `_server` attribute. */
-    type Opts<S extends vlib.scheme.Infer.Scheme.S = {}> = ConstructorParameters<typeof Endpoint<S>>[0];
+    } | {
+        data?: never;
+        file_path?: never;
+        authenticated: true;
+        callback: ((stream: AuthStream, params: vlib.Schema.Entries.Infer<S>) => any);
+        view?: never;
+        content_type: string;
+    } | {
+        data?: never;
+        file_path?: never;
+        authenticated?: boolean;
+        callback?: never;
+        view: View | View.Opts;
+        content_type?: string;
+    });
 }

package/backend/dist/esm/{endpoint.js → backend/src/endpoint.js}

@@ -1,6 +1,6 @@
-/*
- * Author: Daan van den Bergh
- * Copyright: © 2022 - 2024 Daan van den Bergh.
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
  */
 // ---------------------------------------------------------
 // Imports.
@@ -8,13 +8,11 @@ import CleanCSS from 'clean-css';
 import zlib from 'zlib';
 import { View } from './view.js';
 import * as vlib from "@vandenberghinc/vlib";
-import { Utils, ExternalError, InternalError } from "./utils.js";
+import { ExternalError, InternalError } from "./errors/internal_external.js";
 import { Status } from "./status.js";
-import { logger } from "./logger.js";
 import { RateLimits } from "./rate_limit.js";
 import { Route } from './route.js';
 import Meta from './meta.js';
-const { log, error, warn } = logger;
 const { debug } = vlib;
 // ---------------------------------------------------------
 // Endpoint
@@ -109,7 +107,6 @@ const { debug } = vlib;
  */
 export class Endpoint {
     // Static attributes.
-    static rate_limits = new Map();
     static compressed_content_types = [
         // Image formats (often already compressed)
         "image/jpeg",
@@ -167,7 +164,7 @@ export class Endpoint {
     /** Requires authentication */
     authenticated;
     /** Parameter scheme validator */
-    params_val;
+    params_schema;
     /** The default response headers */
     headers;
     /** Option 2) View based endpoint */
@@ -175,6 +172,8 @@ export class Endpoint {
     /** Option 3) Data endpoint, raw */
     data;
     raw_data;
+    /** Option 4 Data endpoint by file path. */
+    file_path;
     /** Content length & type */
     content_length;
     content_type;
@@ -188,17 +187,17 @@ export class Endpoint {
     /** Private attributes */
     _compress;
     _cache;
-    _static_path;
-    _templates;
     ip_whitelist;
     _is_compressed;
     _initialized = false;
-    _server;
-    constructor({ method = "GET", endpoint = "/", authenticated = false, rate_limit = undefined, params = undefined, callback = undefined, view = undefined, data = undefined, content_type, // = "text/plain",
-    compress = "auto", cache = true, ip_whitelist = undefined, sitemap = undefined, robots = undefined, allow_unknown_params = false, _templates = {}, // only used in loading static files.
-    _static_path = undefined, _is_static = false, }) {
+    /** A reference to the server. */
+    server;
+    constructor({ method, endpoint, authenticated = false, rate_limit = undefined, params = undefined, compress = "auto", cache = true, ip_whitelist = undefined, sitemap = undefined, robots = undefined, allow_unknown_params = false, _is_static = false, 
+    // mode options.
+    callback = undefined, view = undefined, data = undefined, file_path = undefined, content_type, // = "text/plain",
+     }) {
         // Attributes.
-        this.route = new Route(method, endpoint);
+        this.route = new Route(method ?? "GET", endpoint);
         this.id = this.route.id;
         this.authenticated = authenticated;
         if (this.callback === undefined) { // only assign when undefined, so derived classes can also define the callback function.
@@ -209,8 +208,7 @@ export class Endpoint {
         this._cache = cache;
         this.allow_sitemap = sitemap ?? true;
         this.allow_robots = robots ?? true;
-        this._templates = _templates;
-        this._static_path = _static_path == null ? undefined : new vlib.Path(_static_path).abs().str(); // use abs, is automatically assigned for static files.
+        this.file_path = file_path == null ? file_path : new vlib.Path(file_path).abs();
         this.ip_whitelist = Array.isArray(ip_whitelist) ? ip_whitelist : undefined;
         this.is_static = _is_static;
         this.headers = [];
@@ -265,11 +263,22 @@ export class Endpoint {
         this.rate_limit_groups = [];
         if (Array.isArray(rate_limit)) {
             rate_limit.forEach((item) => {
-                this.rate_limit_groups.push(RateLimits.add(item));
+                if (typeof item === "string") {
+                    const group = RateLimits.groups.get(item);
+                    if (!group)
+                        throw new Error(`Rate limit group "${item}" does not exist.`);
+                    this.rate_limit_groups.push(group);
+                }
+                else {
+                    this.rate_limit_groups.push(RateLimits.add(item));
+                }
             });
         }
         else if (typeof rate_limit === "string") {
-            this.rate_limit_groups.push(RateLimits.add({ group: rate_limit }));
+            const group = RateLimits.groups.get(rate_limit);
+            if (!group)
+                throw new Error(`Rate limit group "${rate_limit}" does not exist.`);
+            this.rate_limit_groups.push(group);
         }
         else if (typeof rate_limit === "object" && rate_limit != null) {
             this.rate_limit_groups.push(RateLimits.add(rate_limit));
@@ -290,9 +299,9 @@ export class Endpoint {
         }
         // Initialize the parameter scheme validator.
         if (params_scheme != null) {
-            this.params_val = new vlib.scheme.Validator("object", {
-                scheme: params,
-                strict: !allow_unknown_params,
+            this.params_schema = new vlib.Schema.Validator({
+                schema: params_scheme,
+                unknown: !allow_unknown_params,
                 parent: this.route.id + ":",
                 throw: false,
             });
@@ -301,7 +310,7 @@ export class Endpoint {
     /** Initialize with server. */
     _initialize(server) {
         // Assign attribute.
-        this._server = server;
+        this.server = server;
         // Initialize view.
         if (this.view != null) {
             this.view._initialize(server, this);
@@ -317,114 +326,42 @@ export class Endpoint {
         }
         return this;
     }
-    /**
-     * Convert a RegExp into a readable path:
-     * - strips ^…$ anchors
-     * - unescapes `\/` → `/`
-     * - `(?<name>…)` → `:name`
-     * - anonymous captures `(…)` → `:param1`, `:param2`, …
-     */
-    _stringify_endpoint_regex(re) {
-        let src = re.source;
-        // 1) strip anchors
-        src = src.replace(/^\^/, "").replace(/\$$/, "");
-        // 2) unescape slashes
-        src = src.replace(/\\\//g, "/");
-        // 3) named capture groups → :name
-        src = src.replace(/\(\?<([^>]+)>[^)]+\)/g, (_match, name) => `:${name}`);
-        // 4) anonymous captures → :paramN
-        let idx = 1;
-        src = src.replace(/\((?!\?)[^)]+\)/g, () => `:param${idx++}`);
-        return src;
-    }
-    // Load data by path.
-    _load_data_by_path(server) {
-        // Load data.
-        const path = new vlib.Path(this._static_path);
-        let data;
-        if (path.extension() === ".js") {
-            data = path.load_sync();
-            // @deprecated compile using vhighlight, now esbuild is used for bundling, callback is not supported yet.
-            // const hash = server.hash(data);
-            // // Check cache for restarts by file watcher.
-            // const {cache_path, cache_hash, cache_data} = Utils.get_compiled_cache(server.domain, "GET", path.str());
-            // if (cache_data && hash === cache_hash) {
-            //     data = cache_data;
-            // }
-            // // Compile.
-            // else {
-            //     const compiler = new vhighlight.JSCompiler({
-            //         line_breaks: true,
-            //         double_line_breaks: false,
-            //         comments: false,
-            //         white_space: false,
-            //     })
-            //     data = compiler.compile_code(data, path.str());
-            //     // Cache for restarts.
-            //     Utils.set_compiled_cache(cache_path, data, hash);
-            // }
-        }
-        else if (path.extension() === ".css") {
-            const minifier = new CleanCSS();
-            data = minifier.minify(path.load_sync()).styles;
-        }
-        else {
-            data = path.load_sync({ type: "buffer" });
-        }
-        // Fill templates.
-        if (this._templates && typeof data === "string") {
-            data = Utils.fill_templates(data, this._templates);
-        }
-        // Assign.
-        this.data = data;
-        return this;
-    }
-    // Set default headers.
-    _set_headers(stream) {
-        this.headers.forEach((item) => {
-            stream.set_header(item[0], item[1]);
-        });
-    }
-    // Refresh for file watcher.
-    async _refresh(server) {
-        // Not in production.
-        if (server.production) {
-            throw new Error("This function is not designed for production mode.");
-        }
-        // Build html code of view.
-        if (this.view != null) {
-            await this.view._build_html();
-        }
-    }
     // Initialize.
     async _dynamic_initialize() {
-        if (!this._server) {
+        if (!this.server) {
             throw new Error(`Endpoint "${this.id}" is not initialized by the server yet.`);
         }
-        // Build html code of view.
-        if (this.view != null) {
-            await this.view._build_html();
+        /**
+         * Load data by file path
+         * @todo in the future we should not load all of the data but just send it to the client in chunks
+         *       but we need to account for compression and content length when implementing this.
+         */
+        if (this.file_path != null) {
+            this._load_data_by_path(this.server);
         }
         // Compression enabled.
-        if (this._server.production && this.callback == null && this._compress) {
+        if (this.server.production && this.callback == null && this._compress) {
             this._is_compressed = true;
             if (this.data != null && (this.data instanceof Buffer || typeof this.data === "string")) {
                 this.raw_data = this.data;
                 this.data = zlib.gzipSync(this.data, { level: zlib.constants.Z_BEST_COMPRESSION });
                 this.content_length = this.data.length;
             }
-            else if (this.view != null) {
-                this.view.raw_html = this.view.html;
-                this.view.html = zlib.gzipSync(this.view.html, { level: zlib.constants.Z_BEST_COMPRESSION });
-                this.content_length = this.view.html.length;
-            }
+            // cant compress view html here since it contains unique nonces.
+            // else if (this.view != null) {
+            //     this.view.raw_html = this.view.html;
+            //     this.view.html = zlib.gzipSync(this.view.html as any, {level: zlib.constants.Z_BEST_COMPRESSION});
+            //     this.content_length = this.view.html.length;
+            // }
             debug(2, this.route.id, ": ", "Compressed - content_length:", this.content_length);
         }
         // Set cache headers.
-        // if (!this._server.production) {
-        this._cache = false; // @todo @tmp
-        // }
-        if ((this.callback == null || this.is_image_endpoint) && (typeof this._cache === "number" || this._cache === true)) {
+        if (!this.server.production) {
+            this._cache = false; // @todo @tmp
+        }
+        if (
+        // (this.callback == null || this.is_image_endpoint) &&
+        (typeof this._cache === "number" || this._cache === true)) {
             if (this._cache === 1 || this._cache === true) {
                 this.headers.push(["Cache-Control", "max-age=86400"]);
             }
@@ -450,6 +387,12 @@ export class Endpoint {
         }
         this._initialized = true;
     }
+    // Set default headers.
+    _set_headers(stream) {
+        this.headers.forEach((item) => {
+            stream.set_header(item[0], item[1]);
+        });
+    }
     // Serve a client.
     async _serve_options(stream) {
         if (!this._initialized) {
@@ -458,14 +401,19 @@ export class Endpoint {
         try {
             // Check IP whitelist.
             if (this.ip_whitelist && !this.ip_whitelist.includes(stream.ip)) {
-                stream.send({
+                stream.error({
                     status: Status.unauthorized,
-                    body: "Unauthorized.",
+                    type: "Unauthorized",
+                    message: "Unauthorized.",
                 });
                 return;
             }
             // Set headers.
             this._set_headers(stream);
+            // Compute content length on view & when not defined.
+            if (this.content_length == null && this.view != null) {
+                stream.set_header("Content-Length", (await this.view.content_length()).toString());
+            }
             // Send.
             stream.send({ status: Status.no_content });
         }
@@ -480,7 +428,7 @@ export class Endpoint {
         try {
             // Check IP whitelist.
             if (this.ip_whitelist && !this.ip_whitelist.includes(stream.ip)) {
-                log(2, this.route.id, ": ", "Blocking ip ", stream.ip, " per ip whitelist.");
+                this.server?.log(2, this.route.id, ": ", "Blocking ip ", stream.ip, " per ip whitelist.");
                 stream.send({
                     status: Status.unauthorized,
                     data: "Unauthorized.",
@@ -491,9 +439,9 @@ export class Endpoint {
             this._set_headers(stream);
             // Callback.
             if (this.callback != null) {
-                log(3, this.route.id, ": ", "Serving endpoint in callback mode.");
-                if (this.params_val != null) {
-                    const { error, invalid_fields } = this.params_val.validate(stream.param);
+                this.server?.log(3, this.route.id, ": ", "Serving endpoint in callback mode.");
+                if (this.params_schema != null) {
+                    const { error, invalid_fields } = this.params_schema.validate(stream.params ?? {});
                     if (error) {
                         stream.send({
                             status: Status.bad_request,
@@ -508,7 +456,7 @@ export class Endpoint {
                 }
                 try {
                     let promise;
-                    if (this.params_val != null) {
+                    if (this.params_schema != null) {
                         promise = this.callback(stream, (stream.params ?? {}));
                     }
                     else {
@@ -530,19 +478,19 @@ export class Endpoint {
                             type: "InternalServerError",
                         });
                     }
-                    error(`${this.id}: `, err); // after sending the response since this edits the error.
+                    this.server?.log.error(`${this.id}: `, err); // after sending the response since this edits the error.
                 }
                 return;
             }
             // View.
             else if (this.view != null) {
-                log(3, this.route.id, ": ", "Serving endpoint in view mode.");
-                this.view._serve(stream, status_code);
+                this.server?.log(3, this.route.id, ": ", "Serving endpoint in view mode.");
+                await this.view._serve(stream, status_code, { compress: this._compress });
                 return;
             }
             // Data.
             else if (this.data != null) {
-                log(3, this.route.id, ": ", "Serving endpoint in data mode.");
+                this.server?.log(3, this.route.id, ": ", "Serving endpoint in data mode.");
                 stream.send({
                     status: status_code,
                     data: this.data,
@@ -558,4 +506,65 @@ export class Endpoint {
             throw err; // must have another catch block here otherwise when an error occurs in here it is somehow not catched by the try and catch block from Server._serve which will cause the program to crash.
         }
     }
+    // Load data by path.
+    _load_data_by_path(server) {
+        if (!this.file_path) {
+            throw new Error(`Endpoint "${this.id}" has no file path assigned.`);
+        }
+        // Load data.
+        const path = new vlib.Path(this.file_path);
+        let data;
+        if (path.extension() === ".js") {
+            data = path.load_sync();
+            // @deprecated compile using vhighlight, now esbuild is used for bundling, callback is not supported yet.
+            // const hash = server.hash(data);
+            // // Check cache for restarts by file watcher.
+            // const {cache_path, cache_hash, cache_data} = Utils.get_compiled_cache(server.domain, "GET", path.str());
+            // if (cache_data && hash === cache_hash) {
+            //     data = cache_data;
+            // }
+            // // Compile.
+            // else {
+            //     const compiler = new vhighlight.JSCompiler({
+            //         line_breaks: true,
+            //         double_line_breaks: false,
+            //         comments: false,
+            //         white_space: false,
+            //     })
+            //     data = compiler.compile_code(data, path.str());
+            //     // Cache for restarts.
+            //     Utils.set_compiled_cache(cache_path, data, hash);
+            // }
+        }
+        else if (path.extension() === ".css") {
+            const minifier = new CleanCSS();
+            data = minifier.minify(path.load_sync()).styles;
+        }
+        else {
+            data = path.load_sync({ type: "buffer" });
+        }
+        // Assign.
+        this.data = data;
+        return this;
+    }
 }
+// const e = new Endpoint({
+//     method: "POST",
+//     endpoint: "/api/docs/feedback",
+//     content_type: "application/json",
+//     params: {
+//         /** The user id. */
+//         uid: "string",
+//         /** The project name. */
+//         project: "string",
+//         /** The project version. */
+//         version: "string",
+//         /** The document id. */
+//         id: "string",
+//         /** Whether the feedback is positive or negative. */
+//         positive: "boolean",
+//     },
+//     rate_limit: "global",
+//     async callback(stream, params) {
+//     }
+// })

package/backend/dist/esm/backend/src/errors/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh.
+ */
+export * from './invalid_usage_error.js';
+export * from './system_error.js';
+export * from './internal_external.js';

package/backend/dist/esm/backend/src/errors/index.js

@@ -0,0 +1,7 @@
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh.
+ */
+export * from './invalid_usage_error.js';
+export * from './system_error.js';
+export * from './internal_external.js';

package/backend/dist/{cjs/utils.d.ts → esm/backend/src/errors/internal_external.d.ts}

@@ -1,4 +1,8 @@
-import type { Stream } from "./stream.js";
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh.
+ */
+import type { Stream } from "../stream.js";
 /**
  * The base class for internal and external errors.
  */
@@ -7,40 +11,28 @@ declare class BaseError extends Error {
     status: number;
     data?: any[] | Record<string, any>;
     invalid_fields: Record<string, string>;
-    constructor({ type, message, status, data, invalid_fields }: {
-        type?: string;
+    constructor({ type, message, status, data, invalid_fields, cause }: {
         message: string;
+        type?: string;
         status?: number;
-        data?: any;
+        data?: any[] | Record<string, any>;
         invalid_fields?: Record<string, string>;
+        cause?: unknown;
     });
     serve(stream: Stream): this;
 }
 /**
- * Thrown external errors are presented to the user.
+ * Thrown internal errors are not presented to the user, isntead an internal server error message is shown.
  */
-export declare class ExternalError extends BaseError {
+export declare class InternalError extends BaseError {
     constructor(args: ConstructorParameters<typeof BaseError>[0]);
     serve(stream: Stream): this;
 }
 /**
- * Thrown internal errors are not presented to the user, isntead an internal server error message is shown.
+ * Thrown external errors are presented to the user.
  */
-export declare class InternalError extends BaseError {
+export declare class ExternalError extends BaseError {
     constructor(args: ConstructorParameters<typeof BaseError>[0]);
     serve(stream: Stream): this;
 }
-interface UtilsInt {
-    "APIError": typeof ExternalError;
-    fill_templates(data: string, templates: Record<string, any>, curly_style?: boolean): string;
-    get_currency_symbol(currency: string): string | null;
-    get_compiled_cache(domain: string, method: string, endpoint: string): {
-        cache_path: any;
-        cache_hash: any;
-        cache_data: any;
-    };
-    set_compiled_cache(path: any, data: string, hash: string): void;
-}
-export declare const Utils: UtilsInt;
-export { Utils as utils };
-export default Utils;
+export {};