@vandenberghinc/volt 1.1.26 → 1.1.28

package/backend/dist/cjs/backend/src/view.js

@@ -0,0 +1,508 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var stdin_exports = {};
+__export(stdin_exports, {
+  View: () => View
+});
+module.exports = __toCommonJS(stdin_exports);
+var vlib = __toESM(require("@vandenberghinc/vlib"));
+var vts = __toESM(require("@vandenberghinc/vlib/vts"));
+var vhighlight = __toESM(require("@vandenberghinc/vhighlight"));
+var import_zlib = __toESM(require("zlib"));
+var import_meta = require("./meta.js");
+var import_route = require("./route.js");
+var import_frontend = require("./frontend.js");
+var crypto = __toESM(require("crypto"));
+const { debug } = vlib;
+class View {
+  // Global settings.
+  static includes = [];
+  static links = [];
+  static body_style = null;
+  // css string style.
+  static splash_screen = void 0;
+  // SplashScreen object.
+  // Private static attributes,
+  static _volt_css;
+  static _vhighlight_css;
+  // Attributes.
+  source;
+  source_path;
+  callback;
+  includes;
+  links;
+  templates;
+  meta;
+  jquery;
+  lang;
+  body_style;
+  splash_screen;
+  tree_shaking;
+  mangle;
+  _src;
+  _embedded_sources;
+  is_js_ts_view;
+  _html;
+  raw_html;
+  _bundle;
+  payments;
+  // vhighlight?: string | undefined;
+  min_device_width;
+  server;
+  endpoint;
+  // Constructor.
+  constructor({ source = null, callback = null, includes = [], links = [], templates = {}, meta = new import_meta.Meta(), jquery = false, lang = "en", body_style = null, splash_screen = void 0, tree_shaking = false, mangle = false, min_device_width = 600, _src }) {
+    this.source = source;
+    this.callback = callback;
+    this.includes = [...View.includes, ...includes];
+    this.links = [...View.links, ...links];
+    this.templates = templates;
+    this.meta = meta;
+    this.jquery = jquery;
+    this.lang = lang;
+    this.body_style = body_style ?? View.body_style;
+    this.splash_screen = splash_screen ?? View.splash_screen;
+    this.tree_shaking = tree_shaking;
+    this.mangle = mangle;
+    this.min_device_width = min_device_width;
+    this._src = _src;
+    this._embedded_sources = [];
+    if (this.source != null) {
+      this.source_path = new vlib.Path(this.source);
+      if (!this.source_path.exists()) {
+        throw new Error(`Defined source path "${this.source}" does not exist.`);
+      }
+      this.source_path = this.source_path.abs();
+      this.source = this.source_path.str();
+    }
+    this.is_js_ts_view = this.source_path != null && /\.(jsx?|tsx?)/.test(this.source_path.extension());
+    if (typeof source !== "string" && typeof callback !== "function") {
+      throw Error('Invalid usage, define either parameter "source" or "callback".');
+    }
+    this.includes = vlib.Array.drop_duplicates(this.includes);
+    this._html = void 0;
+    this._bundle = void 0;
+  }
+  // Initialize.
+  _initialize(server, endpoint) {
+    if (server === void 0) {
+      throw Error('Invalid usage, define parameter "server".');
+    }
+    if (endpoint === void 0) {
+      throw Error('Invalid usage, define parameter "endpoint".');
+    }
+    this.server = server;
+    this.endpoint = endpoint;
+  }
+  // Bundle the compiled typescript / javascript dynamically on demand to optimize server startup for development purposes.
+  async _dynamic_bundle() {
+    if (this.server === void 0 || this.endpoint === void 0) {
+      throw Error('View has not been initialized with "View._initialize()" yet.');
+    }
+    debug(3, this.endpoint?.route?.id, `: Bundling entry path "${this.source_path?.str()}".`);
+    this._bundle = await vts.bundle({
+      include: this.source_path ? [this.source_path?.str()] : [],
+      output: `/tmp/${this.endpoint.route.method}_${this.source_path.str().replace(/\//g, "_")}.js`,
+      // esbuild requires an output path to resolve .css and .ttf files etc which can be imported by libraries (such as monaco-editor).
+      minify: false,
+      //this._server.production,
+      platform: "browser",
+      format: "esm",
+      // format: "iife", // can causes issues with node_modules imports.
+      target: "es2022",
+      // sourcemap: this.server.production ? false : "inline",
+      extract_inputs: true,
+      // since bundle.inputs is used by server.js.
+      tree_shaking: true
+    });
+    this.payments = this._bundle.inputs.find((path) => path.endsWith("/modules/paddle.js"));
+  }
+  /** Ensure the view is bundled when required. */
+  async ensure_bundle() {
+    if (this.is_js_ts_view && !this._bundle) {
+      return this._dynamic_bundle();
+    }
+  }
+  /** Create an error HTML file when errors are encountered during the bundle process. */
+  async _build_bundle_err_html() {
+    if (this.server?.production) {
+      throw new Error("Encountered an error while bundling in production.");
+    }
+    const nonce_identifier = "{{__VOLT_NONCE__}}";
+    const bundle = await vts.inspect_bundle({
+      include: this.source_path ? [this.source_path?.str()] : [],
+      output: vlib.Path.tmp().join(`${this.endpoint?.route.method}_${this.source_path.str().replace(/\//g, "_")}.js`),
+      // esbuild requires an output path to resolve .css and .ttf files etc which can be imported by libraries (such as monaco-editor).
+      minify: false,
+      //this._server.production,
+      platform: "browser",
+      format: "esm",
+      // format: "iife", // can causes issues with node_modules imports.
+      target: "es2022",
+      tree_shaking: true
+    });
+    this.server?.log.error(this.endpoint?.route?.id, `: Encountered an error while bundling "${this.source}".
+${bundle.debug({ limit: 25 })}`);
+    const escape_html = (str) => vlib.Color.to_html(str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;"));
+    if (this.server?.production) {
+      this._html = `
+                <!DOCTYPE html>
+                <html lang='${this.lang}'>
+                <head>
+                    <meta charset="UTF-8">
+                    <meta name="viewport" content="width=device-width, initial-scale=1">
+                    <title>Bundling Error</title>
+                    <style nonce="${nonce_identifier}">
+                        body {
+                            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; padding: 2rem; background: #f5f5f5;
+                        }
+                        h1 {
+                            color: #d32f2f; margin-top: 0;
+                        }
+                        #error-container {
+                            max-width: 800px; margin: 0 auto; background: white; padding: 2rem; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+                        }
+                    </style>
+                </head>
+                <body>
+                    <div id="error-container">
+                        <h1>Bundling Error</h1>
+                        <p>An error occurred while processing your request. Please contact support if this issue persists.</p>
+                    </div>
+                </body>
+                </html>
+                `.dedent(false);
+    } else {
+      const formatted_import_chains = bundle.format_import_chains();
+      const formatted_errors = bundle.format_errors();
+      this._html = `
+                <!DOCTYPE html>
+                <html lang='${this.lang}'>
+                <head>
+                    <meta charset="UTF-8">
+                    <meta name="viewport" content="width=device-width, initial-scale=1">
+                    <title>Bundling Error - ${escape_html(this.source || "Unknown")}</title>
+                    <style nonce="${nonce_identifier}">
+                        body {
+                            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+                            margin: 0;
+                            padding: 1rem;
+                            background: #1e1e1e;
+                            color: #d4d4d4;
+                        }
+                        .container {
+                            max-width: 1200px;
+                            margin: 0 auto;
+                        }
+                        h1 {
+                            color: #FFFFFF;
+                            font-size: 1.5rem;
+                            margin-bottom: 0.5rem;
+                        }
+                        .source {
+                            color: #C0C0C0;
+                            font-family: ui-monospace, SFMono-Regular, "SF Mono", Consolas, "Liberation Mono", Menlo, monospace;
+                            font-size: 0.875rem;
+                            margin-bottom: 1rem;
+                        }
+                        pre {
+                            background: #2d2d2d;
+                            border: 1px solid #3e3e3e;
+                            border-radius: 4px;
+                            padding: 1rem;
+                            overflow-x: auto;
+                            font-family: ui-monospace, SFMono-Regular, "SF Mono", Consolas, "Liberation Mono", Menlo, monospace;
+                            font-size: 0.875rem;
+                            line-height: 1.5;
+                            margin: 20px 0px 0px 0px;
+                        }
+                        .error-count {
+                            background: #f44336;
+                            color: white;
+                            padding: 0.25rem 0.5rem;
+                            border-radius: 4px;
+                            font-size: 0.875rem;
+                            display: inline-block;
+                            margin-bottom: 1rem;
+                        }
+                    </style>
+                </head>
+                <body>
+                    <div class="container">
+                        <h1>Bundle Error</h1>
+                        <div class="source">Source: ${escape_html(this.source || "Unknown")}</div>
+                        <div class="error-count">${bundle.errors.length} error${bundle.errors.length === 1 ? "" : "s"}</div>
+                        <pre>${escape_html(bundle.debug({ limit: -1 }))}</pre>
+                        <!--<h2>Metafile</h2>
+                        <pre>${escape_html(bundle.metafile ?? "No metafile detected.")}</pre>
+                        <h2>Input files</h2>
+                        <pre>${escape_html(bundle.inputs.length ? bundle.inputs.join("\n") : "No input files detected.")}</pre>
+                        <h2>Import Chains</h2>
+                        <pre>${escape_html(formatted_import_chains.length ? formatted_import_chains.join("\n") : "No import chains detected.")}</pre>
+                        <h2>Encountered Errors</h2>
+                        <pre>${escape_html(formatted_errors.length ? formatted_errors.join("\n") : "No errors detected.")}</pre>
+                        -->
+                    </div>
+                </body>
+                </html>
+                `.dedent(false);
+    }
+    this.html_nonce_split = this._html.split(nonce_identifier);
+  }
+  // Build html.
+  async _build_html() {
+    const nonce_identifier = "{{__VOLT_NONCE__}}";
+    if (this.server == null || this.endpoint == null) {
+      throw Error('View has not been initialized with "View._initialize()" yet.');
+    }
+    if (this.is_js_ts_view && !this._bundle) {
+      await this._dynamic_bundle();
+    }
+    if (this._bundle != null && this._bundle.errors.length > 0) {
+      return this._build_bundle_err_html();
+    }
+    const line_break = this.server.production ? "\n" : "\n";
+    const has_bundle = this._bundle != null && typeof this._bundle === "object";
+    this._html = "";
+    this._html += `<!DOCTYPE html><html lang='${this.lang}'>${line_break}`;
+    this._html += `<head>${line_break}`;
+    if (this.meta) {
+      this._html += this.meta.build_html(this.server.full_domain) + line_break;
+    }
+    this._html += `<style nonce="${nonce_identifier}">html { min-width:100%;min-height:100%; }body { width:100vw;height:100vh;margin:0;padding:0;${this.body_style ?? ""} }</style>${line_break}`;
+    const embed_stylesheet = (url, embed) => {
+      if (embed == null && url != null && url.charAt(0) === "/") {
+        for (const endpoint of this.server.endpoints.values()) {
+          if (url === endpoint.route.endpoint_str) {
+            if (typeof endpoint.raw_data === "string") {
+              embed = endpoint.raw_data;
+            } else if (typeof endpoint.data === "string") {
+              embed = endpoint.data;
+            }
+            break;
+          }
+        }
+      }
+      if (embed) {
+        this._html += `<style nonce="${nonce_identifier}">${line_break}${embed}${line_break}</style>${line_break}`;
+        if (url) {
+          this._embedded_sources.push(url);
+        }
+        return true;
+      }
+      return false;
+    };
+    let include_links_script = null;
+    const include_link_async = (link) => {
+      if (include_links_script == null) {
+        include_links_script = "async function __incl_lnk(args){var link = document.createElement('link');for (let key in args) {if (args.hasOwnProperty(key)){link.setAttribute(key,args[key])}}document.head.appendChild(link)}" + line_break;
+      }
+      if (link.rel == null) {
+        link.rel = "stylesheet";
+      }
+      include_links_script += `__incl_lnk(${JSON.stringify(link)});${line_break}`;
+    };
+    if (!View._volt_css) {
+      View._volt_css = await new vlib.Path(import_frontend.Frontend.css.volt).load();
+    }
+    if (!View._vhighlight_css) {
+      View._vhighlight_css = await new vlib.Path(vhighlight.web_exports.css).load();
+    }
+    embed_stylesheet(void 0, View._volt_css);
+    embed_stylesheet(void 0, View._vhighlight_css);
+    if (this.min_device_width != null) {
+      this._html += `
+                <script nonce="${nonce_identifier}">
+                let has_min_width = false;
+                const viewport = document.querySelector('meta[name="viewport"]');
+                function set_min_width() {
+                    const device_width = window.innerWidth;
+                    // console.log("Device width [" + device_width + "] below min_device_width [${this.min_device_width} =", (device_width <= ${this.min_device_width}).toString() + "]");
+                    if (device_width <= ${this.min_device_width}) {
+                        const content = 'width=${this.min_device_width}, initial-scale=' + (device_width / ${this.min_device_width});
+                        // console.log("Below ${this.min_device_width}", {content, width: device_width, has_min_width, viewport: viewport.getAttribute('content')});
+                        if (viewport.getAttribute('content') !== content) {
+                            // console.log('set min width viewport', device_width, device_width / ${this.min_device_width})
+                            viewport.setAttribute('content', content);
+                            has_min_width = true;
+                        }
+                    } else if (has_min_width) {
+                        // console.log('disable min width viewport', device_width)
+                        viewport.setAttribute('content', 'width=device-width, initial-scale=1');
+                        has_min_width = false;
+                    }
+                }
+                let timeout_load; window.addEventListener('load', () => {clearTimeout(timeout_load); timeout_load = setTimeout(set_min_width, 25); } );
+                let timeout_resize; window.addEventListener('resize', () => {clearTimeout(timeout_resize); timeout_resize = setTimeout(set_min_width, 25); } );
+                set_min_width();
+                </script>
+            `.dedent();
+    }
+    this.links.forEach((url) => {
+      if (typeof url === "string") {
+        this._html += `<link rel="stylesheet" href="${url}">`;
+      } else if (typeof url === "object") {
+        if (typeof url === "object" && url.rel === "stylesheet" && url.embed !== true && typeof url.href === "string" && embed_stylesheet(import_route.Route.clean_endpoint(url.href))) {
+        } else {
+          if (url.async) {
+            include_link_async(url);
+          } else {
+            this._html += "<link";
+            Object.keys(url).forEach((key) => {
+              if (key !== "embed") {
+                this._html += ` ${key}="${url[key]}"`;
+              }
+            });
+            this._html += ">" + line_break;
+          }
+        }
+      } else {
+        throw Error('Invalid type for a css include, the valid value types are "string" and "object".');
+      }
+    });
+    if (include_links_script) {
+      this._html += `<script nonce="${nonce_identifier}">${line_break}${include_links_script}${line_break}</script>${line_break}`;
+    }
+    this._html += "</head>" + line_break;
+    this._html += "<body id='body'>";
+    if (this.splash_screen != null) {
+      this._html += this.splash_screen.html + line_break;
+    }
+    const embed_script = (url) => {
+      let embed;
+      for (const endpoint of this.server.endpoints.values()) {
+        if (url === endpoint.route.endpoint_str && (endpoint.raw_data != null || endpoint.data != null)) {
+          embed = endpoint;
+        }
+      }
+      if (embed && (embed.raw_data || embed.data)) {
+        if (embed.content_type === "application/javascript") {
+          this._html += `<script nonce="${nonce_identifier}">${line_break}${embed.raw_data || embed.data}${line_break}</script>${line_break}`;
+        } else {
+          this._html += `<script nonce="${nonce_identifier}" type='${embed.content_type}'>${line_break}${embed.raw_data || embed.data}${line_break}</script>${line_break}`;
+        }
+        this._embedded_sources.push(url);
+        return true;
+      }
+      return false;
+    };
+    let include_js_script = `async function __volt_incl_js(url, async = true) {var script=document.createElement('script');if(async){script.async = true;}script.src=url;document.head.appendChild(script);};${line_break}`;
+    if (this.jquery) {
+      this._html += `<script nonce="${nonce_identifier}" src='https://ajax.googleapis.com/ajax/libs/jquery/3.6.4/jquery.min.js'></script>${line_break}`;
+    }
+    if (this.server.google_tag !== void 0) {
+      include_js_script += `__volt_incl_js("https://www.googletagmanager.com/gtag/js?id=${this.server.google_tag}");${line_break}`;
+    }
+    this._html += `<script nonce="${nonce_identifier}">${line_break}window.volt_statics_aspect_ratios = ${JSON.stringify(Object.fromEntries(this.server.statics_aspect_ratios))}${line_break}</script>${line_break}`;
+    if (this.server.payments) {
+      if (this.server.payments.type === "paddle") {
+        if (this.payments) {
+          include_js_script += `__volt_incl_js("https://cdn.paddle.com/paddle/v2/paddle.js");${line_break}`;
+        }
+      }
+    }
+    this._html += `<script nonce="${nonce_identifier}">${line_break}${include_js_script.trimEnd()}${line_break}</script>${line_break}`;
+    this.includes.forEach((url) => {
+      if (typeof url === "string" && embed_script(url)) {
+      } else {
+        if (typeof url === "string") {
+          this._html += `<script nonce="${nonce_identifier}" src='${url}'></script>${line_break}`;
+        } else if (typeof url === "object") {
+          this._html += `<script nonce="${nonce_identifier}"`;
+          Object.keys(url).forEach((key) => {
+            if (key !== "embed") {
+              this._html += ` ${key}="${url[key]}"`;
+            }
+          });
+          this._html += "></script>" + line_break;
+        } else {
+          throw Error('Invalid type for a js include, the valid value types are "string" and "object".');
+        }
+      }
+    });
+    if (has_bundle && this._bundle != null && typeof this._bundle.code === "string") {
+      this._html += `<script nonce="${nonce_identifier}" type='module'>${line_break}${this._bundle.code}${line_break}</script>${line_break}`;
+    } else if (typeof this.source === "string") {
+      this._html += `<script nonce="${nonce_identifier}">${line_break}${await new vlib.Path(this.source).load()}${line_break}</script>${line_break}`;
+    } else if (this.callback != null) {
+      let code = this.callback.toString();
+      this._html += `<script nonce="${nonce_identifier}">${line_break}(${code})()${line_break}</script>${line_break}`;
+    }
+    this._html += "</body>" + line_break;
+    this._html += "</html>" + line_break;
+    this.html_nonce_split = this._html.split(nonce_identifier);
+  }
+  /** Retrieve the content length of the built html. */
+  async content_length() {
+    const nonce = crypto.randomBytes(16).toString("base64");
+    if (!this._html) {
+      await this._build_html();
+    }
+    let html = this.html_nonce_split.join(nonce);
+    return html.length;
+  }
+  /** Retrieve the HTML. */
+  async html(opts) {
+    const nonce = crypto.randomBytes(16).toString("base64");
+    if (!this._html) {
+      await this._build_html();
+    }
+    let html = this.html_nonce_split.join(nonce);
+    const content_length = Buffer.byteLength(html, "utf-8");
+    if (opts?.compress) {
+      html = import_zlib.default.gzipSync(html, { level: import_zlib.default.constants.Z_BEST_COMPRESSION });
+    }
+    return {
+      html,
+      content_length,
+      nonce
+    };
+  }
+  // Serve a client.
+  async _serve(stream, status_code = 200, opts) {
+    debug(2, this.endpoint?.route?.id, ": Serving HTML ", this._html?.slice(0, 50), "...");
+    const html = await this.html(opts);
+    stream.set_header("Content-Length", html.content_length.toString());
+    const csp = stream.get_header("Content-Security-Policy");
+    if (csp == null || typeof csp !== "string") {
+      throw new Error("Cannot serve HTML without a string typed Content-Security-Policy (CSP) header defined on the endpoint. This should by default be defined by the Server.");
+    }
+    const new_csp = csp.replace(/(script-src|style-src)([^;]*)/g, (_, g1, g2) => `${g1}${g2} 'nonce-${html.nonce}'`);
+    stream.set_header("Content-Security-Policy", new_csp);
+    stream.send({
+      status: status_code,
+      headers: { "Content-Type": "text/html" },
+      data: html.html
+    });
+  }
+  html_nonce_split;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  View
+});

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

