@vandenberghinc/volt 1.1.2

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

@@ -0,0 +1,27 @@
+export declare class FrontendError extends Error {
+    name: string;
+    status?: number;
+    data?: any;
+    invalid_fields: Record<string, string>;
+    constructor(message: string, status?: number, data?: any, invalid_fields?: Record<string, string>);
+}
+export declare class APIError extends FrontendError {
+    constructor(message: string, status?: number, data?: any, invalid_fields?: Record<string, string>);
+}
+interface UtilsInt {
+    "FrontendError": typeof FrontendError;
+    "APIError": typeof APIError;
+    clean_endpoint(endpoint: undefined): undefined;
+    clean_endpoint(endpoint: RegExp): RegExp;
+    clean_endpoint(endpoint: string): string;
+    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 default Utils;

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

@@ -0,0 +1,324 @@
+/*
+ * Author: Daan van den Bergh
+ * Copyright: © 2022 - 2024 Daan van den Bergh.
+ */
+import { vlib } from "/Users/administrator/persistance/private/dev/vinc/volt/backend/./src/vinc.dev.js";
+// ---------------------------------------------------------
+// Utils.
+/*  @docs:
+ *  @nav: Backend
+    @parent: Utils
+    @chapter: Exceptions
+    @title: Frontend Error
+    @description:
+        The frontend error class can be 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.
+    @usage:
+        throw new volt.FrontendError("Some error occured.");
+        throw new volt.FrontendError("Bad request.", volt.status.bad_request);
+    @param:
+        @name: message
+        @descr: The error message.
+        @type: string
+    @param:
+        @name: status
+        @descr: The http error status.
+        @type: number
+    @param:
+        @name: data
+        @descr: The error body data.
+        @type: any
+ */
+export class FrontendError extends Error {
+    name;
+    status;
+    data;
+    invalid_fields = {};
+    constructor(message, status, data, invalid_fields) {
+        super(message);
+        this.name = "FrontendError";
+        this.status = status;
+        this.data = data;
+        if (invalid_fields !== undefined) {
+            this;
+            invalid_fields = invalid_fields;
+        }
+    }
+}
+/*  @docs:
+ *  @nav: Backend
+    @parent: Utils
+    @chapter: Exceptions
+    @title: API Error
+    @description:
+        The api error class can be 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.
+    @usage:
+        throw new volt.APIError("Some error occured.");
+        throw new volt.APIError("Bad request.", volt.status.bad_request);
+    @param:
+        @name: message
+        @descr: The error message.
+        @type: string
+    @param:
+        @name: status
+        @descr: The http error status.
+        @type: number
+    @param:
+        @name: data
+        @descr: The error body data.
+        @type: any
+ */
+export class APIError extends FrontendError {
+    constructor(message, status, data, invalid_fields) {
+        super(message, status, data, invalid_fields);
+        this.name = "APIError";
+    }
+}
+// Implementation
+export const Utils = {
+    // An error that may be shown to the frontend user.
+    "FrontendError": FrontendError,
+    // An error that may be shown to the frontend user.
+    "APIError": APIError,
+    // Clean an endpoint url.
+    clean_endpoint(endpoint) {
+        if (endpoint == null || endpoint instanceof RegExp) {
+            return endpoint;
+        }
+        if (endpoint.charAt(0) != "/") {
+            endpoint = "/" + endpoint;
+        }
+        endpoint = endpoint.replaceAll("//", "/");
+        if (endpoint.length > 1 && endpoint.charAt(endpoint.length - 1) === "/") {
+            endpoint = endpoint.substr(0, endpoint.length - 1);
+        }
+        return endpoint;
+    },
+    // Fill templates {{TEMPLATE}}
+    fill_templates(data, templates, curly_style = true) {
+        if (templates == null) {
+            return data;
+        }
+        const keys = Object.keys(templates);
+        // Iterate data.
+        if (keys.length > 0) {
+            for (let i = 0; i < data.length; i++) {
+                // {{TEMPLATE}} Curly style.
+                if (curly_style && data.charAt(i) === "{" && data.charAt(i + 1) === "{") {
+                    // Iterate all templates.  
+                    for (let k = 0; k < keys.length; k++) {
+                        if (data.charAt(i + keys[k].length + 2) === "}" &&
+                            data.charAt(i + keys[k].length + 3) === "}" &&
+                            data.startsWith(keys[k], i + 2)) {
+                            const end_index = i + keys[k].length + 4;
+                            if (templates[keys[k]] != null && typeof templates[keys[k]] === "object") {
+                                // @ts-ignore
+                                data = data.replace_indices(JSON.stringify(templates[keys[k]]), i, end_index);
+                            }
+                            else {
+                                // @ts-ignore
+                                data = data.replace_indices(templates[keys[k]], i, end_index);
+                            }
+                            i = end_index - 1;
+                        }
+                    }
+                }
+                // $TEMPLATE dollar style.
+                else if (!curly_style && data.charAt(i) === "$") {
+                    // Iterate all templates.  
+                    for (let k = 0; k < keys.length; k++) {
+                        if (data.startsWith(keys[k], i + 1)) {
+                            const end_index = i + keys[k].length + 1;
+                            if (templates[keys[k]] != null && typeof templates[keys[k]] === "object") {
+                                // @ts-ignore
+                                data = data.replace_indices(JSON.stringify(templates[keys[k]]), i, end_index);
+                            }
+                            else {
+                                // @ts-ignore
+                                data = data.replace_indices(templates[keys[k]], i, end_index);
+                            }
+                            i = end_index - 1;
+                        }
+                    }
+                }
+            }
+        }
+        // Response.
+        return data;
+    },
+    // Utils.
+    get_currency_symbol(currency) {
+        switch (currency.toLowerCase()) {
+            case "aed": return "د.إ";
+            case "afn": return "Af";
+            case "all": return "L";
+            case "amd": return "֏";
+            case "ang": return "ƒ";
+            case "aoa": return "Kz";
+            case "ars": return "$";
+            case "aud": return "$";
+            case "awg": return "ƒ";
+            case "azn": return "₼";
+            case "bam": return "KM";
+            case "bbd": return "Bds$";
+            case "bdt": return "৳";
+            case "bgn": return "лв";
+            case "bhd": return ".د.ب";
+            case "bif": return "FBu";
+            case "bmd": return "BD$";
+            case "bnd": return "B$";
+            case "bob": return "Bs";
+            case "brl": return "R$";
+            case "bsd": return "B$";
+            case "btn": return "Nu.";
+            case "bwp": return "P";
+            case "byn": return "Br";
+            case "bzd": return "BZ$";
+            case "cad": return "$";
+            case "cdf": return "FC";
+            case "chf": return "Fr";
+            case "clf": return "UF";
+            case "clp": return "$";
+            case "cny": return "¥";
+            case "cop": return "$";
+            case "crc": return "₡";
+            case "cuc": return "CUC$";
+            case "cup": return "CUP$";
+            case "cve": return "$";
+            case "czk": return "Kč";
+            case "djf": return "Fdj";
+            case "dkk": return "kr";
+            case "dop": return "RD$";
+            case "dzd": return "دج";
+            case "egp": return "E£";
+            case "ern": return "Nfk";
+            case "etb": return "Br";
+            case "eur": return "€";
+            case "fjd": return "FJ$";
+            case "fkp": return "£";
+            case "fok": return "F$";
+            case "gbp": return "£";
+            case "gel": return "₾";
+            case "ghc": return "₵";
+            case "gip": return "£";
+            case "gmd": return "D";
+            case "gnf": return "FG";
+            case "gtq": return "Q";
+            case "gyd": return "GY$";
+            case "hkd": return "HK$";
+            case "hnl": return "L";
+            case "hrk": return "kn";
+            case "htg": return "G";
+            case "huf": return "Ft";
+            case "idr": return "Rp";
+            case "ils": return "₪";
+            case "inr": return "₹";
+            case "iqd": return "د.ع";
+            case "irr": return "﷼";
+            case "isk": return "kr";
+            case "jmd": return "J$";
+            case "jod": return "JD";
+            case "jpy": return "¥";
+            case "kes": return "Ksh";
+            case "kgs": return "с";
+            case "khr": return "៛";
+            case "kmf": return "CF";
+            case "kpw": return "₩";
+            case "krw": return "₩";
+            case "kwd": return "KD";
+            case "kyd": return "CI$";
+            case "kzt": return "₸";
+            case "lak": return "₭";
+            case "lbp": return "L£";
+            case "lkr": return "Rs";
+            case "lrd": return "L$";
+            case "lsl": return "L";
+            case "lyd": return "ل.د";
+            case "mad": return "د.م.";
+            case "mdl": return "L";
+            case "mnt": return "₮";
+            case "mop": return "MOP$";
+            case "mur": return "Rs";
+            case "mvr": return "Rf";
+            case "mwk": return "MK";
+            case "mxn": return "$";
+            case "myr": return "RM";
+            case "mzn": return "MTn";
+            case "nad": return "N$";
+            case "ngn": return "₦";
+            case "nio": return "C$";
+            case "nok": return "kr";
+            case "npr": return "रू";
+            case "nzd": return "$";
+            case "omr": return "ر.ع.";
+            case "pab": return "B/.";
+            case "pen": return "S/.";
+            case "pgk": return "K";
+            case "php": return "₱";
+            case "pkr": return "Rs";
+            case "pln": return "zł";
+            case "pyg": return "₲";
+            case "qar": return "ر.ق";
+            case "ron": return "lei";
+            case "rsd": return "din.";
+            case "rub": return "₽";
+            case "rwf": return "FRw";
+            case "sar": return "ر.س";
+            case "sbd": return "SI$";
+            case "scr": return "Sr";
+            case "sdg": return "ج.س.";
+            case "sek": return "kr";
+            case "sgd": return "S$";
+            case "shp": return "£";
+            case "sll": return "Le";
+            case "sos": return "S";
+            case "srd": return "SRD$";
+            case "ssp": return "£";
+            case "std": return "Db";
+            case "sek": return "kr";
+            case "syp": return "S£";
+            case "szl": return "L";
+            case "thb": return "฿";
+            case "tjs": return "ЅМ";
+            case "tmt": return "m";
+            case "tnd": return "د.ت";
+            case "top": return "T$";
+            case "try": return "₺";
+            case "ttd": return "TT$";
+            case "twd": return "NT$";
+            case "tzs": return "TSh";
+            case "uah": return "₴";
+            case "ugx": return "USh";
+            case "usd": return "$";
+            case "uyu": return "$U";
+            case "uzs": return "лв";
+            case "ves": return "Bs.S.";
+            case "vnd": return "₫";
+            case "vuv": return "VT";
+            case "wst": return "WS$";
+            case "xaf": return "FCFA";
+            case "xcd": return "EC$";
+            case "xof": return "CFA";
+            case "xpf": return "CFP";
+            case "yer": return "﷼";
+            case "zar": return "R";
+            case "zmw": return "ZK";
+        }
+        return null;
+    },
+    // Try a compiled js cache using the /tmp/
+    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()) {
+            cache_data = cache_path.load_sync();
+            cache_hash = new vlib.Path(cache_path.str() + '.hash').load_sync();
+        }
+        return { cache_path, cache_hash, cache_data };
+    },
+    // @todo
+    set_compiled_cache(path, data, hash) {
+        path.save_sync(data);
+        new vlib.Path(path.str() + '.hash').save_sync(hash);
+    },
+};
+export default Utils;

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

