@vandenberghinc/volt 1.1.13 → 1.1.15

package/backend/dist/cjs/database.js

@@ -2056,7 +2056,7 @@ class UIDDocument {
             else {
                 id += Object.values(this.path).join("@");
             }
-            throw new utils_js_1.APIError({
+            throw new utils_js_1.InternalError({
                 type: "DocumentNotFound",
                 message: `Requested ${this.error_document_name} "${id}" does not exist.`,
                 status: status_js_1.Status.bad_request,
@@ -2083,7 +2083,7 @@ class UIDDocument {
             else {
                 id += Object.values(this.path).join("@");
             }
-            throw new utils_js_1.APIError({
+            throw new utils_js_1.InternalError({
                 type: "DocumentNotFound",
                 message: `Document "${id}" is not loaded yet.`,
                 status: status_js_1.Status.bad_request,

package/backend/dist/cjs/endpoint.js

@@ -461,7 +461,7 @@ class Endpoint {
                     }
                 }
                 catch (err) {
-                    if (err instanceof utils_js_1.APIError) {
+                    if (err instanceof utils_js_1.ExternalError || err instanceof utils_js_1.InternalError) {
                         err.serve(stream);
                     }
                     else {

package/backend/dist/cjs/payments/paddle.js

@@ -624,7 +624,7 @@ class Paddle {
         }
         // Cancel.
         if (subscription.status !== "active") {
-            throw new utils_js_1.APIError({
+            throw new utils_js_1.ExternalError({
                 type: "NoActiveSubscriptionError",
                 message: `This subscription is already cancelled and will become inactive at the end of the billing period.`,
                 status: status_js_1.Status.bad_request,
@@ -1990,7 +1990,7 @@ class Paddle {
             }
         });
         if (_throw_no_cancelled_err && cancelled.length === 0) {
-            throw new utils_js_1.APIError({
+            throw new utils_js_1.ExternalError({
                 type: "NoCancellableSubscriptions",
                 message: "No cancellable subscriptions found.",
                 status: status_js_1.Status.bad_request,

package/backend/dist/cjs/server.js

@@ -974,14 +974,6 @@ class Server {
         // this.ts = ts as TypeScriptConfig;
         this.endpoints = new Map();
         this.err_endpoints = new Map();
-        // Assign based on localhost.
-        // if (localhost) {
-        //     this.ip = "127.0.0.1";
-        //     this.domain = this.ip + ":" + (port + (this.tls ? 1 : 0));
-        // } else if (!production && !localhost && ip == null)  { // use argument ip not attr since that already has a default.
-        //     this.ip = vlib.Network.private_ip();
-        //     this.domain = this.ip + ":" + (port + (this.tls ? 1 : 0));
-        // }
         /* @performance */ this.performance = new _vinc_1.vlib.Performance("Server performance");
         // Assign objects to server so it is easy to access.
         this.status = status_js_1.Status;

package/backend/dist/cjs/users.js

@@ -44,7 +44,7 @@ const _vinc_1 = require("./vinc.js");
 const utils = __importStar(require("./utils.js"));
 const Mail = __importStar(require("./plugins/mail.js"));
 const status_js_1 = require("./status.js");
-const { APIError } = utils;
+const { ExternalError } = utils;
 const logger_js_1 = require("./logger.js");
 const log_source = logger_js_1.logger.LogSource("Users");
 // interface Server {
@@ -519,7 +519,7 @@ class Users {
                 }
                 // Verify username and email.
                 if (await this.username_exists(params.username)) {
-                    throw new APIError({
+                    throw new ExternalError({
                         type: "UsernameAlreadyExists",
                         message: `Username "${params.username}" is already registered.`,
                         status: status_js_1.Status.bad_request,
@@ -527,7 +527,7 @@ class Users {
                     });
                 }
                 if (await this.email_exists(params.email)) {
-                    throw new APIError({
+                    throw new ExternalError({
                         type: "EmailAlreadyExists",
                         message: `Email "${params.email}" is already registered.`,
                         status: status_js_1.Status.bad_request,
@@ -1151,7 +1151,7 @@ class Users {
         // Check if username & email already exist.
         if (_check_username_email) {
             if (await this.username_exists(username)) {
-                throw new APIError({
+                throw new ExternalError({
                     type: "UsernameAlreadyExists",
                     message: `Username "${username}" is already registered.`,
                     status: status_js_1.Status.bad_request,
@@ -1159,7 +1159,7 @@ class Users {
                 });
             }
             if (await this.email_exists(email)) {
-                throw new APIError({
+                throw new ExternalError({
                     type: "EmailAlreadyExists",
                     message: `Email "${email}" is already registered.`,
                     status: status_js_1.Status.bad_request,

package/backend/dist/cjs/utils.d.ts

@@ -1,8 +1,8 @@
 import type { Stream } from "./stream.js";
 /**
- * The API error class is used to throw an error that will be presented to the user. All other errors will result in an internal server error response without the error's message.
+ * The base class for internal and external errors.
  */
-export declare class APIError extends Error {
+declare class BaseError extends Error {
     type: string;
     status: number;
     data?: any[] | Record<string, any>;
@@ -16,8 +16,22 @@ export declare class APIError extends Error {
     });
     serve(stream: Stream): this;
 }
+/**
+ * Thrown external errors are presented to the user.
+ */
+export declare class ExternalError 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.
+ */
+export declare class InternalError extends BaseError {
+    constructor(args: ConstructorParameters<typeof BaseError>[0]);
+    serve(stream: Stream): this;
+}
 interface UtilsInt {
-    "APIError": typeof APIError;
+    "APIError": typeof ExternalError;
     clean_endpoint(endpoint: undefined): undefined;
     clean_endpoint(endpoint: RegExp): RegExp;
     clean_endpoint(endpoint: string): string;

package/backend/dist/cjs/utils.js

@@ -4,15 +4,15 @@
  * Copyright: © 2022 - 2024 Daan van den Bergh.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.utils = exports.Utils = exports.APIError = void 0;
+exports.utils = exports.Utils = exports.InternalError = exports.ExternalError = void 0;
 const _vinc_1 = require("./vinc.js");
 const status_js_1 = require("./status.js");
 // ---------------------------------------------------------
 // Utils.
 /**
- * The API error class is used to throw an error that will be presented to the user. All other errors will result in an internal server error response without the error's message.
+ * The base class for internal and external errors.
  */
-class APIError extends Error {
+class BaseError extends Error {
     type;
     status;
     data;
@@ -36,11 +36,49 @@ class APIError extends Error {
         return this;
     }
 }
-exports.APIError = APIError;
+/**
+ * Thrown external errors are presented to the user.
+ */
+class ExternalError extends BaseError {
+    constructor(args) {
+        args.type ??= "ExternalError";
+        super(args);
+    }
+    serve(stream) {
+        stream.error({
+            status: this.status ?? status_js_1.Status.internal_server_error,
+            headers: { "Content-Type": "application/json" },
+            message: this.message,
+            type: this.type,
+            invalid_fields: this.invalid_fields,
+        });
+        return this;
+    }
+}
+exports.ExternalError = ExternalError;
+/**
+ * Thrown internal errors are not presented to the user, isntead an internal server error message is shown.
+ */
+class InternalError extends BaseError {
+    constructor(args) {
+        args.type ??= "InternalError";
+        super(args);
+    }
+    serve(stream) {
+        stream.error({
+            status: status_js_1.Status.internal_server_error,
+            headers: { "Content-Type": "application/json" },
+            message: "Internal Server Error",
+            type: "InternalServerError",
+        });
+        return this;
+    }
+}
+exports.InternalError = InternalError;
 // Implementation
 exports.Utils = {
     // An error that may be shown to the frontend user.
-    "APIError": APIError,
+    "APIError": ExternalError,
     // Clean an endpoint url.
     clean_endpoint(endpoint) {
         if (endpoint == null || endpoint instanceof RegExp) {

package/backend/dist/cjs/volt.d.ts

@@ -1,4 +1,4 @@
-export { APIError } from "./utils.js";
+export { ExternalError as APIError } from "./utils.js";
 export * from "./status.js";
 export * from "./meta.js";
 export * from "./splash_screen.js";

package/backend/dist/cjs/volt.js

@@ -45,7 +45,7 @@ exports.TypeScript = exports.Mail = exports.APIError = void 0;
 // Exports.
 // Create volt lib.
 var utils_js_1 = require("./utils.js");
-Object.defineProperty(exports, "APIError", { enumerable: true, get: function () { return utils_js_1.APIError; } });
+Object.defineProperty(exports, "APIError", { enumerable: true, get: function () { return utils_js_1.ExternalError; } });
 __exportStar(require("./status.js"), exports);
 __exportStar(require("./meta.js"), exports);
 __exportStar(require("./splash_screen.js"), exports);

package/backend/dist/esm/database.js

@@ -10,7 +10,7 @@ import { MongoClient, ServerApiVersion } from 'mongodb';
 import { logger, LogSource } from "./logger.js";
 import { Status } from "./status.js";
 import { vlib } from "./vinc.js";
-import { APIError } from "./utils.js";
+import { InternalError } from "./utils.js";
 const log_source = new LogSource("Database");
 // ---------------------------------------------------------
 // Collection.
@@ -2050,7 +2050,7 @@ export class UIDDocument {
             else {
                 id += Object.values(this.path).join("@");
             }
-            throw new APIError({
+            throw new InternalError({
                 type: "DocumentNotFound",
                 message: `Requested ${this.error_document_name} "${id}" does not exist.`,
                 status: Status.bad_request,
@@ -2077,7 +2077,7 @@ export class UIDDocument {
             else {
                 id += Object.values(this.path).join("@");
             }
-            throw new APIError({
+            throw new InternalError({
                 type: "DocumentNotFound",
                 message: `Document "${id}" is not loaded yet.`,
                 status: Status.bad_request,

package/backend/dist/esm/endpoint.js

@@ -8,7 +8,7 @@ import CleanCSS from 'clean-css';
 import zlib from 'zlib';
 import { View } from './view.js';
 import { vlib } from "./vinc.js";
-import { Utils, APIError } from "./utils.js";
+import { Utils, ExternalError, InternalError } from "./utils.js";
 import { Status } from "./status.js";
 import { logger, LogSource } from "./logger.js";
 import { RateLimits } from "./rate_limit.js";
@@ -455,7 +455,7 @@ class Endpoint {
                     }
                 }
                 catch (err) {
-                    if (err instanceof APIError) {
+                    if (err instanceof ExternalError || err instanceof InternalError) {
                         err.serve(stream);
                     }
                     else {

package/backend/dist/esm/payments/paddle.js

@@ -8,7 +8,7 @@ import * as PDFDocument from "pdfkit";
 import * as libcrypto from "crypto";
 import blobstream from 'blob-stream';
 import { vlib } from "../vinc.js";
-import { Utils, APIError } from "../utils.js";
+import { Utils, ExternalError } from "../utils.js";
 import { logger } from "../logger.js";
 import { Status } from "../status.js";
 const log_source = logger.LogSource("Payments");
@@ -585,7 +585,7 @@ export class Paddle {
         }
         // Cancel.
         if (subscription.status !== "active") {
-            throw new APIError({
+            throw new ExternalError({
                 type: "NoActiveSubscriptionError",
                 message: `This subscription is already cancelled and will become inactive at the end of the billing period.`,
                 status: Status.bad_request,
@@ -1951,7 +1951,7 @@ export class Paddle {
             }
         });
         if (_throw_no_cancelled_err && cancelled.length === 0) {
-            throw new APIError({
+            throw new ExternalError({
                 type: "NoCancellableSubscriptions",
                 message: "No cancellable subscriptions found.",
                 status: Status.bad_request,

package/backend/dist/esm/server.js

@@ -935,14 +935,6 @@ export class Server {
         // this.ts = ts as TypeScriptConfig;
         this.endpoints = new Map();
         this.err_endpoints = new Map();
-        // Assign based on localhost.
-        // if (localhost) {
-        //     this.ip = "127.0.0.1";
-        //     this.domain = this.ip + ":" + (port + (this.tls ? 1 : 0));
-        // } else if (!production && !localhost && ip == null)  { // use argument ip not attr since that already has a default.
-        //     this.ip = vlib.Network.private_ip();
-        //     this.domain = this.ip + ":" + (port + (this.tls ? 1 : 0));
-        // }
         /* @performance */ this.performance = new vlib.Performance("Server performance");
         // Assign objects to server so it is easy to access.
         this.status = Status;

package/backend/dist/esm/users.js

@@ -8,7 +8,7 @@ import { vlib } from "./vinc.js";
 import * as utils from "./utils.js";
 import * as Mail from "./plugins/mail.js";
 import { Status } from "./status.js";
-const { APIError } = utils;
+const { ExternalError } = utils;
 import { logger } from "./logger.js";
 const log_source = logger.LogSource("Users");
 // interface Server {
@@ -483,7 +483,7 @@ export class Users {
                 }
                 // Verify username and email.
                 if (await this.username_exists(params.username)) {
-                    throw new APIError({
+                    throw new ExternalError({
                         type: "UsernameAlreadyExists",
                         message: `Username "${params.username}" is already registered.`,
                         status: Status.bad_request,
@@ -491,7 +491,7 @@ export class Users {
                     });
                 }
                 if (await this.email_exists(params.email)) {
-                    throw new APIError({
+                    throw new ExternalError({
                         type: "EmailAlreadyExists",
                         message: `Email "${params.email}" is already registered.`,
                         status: Status.bad_request,
@@ -1115,7 +1115,7 @@ export class Users {
         // Check if username & email already exist.
         if (_check_username_email) {
             if (await this.username_exists(username)) {
-                throw new APIError({
+                throw new ExternalError({
                     type: "UsernameAlreadyExists",
                     message: `Username "${username}" is already registered.`,
                     status: Status.bad_request,
@@ -1123,7 +1123,7 @@ export class Users {
                 });
             }
             if (await this.email_exists(email)) {
-                throw new APIError({
+                throw new ExternalError({
                     type: "EmailAlreadyExists",
                     message: `Email "${email}" is already registered.`,
                     status: Status.bad_request,

package/backend/dist/esm/utils.d.ts

@@ -1,8 +1,8 @@
 import type { Stream } from "./stream.js";
 /**
- * The API error class is used to throw an error that will be presented to the user. All other errors will result in an internal server error response without the error's message.
+ * The base class for internal and external errors.
  */
-export declare class APIError extends Error {
+declare class BaseError extends Error {
     type: string;
     status: number;
     data?: any[] | Record<string, any>;
@@ -16,8 +16,22 @@ export declare class APIError extends Error {
     });
     serve(stream: Stream): this;
 }
+/**
+ * Thrown external errors are presented to the user.
+ */
+export declare class ExternalError 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.
+ */
+export declare class InternalError extends BaseError {
+    constructor(args: ConstructorParameters<typeof BaseError>[0]);
+    serve(stream: Stream): this;
+}
 interface UtilsInt {
-    "APIError": typeof APIError;
+    "APIError": typeof ExternalError;
     clean_endpoint(endpoint: undefined): undefined;
     clean_endpoint(endpoint: RegExp): RegExp;
     clean_endpoint(endpoint: string): string;

package/backend/dist/esm/utils.js

@@ -7,9 +7,9 @@ import { Status } from "./status.js";
 // ---------------------------------------------------------
 // Utils.
 /**
- * The API error class is used to throw an error that will be presented to the user. All other errors will result in an internal server error response without the error's message.
+ * The base class for internal and external errors.
  */
-export class APIError extends Error {
+class BaseError extends Error {
     type;
     status;
     data;
@@ -33,10 +33,47 @@ export class APIError extends Error {
         return this;
     }
 }
+/**
+ * Thrown external errors are presented to the user.
+ */
+export class ExternalError extends BaseError {
+    constructor(args) {
+        args.type ??= "ExternalError";
+        super(args);
+    }
+    serve(stream) {
+        stream.error({
+            status: this.status ?? Status.internal_server_error,
+            headers: { "Content-Type": "application/json" },
+            message: this.message,
+            type: this.type,
+            invalid_fields: this.invalid_fields,
+        });
+        return this;
+    }
+}
+/**
+ * Thrown internal errors are not presented to the user, isntead an internal server error message is shown.
+ */
+export class InternalError extends BaseError {
+    constructor(args) {
+        args.type ??= "InternalError";
+        super(args);
+    }
+    serve(stream) {
+        stream.error({
+            status: Status.internal_server_error,
+            headers: { "Content-Type": "application/json" },
+            message: "Internal Server Error",
+            type: "InternalServerError",
+        });
+        return this;
+    }
+}
 // Implementation
 export const Utils = {
     // An error that may be shown to the frontend user.
-    "APIError": APIError,
+    "APIError": ExternalError,
     // Clean an endpoint url.
     clean_endpoint(endpoint) {
         if (endpoint == null || endpoint instanceof RegExp) {

package/backend/dist/esm/volt.d.ts

@@ -1,4 +1,4 @@
-export { APIError } from "./utils.js";
+export { ExternalError as APIError } from "./utils.js";
 export * from "./status.js";
 export * from "./meta.js";
 export * from "./splash_screen.js";

package/backend/dist/esm/volt.js

@@ -5,7 +5,7 @@
 // ---------------------------------------------------------
 // Exports.
 // Create volt lib.
-export { APIError } from "./utils.js";
+export { ExternalError as APIError } from "./utils.js";
 export * from "./status.js";
 export * from "./meta.js";
 export * from "./splash_screen.js";

package/backend/dist/esm-dev/database.js

@@ -10,7 +10,7 @@ import { MongoClient, ServerApiVersion } from 'mongodb';
 import { logger, LogSource } from "./logger.js";
 import { Status } from "./status.js";
 import { vlib } from "@vinc";
-import { APIError } from "./utils.js";
+import { InternalError } from "./utils.js";
 const log_source = new LogSource("Database");
 // ---------------------------------------------------------
 // Collection.
@@ -2050,7 +2050,7 @@ export class UIDDocument {
             else {
                 id += Object.values(this.path).join("@");
             }
-            throw new APIError({
+            throw new InternalError({
                 type: "DocumentNotFound",
                 message: `Requested ${this.error_document_name} "${id}" does not exist.`,
                 status: Status.bad_request,
@@ -2077,7 +2077,7 @@ export class UIDDocument {
             else {
                 id += Object.values(this.path).join("@");
             }
-            throw new APIError({
+            throw new InternalError({
                 type: "DocumentNotFound",
                 message: `Document "${id}" is not loaded yet.`,
                 status: Status.bad_request,

package/backend/dist/esm-dev/endpoint.js

@@ -8,7 +8,7 @@ import CleanCSS from 'clean-css';
 import zlib from 'zlib';
 import { View } from './view.js';
 import { vlib } from "@vinc";
-import { Utils, APIError } from "./utils.js";
+import { Utils, ExternalError, InternalError } from "./utils.js";
 import { Status } from "./status.js";
 import { logger, LogSource } from "./logger.js";
 import { RateLimits } from "./rate_limit.js";
@@ -455,7 +455,7 @@ class Endpoint {
                     }
                 }
                 catch (err) {
-                    if (err instanceof APIError) {
+                    if (err instanceof ExternalError || err instanceof InternalError) {
                         err.serve(stream);
                     }
                     else {

package/backend/dist/esm-dev/payments/paddle.js

@@ -8,7 +8,7 @@ import * as PDFDocument from "pdfkit";
 import * as libcrypto from "crypto";
 import blobstream from 'blob-stream';
 import { vlib } from "@vinc";
-import { Utils, APIError } from "../utils.js";
+import { Utils, ExternalError } from "../utils.js";
 import { logger } from "../logger.js";
 import { Status } from "../status.js";
 const log_source = logger.LogSource("Payments");
@@ -585,7 +585,7 @@ export class Paddle {
         }
         // Cancel.
         if (subscription.status !== "active") {
-            throw new APIError({
+            throw new ExternalError({
                 type: "NoActiveSubscriptionError",
                 message: `This subscription is already cancelled and will become inactive at the end of the billing period.`,
                 status: Status.bad_request,
@@ -1951,7 +1951,7 @@ export class Paddle {
             }
         });
         if (_throw_no_cancelled_err && cancelled.length === 0) {
-            throw new APIError({
+            throw new ExternalError({
                 type: "NoCancellableSubscriptions",
                 message: "No cancellable subscriptions found.",
                 status: Status.bad_request,

package/backend/dist/esm-dev/server.js

@@ -935,14 +935,6 @@ export class Server {
         // this.ts = ts as TypeScriptConfig;
         this.endpoints = new Map();
         this.err_endpoints = new Map();
-        // Assign based on localhost.
-        // if (localhost) {
-        //     this.ip = "127.0.0.1";
-        //     this.domain = this.ip + ":" + (port + (this.tls ? 1 : 0));
-        // } else if (!production && !localhost && ip == null)  { // use argument ip not attr since that already has a default.
-        //     this.ip = vlib.Network.private_ip();
-        //     this.domain = this.ip + ":" + (port + (this.tls ? 1 : 0));
-        // }
         /* @performance */ this.performance = new vlib.Performance("Server performance");
         // Assign objects to server so it is easy to access.
         this.status = Status;

package/backend/dist/esm-dev/users.js

@@ -8,7 +8,7 @@ import { vlib } from "@vinc";
 import * as utils from "./utils.js";
 import * as Mail from "./plugins/mail.js";
 import { Status } from "./status.js";
-const { APIError } = utils;
+const { ExternalError } = utils;
 import { logger } from "./logger.js";
 const log_source = logger.LogSource("Users");
 // interface Server {
@@ -483,7 +483,7 @@ export class Users {
                 }
                 // Verify username and email.
                 if (await this.username_exists(params.username)) {
-                    throw new APIError({
+                    throw new ExternalError({
                         type: "UsernameAlreadyExists",
                         message: `Username "${params.username}" is already registered.`,
                         status: Status.bad_request,
@@ -491,7 +491,7 @@ export class Users {
                     });
                 }
                 if (await this.email_exists(params.email)) {
-                    throw new APIError({
+                    throw new ExternalError({
                         type: "EmailAlreadyExists",
                         message: `Email "${params.email}" is already registered.`,
                         status: Status.bad_request,
@@ -1115,7 +1115,7 @@ export class Users {
         // Check if username & email already exist.
         if (_check_username_email) {
             if (await this.username_exists(username)) {
-                throw new APIError({
+                throw new ExternalError({
                     type: "UsernameAlreadyExists",
                     message: `Username "${username}" is already registered.`,
                     status: Status.bad_request,
@@ -1123,7 +1123,7 @@ export class Users {
                 });
             }
             if (await this.email_exists(email)) {
-                throw new APIError({
+                throw new ExternalError({
                     type: "EmailAlreadyExists",
                     message: `Email "${email}" is already registered.`,
                     status: Status.bad_request,

package/backend/dist/esm-dev/utils.d.ts

@@ -1,8 +1,8 @@
 import type { Stream } from "./stream.js";
 /**
- * The API error class is used to throw an error that will be presented to the user. All other errors will result in an internal server error response without the error's message.
+ * The base class for internal and external errors.
  */
-export declare class APIError extends Error {
+declare class BaseError extends Error {
     type: string;
     status: number;
     data?: any[] | Record<string, any>;
@@ -16,8 +16,22 @@ export declare class APIError extends Error {
     });
     serve(stream: Stream): this;
 }
+/**
+ * Thrown external errors are presented to the user.
+ */
+export declare class ExternalError 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.
+ */
+export declare class InternalError extends BaseError {
+    constructor(args: ConstructorParameters<typeof BaseError>[0]);
+    serve(stream: Stream): this;
+}
 interface UtilsInt {
-    "APIError": typeof APIError;
+    "APIError": typeof ExternalError;
     clean_endpoint(endpoint: undefined): undefined;
     clean_endpoint(endpoint: RegExp): RegExp;
     clean_endpoint(endpoint: string): string;

package/backend/dist/esm-dev/utils.js

@@ -7,9 +7,9 @@ import { Status } from "./status.js";
 // ---------------------------------------------------------
 // Utils.
 /**
- * The API error class is used to throw an error that will be presented to the user. All other errors will result in an internal server error response without the error's message.
+ * The base class for internal and external errors.
  */
-export class APIError extends Error {
+class BaseError extends Error {
     type;
     status;
     data;
@@ -33,10 +33,47 @@ export class APIError extends Error {
         return this;
     }
 }
+/**
+ * Thrown external errors are presented to the user.
+ */
+export class ExternalError extends BaseError {
+    constructor(args) {
+        args.type ??= "ExternalError";
+        super(args);
+    }
+    serve(stream) {
+        stream.error({
+            status: this.status ?? Status.internal_server_error,
+            headers: { "Content-Type": "application/json" },
+            message: this.message,
+            type: this.type,
+            invalid_fields: this.invalid_fields,
+        });
+        return this;
+    }
+}
+/**
+ * Thrown internal errors are not presented to the user, isntead an internal server error message is shown.
+ */
+export class InternalError extends BaseError {
+    constructor(args) {
+        args.type ??= "InternalError";
+        super(args);
+    }
+    serve(stream) {
+        stream.error({
+            status: Status.internal_server_error,
+            headers: { "Content-Type": "application/json" },
+            message: "Internal Server Error",
+            type: "InternalServerError",
+        });
+        return this;
+    }
+}
 // Implementation
 export const Utils = {
     // An error that may be shown to the frontend user.
-    "APIError": APIError,
+    "APIError": ExternalError,
     // Clean an endpoint url.
     clean_endpoint(endpoint) {
         if (endpoint == null || endpoint instanceof RegExp) {

package/backend/dist/esm-dev/volt.d.ts

@@ -1,4 +1,4 @@
-export { APIError } from "./utils.js";
+export { ExternalError as APIError } from "./utils.js";
 export * from "./status.js";
 export * from "./meta.js";
 export * from "./splash_screen.js";

package/backend/dist/esm-dev/volt.js

@@ -5,7 +5,7 @@
 // ---------------------------------------------------------
 // Exports.
 // Create volt lib.
-export { APIError } from "./utils.js";
+export { ExternalError as APIError } from "./utils.js";
 export * from "./status.js";
 export * from "./meta.js";
 export * from "./splash_screen.js";

package/backend/src/database.ts

@@ -14,7 +14,7 @@ import { logger, LogSource } from "./logger.js";
 import { Status } from "./status.js";
 import { vlib } from "@vinc";
 import { resolve } from "path";
-import { APIError } from "./utils.js";
+import { InternalError } from "./utils.js";
 
 const log_source = new LogSource("Database")
 
@@ -2311,7 +2311,7 @@ export class UIDDocument<DocumentOptions = any> {
             } else {
                 id += Object.values(this.path).join("@");
             }
-            throw new APIError({
+            throw new InternalError({
                 type: "DocumentNotFound",
                 message: `Requested ${this.error_document_name} "${id}" does not exist.`,
                 status: Status.bad_request,
@@ -2342,7 +2342,7 @@ export class UIDDocument<DocumentOptions = any> {
             } else {
                 id += Object.values(this.path).join("@");
             }
-            throw new APIError({
+            throw new InternalError({
                 type: "DocumentNotFound",
                 message: `Document "${id}" is not loaded yet.`,
                 status: Status.bad_request,

package/backend/src/endpoint.ts

@@ -11,7 +11,7 @@ import zlib from 'zlib';
 import { View } from './view.js';
 import { vlib } from "@vinc";
 import { vhighlight } from "@vinc";
-import { Utils, APIError } from "./utils.js";
+import { Utils, ExternalError, InternalError } from "./utils.js";
 import { Status } from "./status.js";
 import { logger, LogSource } from "./logger.js";
 import { RateLimits, RateLimitGroup } from "./rate_limit.js";
@@ -540,7 +540,7 @@ class Endpoint {
                         await promise;
                     }
                 } catch (err: any) {
-                    if (err instanceof APIError) { 
+                    if (err instanceof ExternalError || err instanceof InternalError) { 
                         err.serve(stream);
                     } else {
                         stream.error({

package/backend/src/payments/paddle.ts

@@ -12,7 +12,7 @@ import blobstream from 'blob-stream';
 
 
 import { vlib } from "@vinc";
-import { Utils, APIError } from "../utils.js";
+import { Utils, ExternalError } from "../utils.js";
 import { logger } from "../logger.js";
 import { Status } from "../status.js";
 
@@ -732,7 +732,7 @@ export class Paddle {
 
         // Cancel.
         if (subscription.status !== "active") {
-            throw new APIError({
+            throw new ExternalError({
                 type: "NoActiveSubscriptionError",
                 message: `This subscription is already cancelled and will become inactive at the end of the billing period.`,
                 status: Status.bad_request,
@@ -2322,7 +2322,7 @@ export class Paddle {
             }
         });
         if (_throw_no_cancelled_err && cancelled.length === 0) {
-            throw new APIError({
+            throw new ExternalError({
                 type: "NoCancellableSubscriptions",
                 message: "No cancellable subscriptions found.",
                 status: Status.bad_request,

package/backend/src/server.ts

@@ -20,7 +20,7 @@ import CleanCSS from 'clean-css';
 
 import { vlib } from "@vinc";
 import { vhighlight } from "@vinc";
-import { Utils, APIError } from "./utils.js";
+import { Utils, ExternalError } from "./utils.js";
 import { Meta } from './meta.js';
 import * as Mail from './plugins/mail.js';
 import { Status } from "./status.js";
@@ -1121,15 +1121,6 @@ export class Server {
         this.endpoints = new Map();
         this.err_endpoints = new Map();
 
-        // Assign based on localhost.
-        // if (localhost) {
-        //     this.ip = "127.0.0.1";
-        //     this.domain = this.ip + ":" + (port + (this.tls ? 1 : 0));
-        // } else if (!production && !localhost && ip == null)  { // use argument ip not attr since that already has a default.
-        //     this.ip = vlib.Network.private_ip();
-        //     this.domain = this.ip + ":" + (port + (this.tls ? 1 : 0));
-        // }
-
         /* @performance */ this.performance = new vlib.Performance("Server performance");
 
         // Assign objects to server so it is easy to access.

package/backend/src/users.ts

@@ -11,7 +11,7 @@ import { vhighlight } from "@vinc";
 import * as utils from "./utils.js";
 import * as Mail from "./plugins/mail.js";
 import { Status } from "./status.js";
-const { APIError } = utils;
+const { ExternalError } = utils;
 import { logger } from "./logger.js";
 import { Stream, AuthStream } from "./stream.js"
 import { Server, MailAttachment } from "./server.js"
@@ -553,7 +553,7 @@ export class Users {
 
                     // Verify username and email.
                     if (await this.username_exists(params.username)) {
-                        throw new APIError({
+                        throw new ExternalError({
                             type: "UsernameAlreadyExists",
                             message: `Username "${params.username}" is already registered.`,
                             status: Status.bad_request,
@@ -561,7 +561,7 @@ export class Users {
                         });
                     }
                     if (await this.email_exists(params.email)) {
-                        throw new APIError({
+                        throw new ExternalError({
                             type: "EmailAlreadyExists",
                             message: `Email "${params.email}" is already registered.`,
                             status: Status.bad_request,
@@ -1255,7 +1255,7 @@ export class Users {
         // Check if username & email already exist.
         if (_check_username_email) {
             if (await this.username_exists(username)) {
-                throw new APIError({
+                throw new ExternalError({
                     type: "UsernameAlreadyExists",
                     message: `Username "${username}" is already registered.`,
                     status: Status.bad_request,
@@ -1263,7 +1263,7 @@ export class Users {
                 });
             }
             if (await this.email_exists(email)) {
-                throw new APIError({
+                throw new ExternalError({
                     type: "EmailAlreadyExists",
                     message: `Email "${email}" is already registered.`,
                     status: Status.bad_request,

package/backend/src/utils.ts

@@ -15,9 +15,9 @@ import type { Stream } from "./stream.js";
 // Utils.
 
 /**
- * The API error class is used to throw an error that will be presented to the user. All other errors will result in an internal server error response without the error's message.
+ * The base class for internal and external errors.
  */
-export class APIError extends Error {
+class BaseError extends Error {
     public type: string;
     public status: number;
     public data?: any[] | Record<string, any>;
@@ -48,6 +48,45 @@ export class APIError extends Error {
     }
 }
 
+/**
+ * Thrown external errors are presented to the user.
+ */
+export class ExternalError extends BaseError {
+    constructor(args: ConstructorParameters<typeof BaseError>[0]) {
+        args.type ??= "ExternalError";
+        super(args);
+    }
+    serve(stream: Stream) {
+        stream.error({
+            status: this.status ?? Status.internal_server_error,
+            headers: { "Content-Type": "application/json" },
+            message: this.message,
+            type: this.type,
+            invalid_fields: this.invalid_fields,
+        });
+        return this;
+    }
+}
+
+/**
+ * Thrown internal errors are not presented to the user, isntead an internal server error message is shown.
+ */
+export class InternalError extends BaseError {
+    constructor(args: ConstructorParameters<typeof BaseError>[0]) {
+        args.type ??= "InternalError";
+        super(args);
+    }
+    serve(stream: Stream) {
+        stream.error({
+            status: Status.internal_server_error,
+            headers: { "Content-Type": "application/json" },
+            message: "Internal Server Error",
+            type: "InternalServerError",
+        });
+        return this;
+    }
+}
+
 /*  @docs:
  *  @nav: Backend
     @parent: Utils
@@ -119,7 +158,7 @@ export class APIError extends Error {
 
 // Define interface with overloads
 interface UtilsInt {
-    "APIError": typeof APIError;  // Replace with actual type
+    "APIError": typeof ExternalError;  // Replace with actual type
     
     // Overload signatures in interface
     clean_endpoint(endpoint: undefined): undefined;
@@ -136,7 +175,7 @@ interface UtilsInt {
 export const Utils: UtilsInt = {
 
     // An error that may be shown to the frontend user.
-    "APIError": APIError,
+    "APIError": ExternalError,
 
     // Clean an endpoint url.
     clean_endpoint(endpoint) {

package/backend/src/volt.ts

@@ -7,7 +7,7 @@
 // Exports.
 
 // Create volt lib.
-export { APIError } from "./utils.js"
+export { ExternalError as APIError } from "./utils.js"
 export * from "./status.js"
 export * from "./meta.js"
 export * from "./splash_screen.js"

package/package.json

@@ -1,7 +1,7 @@
 {
     "author": "Daan van den Bergh",
     "name": "@vandenberghinc/volt",
-    "version": "1.1.13",
+    "version": "1.1.15",
     "description": "",
     "type": "module",
     "types": "./backend/dist/esm/volt.d.ts",