@@ -1,4 +1,8 @@
-export { ExternalError, InternalError } from "./utils.js";
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
+ */
+export * from "./errors/index.js";
 export * from "./status.js";
 export * from "./meta.js";
 export * from "./splash_screen.js";
@@ -9,7 +13,12 @@ export * from "./server.js";
 export * from "./database/database.js";
 export * from "./database/document.js";
 export * from "./database/collection.js";
+export * from "./database/quota/quota.js";
+export * from "./database/quota/safe_int.js";
 export * from "./rate_limit.js";
 export * from "./logger.js";
+export * from "./events.js";
+export { User } from "./users.js";
 export * as Mail from "./plugins/mail/ui.js";
 export * from "./frontend.js";
+export type { Request } from "../../frontend/src/modules/request.js";

package/backend/dist/cjs/{volt.js → backend/src/volt.js}

@@ -28,12 +28,10 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var stdin_exports = {};
 __export(stdin_exports, {
-  ExternalError: () => import_utils.ExternalError,
-  InternalError: () => import_utils.InternalError,
   Mail: () => Mail
 });
 module.exports = __toCommonJS(stdin_exports);
-var import_utils = require("./utils.js");
+__reExport(stdin_exports, require("./errors/index.js"), module.exports);
 __reExport(stdin_exports, require("./status.js"), module.exports);
 __reExport(stdin_exports, require("./meta.js"), module.exports);
 __reExport(stdin_exports, require("./splash_screen.js"), module.exports);