@@ -0,0 +1,52 @@
+import { vlib } from "@vinc";
+import Meta from "./meta.js";
+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;
+    source: string | null;
+    source_path?: vlib.Path;
+    callback: Function | null;
+    includes: Array<string | Record<string, any>>;
+    links: Array<string | Record<string, any>>;
+    templates: Record<string, any>;
+    meta: Meta;
+    jquery: boolean;
+    lang: string;
+    body_style: string | null;
+    splash_screen: any;
+    tree_shaking: boolean;
+    mangle: boolean;
+    _src: string;
+    _embedded_sources: Array<string>;
+    is_js_ts_view: boolean;
+    html?: string | Buffer;
+    raw_html?: string | Buffer;
+    bundle: any;
+    payments?: string | undefined;
+    min_device_width?: number;
+    _server?: any;
+    _endpoint?: any;
+    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;
+        includes?: Array<string | Record<string, any>>;
+        links?: Array<string | Record<string, any>>;
+        templates?: Record<string, any>;
+        meta?: Meta;
+        jquery?: boolean;
+        lang?: string;
+        body_style?: string | null;
+        splash_screen?: any;
+        tree_shaking?: boolean;
+        mangle?: boolean;
+        min_device_width?: number;
+        _src?: string;
+    });
+    _initialize(server: any, endpoint: any): void;
+    _bundle_ts(dist_path: string, bundle?: any): Promise<any>;
+    _build_html(): Promise<void>;
+    _serve(stream: any, status_code?: number): void;
+}
+export default View;