@vandenberghinc/volt 1.1.26 → 1.1.28

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

@@ -0,0 +1,16 @@
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh.
+ */
+import * as vlib from "@vandenberghinc/vlib";
+export declare namespace Utils {
+    function fill_templates(data: string, templates: Record<string, any>, curly_style?: boolean): string;
+    function get_currency_symbol(currency: string): string | null;
+    function get_compiled_cache(domain: string, method: string, endpoint: string): {
+        cache_path: vlib.Path;
+        cache_hash: any;
+        cache_data: any;
+    };
+    function set_compiled_cache(path: vlib.Path, data: string, hash: string): void;
+}
+export { Utils as utils };

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

@@ -1,81 +1,17 @@
-/*
- * Author: Daan van den Bergh
- * Copyright: © 2022 - 2024 Daan van den Bergh.
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh.
  */
+// ---------------------------------------------------------
+// Imports.
 import * as vlib from "@vandenberghinc/vlib";
-import { Status } from "./status.js";
 // ---------------------------------------------------------
 // Utils.
-/**
- * The base class for internal and external errors.
- */
-class BaseError extends Error {
-    type;
-    status;
-    data;
-    invalid_fields;
-    constructor({ type = "APIError", message, status, data, invalid_fields }) {
-        super(message);
-        this.name = "APIError";
-        this.type = type;
-        this.status = status ?? Status.internal_server_error;
-        this.data = data;
-        this.invalid_fields = invalid_fields ?? {};
-    }
-    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 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": ExternalError,
+export var Utils;
+(function (Utils) {
     // Fill templates {{TEMPLATE}}
-    fill_templates(data, templates, curly_style = true) {
+    function fill_templates(data, templates, curly_style = true) {
         if (templates == null) {
             return data;
         }
@@ -121,9 +57,10 @@ export const Utils = {
         }
         // Response.
         return data;
-    },
+    }
+    Utils.fill_templates = fill_templates;
     // Utils.
-    get_currency_symbol(currency) {
+    function get_currency_symbol(currency) {
         switch (currency.toLowerCase()) {
             case "aed": return "د.إ";
             case "afn": return "Af";
@@ -281,9 +218,10 @@ export const Utils = {
             case "zmw": return "ZK";
         }
         return null;
-    },
+    }
+    Utils.get_currency_symbol = get_currency_symbol;
     // Try a compiled js cache using the /tmp/
-    get_compiled_cache(domain, method, endpoint) {
+    function get_compiled_cache(domain, method, endpoint) {
         const cache_path = new vlib.Path(`/tmp/${domain.replaceAll("/", "")}:${method}:${endpoint.replaceAll("/", "_")}`);
         let cache_data, cache_hash;
         if (cache_path.exists()) {
@@ -291,12 +229,13 @@ export const Utils = {
             cache_hash = new vlib.Path(cache_path.str() + '.hash').load_sync();
         }
         return { cache_path, cache_hash, cache_data };
-    },
+    }
+    Utils.get_compiled_cache = get_compiled_cache;
     // @todo
-    set_compiled_cache(path, data, hash) {
+    function set_compiled_cache(path, data, hash) {
         path.save_sync(data);
         new vlib.Path(path.str() + '.hash').save_sync(hash);
-    },
-};
+    }
+    Utils.set_compiled_cache = set_compiled_cache;
+})(Utils || (Utils = {}));
 export { Utils as utils }; // lowercase export for compatibility
-export default Utils;

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

@@ -1,7 +1,14 @@
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
+ */
 import * as vlib from "@vandenberghinc/vlib";
-import Meta from "./meta.js";
+import * as vts from "@vandenberghinc/vlib/vts";
+import { Meta } from "./meta.js";
 import { Endpoint } from "./endpoint.js";
-import Server from "./server.js";
+import { Server } from "./server.js";
+import { SplashScreen } from "./splash_screen.js";
+import Stream from "./stream.js";
 /**
  * @nav Backend
  * @chapter Endpoints
@@ -86,7 +93,7 @@ export declare class View {
     static includes: Array<string | Record<string, any>>;
     static links: Array<string | Record<string, any>>;
     static body_style: string | null;
-    static splash_screen: any;
+    static splash_screen: SplashScreen | undefined;
     private static _volt_css?;
     private static _vhighlight_css?;
     source: string | null;
@@ -99,19 +106,19 @@ export declare class View {
     jquery: boolean;
     lang: string;
     body_style: string | null;
-    splash_screen: any;
+    splash_screen: SplashScreen | undefined;
     tree_shaking: boolean;
     mangle: boolean;
     _src?: string;
     _embedded_sources: Array<string>;
     is_js_ts_view: boolean;
-    html?: string | Buffer;
+    private _html?;
     raw_html?: string | Buffer;
-    _bundle: any;
+    _bundle?: vts.BundleResult;
     payments?: string | undefined;
     min_device_width?: number;
-    _server?: Server;
-    _endpoint?: Endpoint;
+    server?: Server;
+    endpoint?: Endpoint;
     constructor({ source, callback, includes, links, templates, meta, jquery, lang, body_style, splash_screen, tree_shaking, mangle, min_device_width, _src, }: {
         source?: string | null;
         callback?: Function | null;
@@ -122,7 +129,7 @@ export declare class View {
         jquery?: boolean;
         lang?: string;
         body_style?: string | null;
-        splash_screen?: any;
+        splash_screen?: SplashScreen;
         tree_shaking?: boolean;
         mangle?: boolean;
         min_device_width?: number;
@@ -132,8 +139,23 @@ export declare class View {
     private _dynamic_bundle;
     /** Ensure the view is bundled when required. */
     ensure_bundle(): Promise<void>;
-    _build_html(): Promise<void>;
-    _serve(stream: any, status_code?: number): void;
+    /** Create an error HTML file when errors are encountered during the bundle process. */
+    private _build_bundle_err_html;
+    private _build_html;
+    /** Retrieve the content length of the built html. */
+    content_length(): Promise<number>;
+    /** Retrieve the HTML. */
+    html(opts?: {
+        compress?: boolean;
+    }): Promise<{
+        html: string | Buffer;
+        content_length: number;
+        nonce: string;
+    }>;
+    _serve(stream: Stream, status_code?: number, opts?: {
+        compress?: boolean;
+    }): Promise<void>;
+    private html_nonce_split?;
 }
 export declare namespace View {
     type Opts = ConstructorParameters<typeof View>[0];