@@ -44,15 +42,17 @@ __reExport(stdin_exports, require("./server.js"), module.exports);
 __reExport(stdin_exports, require("./database/database.js"), module.exports);
 __reExport(stdin_exports, require("./database/document.js"), module.exports);
 __reExport(stdin_exports, require("./database/collection.js"), module.exports);
+__reExport(stdin_exports, require("./database/quota/quota.js"), module.exports);
+__reExport(stdin_exports, require("./database/quota/safe_int.js"), module.exports);
 __reExport(stdin_exports, require("./rate_limit.js"), module.exports);
 __reExport(stdin_exports, require("./logger.js"), module.exports);
+__reExport(stdin_exports, require("./events.js"), module.exports);
 var Mail = __toESM(require("./plugins/mail/ui.js"));
 __reExport(stdin_exports, require("./frontend.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  ExternalError,
-  InternalError,
   Mail,
+  ...require("./errors/index.js"),
   ...require("./status.js"),
   ...require("./meta.js"),
   ...require("./splash_screen.js"),
@@ -63,7 +63,10 @@ __reExport(stdin_exports, require("./frontend.js"), module.exports);
   ...require("./database/database.js"),
   ...require("./database/document.js"),
   ...require("./database/collection.js"),
+  ...require("./database/quota/quota.js"),
+  ...require("./database/quota/safe_int.js"),
   ...require("./rate_limit.js"),
   ...require("./logger.js"),
+  ...require("./events.js"),
   ...require("./frontend.js")
 });

package/backend/dist/cjs/frontend/src/modules/request.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh.
+ */
+import type { RegisteredEndpoint } from "../../../backend/src/server.js";
+import type { APIError } from "../../../backend/src/stream.js";
+export declare namespace Request {
+    /** The method type. */
+    export type Method = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
+    /** The response data template base. */
+    type ResponseBodyBase = unknown | null | undefined | number | boolean | string | any[] | Record<string, any>;
+    /** The request data template base. */
+    type RequestBodyBase = unknown | null | undefined | string | Record<string, any>;
+    /**
+     * The detailed generic type for providing info for the {@link request} function.
+     */
+    export type Info<Method extends Request.Method, Endpoint extends string | RegExp, ParamsBody extends RequestBodyBase, SuccessBody extends ResponseBodyBase, ErrorBody extends ResponseBodyBase> = {
+        /** The HTTP method for the request. */
+        method: Method;
+        /** The route's endpoint or full url with domain, string or regex. */
+        endpoint: Endpoint;
+        /** The request payload (body) type. */
+        payload: ParamsBody;
+        /** The success result body type. */
+        result: SuccessBody;
+        /** The error result body type. */
+        error: ErrorBody;
+    };
+    /**
+     * Create request info from a registered endpoint.
+     */
+    export type InfoFromEndpoint<E extends RegisteredEndpoint<any, any, any>, SuccessBody extends ResponseBodyBase = undefined, ErrorBody extends ResponseBodyBase = undefined> = E extends RegisteredEndpoint<infer M, infer EP, infer P> ? Info<M extends undefined ? "GET" : M extends Method ? M : never, EP extends string ? EP : never, P, SuccessBody, ErrorBody> : never;
+    /** The request options. */
+    export interface Opts<Method extends Request.Method = "GET", Url extends string | RegExp = string, // use regex for backend support.
+    RequestBody extends RequestBodyBase = unknown> {
+        method?: Method;
+        url: Url;
+        data?: RequestBody;
+        json?: boolean;
+        credentials?: RequestCredentials;
+        headers?: Record<string, string>;
+    }
+    /** The returned result */
+    export type Result<SuccessBody extends ResponseBodyBase = unknown, ErrorBody extends ResponseBodyBase = unknown> = {
+        /** The request status. */
+        status: number;
+    } & ({
+        /** The api error from the backend {@link Stream.error}. */
+        error: APIError;
+        /** The error response body, always optional in case of body parsing failure. */
+        data?: ErrorBody;
+    } | {
+        /** The success response body. */
+        data: SuccessBody;
+        /** No API error from the backend {@link Stream.error} was found. */
+        error?: never;
+    });
+    /** The returned result by endpoint {@link Info} */
+    export type ResultFromInfo<Info extends Request.Info<any, any, any, any, any>> = Info extends Request.Info<any, any, any, infer S, infer E> ? Result<S, E> : never;
+    /** A promise to {@link Result}, for convenience. */
+    export type ResultPromise<SuccessBody extends ResponseBodyBase = unknown, ErrorBody extends ResponseBodyBase = unknown> = Promise<Result<SuccessBody, ErrorBody>>;
+    /** A promise to {@link Result} from endpoint {@link Info}, for convenience. */
+    export type ResultPromiseFromInfo<Info extends Request.Info<any, any, any, any, any>> = Info extends Request.Info<any, any, any, infer S, infer E> ? Promise<Result<S, E>> : never;
+    export {};
+}
+/**
+ * Make a request with a specific generic typing, optionally passing
+ * the request method, endpoint, request body and response body types.
+ */
+export declare function request<Info extends Request.Info<any, any, any, any, any>>(options: Info extends Request.Info<infer M, infer E, infer P, any, any> ? Request.Opts<M, E, P> : never): Promise<Info extends Request.Info<any, any, any, infer S, infer E> ? Request.Result<S, E> : never>;