@vandenberghinc/volt 1.1.26 → 1.1.28

package/frontend/dist/frontend/src/modules/cookies.js

@@ -0,0 +1,143 @@
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
+ */
+// Imports.
+import { Google } from "./google.js";
+// Cookies object.
+export var Cookies;
+(function (Cookies) {
+    let _cookies = {};
+    let _last_cookies = '';
+    Cookies.enabled = false;
+    /**
+     * Checks if cookies need to be parsed again.
+     * @docs
+     */
+    function is_parse_required() {
+        return document.cookie !== _last_cookies;
+    }
+    Cookies.is_parse_required = is_parse_required;
+    /**
+     * Get cookies or a specific cookie by name.
+     * @experimental true
+     * @param name The name of the cookie.
+     * @docs
+     */
+    function get(name = null) {
+        if (document.cookie === _last_cookies) {
+            if (name != null) {
+                return _cookies[name];
+            }
+            return _cookies;
+        }
+        // Attributes.
+        _cookies = {};
+        _last_cookies = document.cookie;
+        // Vars.
+        let is_key = true, is_str = null;
+        let key = "", value = "";
+        // Wrapper.
+        const append = () => {
+            if (key.length > 0) {
+                _cookies[key] = decodeURIComponent(value);
+            }
+            value = "";
+            key = "";
+            is_key = true;
+            is_str = null;
+        };
+        // Parse.
+        for (let i = 0; i < document.cookie.length; i++) {
+            const c = document.cookie.charAt(i);
+            // Is key.
+            if (is_key) {
+                if (c === " " || c === "\t") {
+                    continue;
+                }
+                else if (c === "=") {
+                    is_key = false;
+                }
+                else {
+                    key += c;
+                }
+            }
+            // Is value.
+            else {
+                // End of string.
+                if (is_str != null && is_str === c) {
+                    value = value.substr(1, value.length - 1);
+                    append();
+                }
+                // End of cookie.
+                else if (c === ";") {
+                    append();
+                }
+                // Append to value.
+                else {
+                    // Start of string.
+                    if (value.length === 0 && (c === "\"" || c === "'")) {
+                        is_str = c;
+                    }
+                    value += c;
+                }
+            }
+        }
+        append();
+        if (name != null) {
+            return _cookies[name];
+        }
+        return _cookies;
+    }
+    Cookies.get = get;
+    /**
+     * Checks if the user has set a cookie preference (enabled or disabled).
+     * @docs
+     */
+    function has_preference() {
+        const pref = localStorage.getItem("volt_cookies_enabled");
+        return pref === "true" || pref === "false";
+    }
+    Cookies.has_preference = has_preference;
+    // Check if all the cookies are accepted.
+    /**
+     * Checks if cookies are accepted by the user.
+     * @docs
+     */
+    function is_accepted() {
+        return localStorage.getItem("volt_cookies_enabled") === "true";
+    }
+    Cookies.is_accepted = is_accepted;
+    /**
+     * Enables cookies (opt-in) and updates the user's preference.
+     * @param _set_storage Whether to update the localStorage preference (default: true).
+     * @docs
+     */
+    function enable(_set_storage = true) {
+        Cookies.enabled = true;
+        if (_set_storage) {
+            localStorage.setItem("volt_cookies_enabled", "true");
+        }
+        Google.disable_tracking();
+    }
+    Cookies.enable = enable;
+    /**
+     * Disables cookies (opt-out) and updates the user's preference.
+     * @param _set_storage Whether to update the localStorage preference (default: true).
+     * @docs
+     */
+    function disable(_set_storage = true) {
+        Cookies.enabled = false;
+        if (_set_storage) {
+            localStorage.setItem("volt_cookies_enabled", "false");
+        }
+        Google.enable_tracking();
+    }
+    Cookies.disable = disable;
+    // Initialize cookies.
+    if (is_accepted())
+        enable(false);
+    else
+        disable(false);
+})(Cookies || (Cookies = {}));
+export { Cookies as cookies }; // also export as lowercase for compatibility.

package/frontend/dist/frontend/src/modules/events.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
+ */
+export declare namespace Events {
+    const events: Map<string, [any, (element: any, args: any) => void][]>;
+    /**
+     * Emit a registered event.
+     * @param id The id of the registered event to emit.
+     * @param args The arguments that will be passed to the registered callbacks.
+     * @docs
+     */
+    function emit(id: string, args?: Record<string, any>): void;
+    /**
+     * Set a callback for an event.
+     * @param id The id of the registered event to emit.
+     * @param element The element.
+     * @param callback The callback function, accepts parameters `(element, args)`.
+     * @docs
+     */
+    function on<T extends object>(id: string, element: T, callback: (element: T, args: Record<string, any>) => void): void;
+    /**
+     * Remove a callback for an event.
+     * @param id The id of the registered event to emit.
+     * @param element The element.
+     * @param callback The callback function to remove. When left undefined, all callbacks matching to that element will be removed.
+     * @docs
+     */
+    function remove<T extends object>(id: string, element: T, callback?: (element: T, args: Record<string, any>) => void): void;
+}
+export { Events as events };

package/frontend/dist/frontend/src/modules/events.js

@@ -0,0 +1,74 @@
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
+ */
+// Events module.
+export var Events;
+(function (Events) {
+    Events.events = new Map();
+    // Emit an event.
+    /**
+     * Emit a registered event.
+     * @param id The id of the registered event to emit.
+     * @param args The arguments that will be passed to the registered callbacks.
+     * @docs
+     */
+    function emit(id, args = {}) {
+        const callbacks = Events.events.get(id);
+        if (callbacks == null) {
+            return;
+        }
+        callbacks.forEach((i) => {
+            i[1](i[0], args);
+        });
+    }
+    Events.emit = emit;
+    // On event.
+    /**
+     * Set a callback for an event.
+     * @param id The id of the registered event to emit.
+     * @param element The element.
+     * @param callback The callback function, accepts parameters `(element, args)`.
+     * @docs
+     */
+    function on(id, element, callback) {
+        let callbacks = Events.events.get(id);
+        if (callbacks == null) {
+            callbacks = [];
+            Events.events.set(id, callbacks);
+        }
+        callbacks.push([element, callback]);
+    }
+    Events.on = on;
+    // Remove a callback for an event.
+    /**
+     * Remove a callback for an event.
+     * @param id The id of the registered event to emit.
+     * @param element The element.
+     * @param callback The callback function to remove. When left undefined, all callbacks matching to that element will be removed.
+     * @docs
+     */
+    function remove(id, element, callback) {
+        const callbacks = Events.events.get(id);
+        if (callbacks == null) {
+            return;
+        }
+        const filtered = [];
+        callbacks.forEach((i) => {
+            if (i[0] === element && (callback == null || i[1] === callback)) {
+                return;
+            }
+            filtered.push(i);
+        });
+        Events.events.set(id, filtered);
+    }
+    Events.remove = remove;
+})(Events || (Events = {}));
+export { Events as events }; // also export as lowercase for compatibility.
+// Fire the onload event.
+/**
+ * Fires the `volt.on_load` event when the window finishes loading.
+ */
+window.onload = () => {
+    Events.emit("volt.on_load");
+};

package/frontend/dist/frontend/src/modules/google.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
+ */
+export declare namespace Google {
+    const id: string;
+    /**
+     * Enable google analytics tracking
+     * @nav Fronted/Google
+     * @docs
+     */
+    function enable_tracking(): void;
+    /**
+     * Disable google analytics tracking
+     * @nav Fronted/Google
+     * @docs
+     */
+    function disable_tracking(): void;
+    const cloud: {
+        api_key: string;
+    };
+}
+export { Google as google };

package/frontend/dist/frontend/src/modules/google.js

@@ -0,0 +1,52 @@
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
+ */
+// Google wrapper module.
+export var Google;
+(function (Google) {
+    Google.id = "{{GOOGLE_TAG}}";
+    // Source: https://developers.google.com/analytics/devguides/collection/gajs/#disable
+    /**
+     * Enable google analytics tracking
+     * @nav Fronted/Google
+     * @docs
+     */
+    function enable_tracking() {
+        // document.cookie = "ga-opt-out=false; Path=/; SameSite=None;";
+        delete window[`ga-disable-${Google.id}`];
+    }
+    Google.enable_tracking = enable_tracking;
+    // Source: https://developers.google.com/analytics/devguides/collection/gajs/#disable
+    /**
+     * Disable google analytics tracking
+     * @nav Fronted/Google
+     * @docs
+     */
+    function disable_tracking() {
+        // document.cookie = "ga-opt-out=true; Path=/; SameSite=None;";
+        window[`ga-disable-${Google.id}`] = true;
+    }
+    Google.disable_tracking = disable_tracking;
+    // Auto initialize (internal use).
+    function _initialize() {
+        if (Google.id && typeof window !== "undefined") {
+            // @ts-ignore
+            window.dataLayer = window.dataLayer || [];
+            function gtag(...args) {
+                // @ts-ignore
+                window.dataLayer.push(args);
+            }
+            gtag('js', new Date());
+            gtag('config', Google.id);
+        }
+    }
+    // Google cloud.
+    Google.cloud = {
+        api_key: "{{GOOGLE_COULD_API_KEY}}",
+    };
+    // Initialize.
+    _initialize();
+})(Google || (Google = {}));
+;
+export { Google as google }; // also export as lowercase for compatibility.

package/frontend/dist/frontend/src/modules/meta.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
+ */
+export declare namespace Meta {
+    function set({ author, title, description, image, favicon, }: {
+        author?: string;
+        title?: string;
+        description?: string;
+        image?: string;
+        favicon?: string;
+    }): void;
+}
+export { Meta as meta };

package/frontend/dist/{modules → frontend/src/modules}/meta.js

@@ -1,11 +1,12 @@
-/*
- * Author: Daan van den Bergh
- * Copyright: © 2022 - 2024 Daan van den Bergh.
+/**
+ * @author Daan van den Bergh
+ * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
  */
 // Meta module.
-export const Meta = {
+export var Meta;
+(function (Meta) {
     // Set title.
-    set({ author, title, description, image, favicon, }) {
+    function set({ author, title, description, image, favicon, }) {
         const set_content_query = (query, content) => {
             const e = document.querySelector(query);
             if (e) {
@@ -41,6 +42,7 @@ export const Meta = {
             set_content_og("og:image", image);
             set_content_og("twitter:image", description);
         }
-    },
-};
+    }
+    Meta.set = set;
+})(Meta || (Meta = {}));
 export { Meta as meta }; // also export as lowercase for compatibility.

package/frontend/dist/{modules → frontend/src/modules}/paddle.d.ts

@@ -1,8 +1,12 @@
-declare const Payments: {
-    client_key: string;
-    sandbox: boolean;
-    tax_inclusive: boolean;
-    countries: {
+import type { Paddle as PaddleBackend, Product } from "../../../backend/src/payments/paddle.js";
+import { Request } from "./request.js";
+/**
+ * @deprecated using stripe from now on.
+ */
+export declare namespace Payments {
+    const sandbox: boolean;
+    const tax_inclusive: boolean;
+    const countries: {
         AD: {
             name: string;
             calling_code: string;
@@ -1000,84 +1004,9 @@ declare const Payments: {
             calling_code: string;
         };
     };
-    _paddle_initialized: boolean;
-    _payment_element: any;
-    _sign_in_redirect: string | undefined | null;
-    _step: number;
-    _steps_element: any;
-    _steps_container: any;
-    _overview_container: any;
-    _order_container: any;
-    _billing_container: any;
-    _payment_container: any;
-    _processing_container: any;
-    _checkout_button: any;
-    _prev_step_button: any;
-    _style: any;
-    _currency_symbol: string | undefined;
-    _render_payment_element_reject: undefined | Function;
-    _render_payment_element_resolve: undefined | Function;
-    _refunds_element: any;
-    _refunds_container: any;
-    _processing_element: any;
-    _theme: any;
-    _products: any;
-    _days_refundable: number;
-    on_error: (data: string | Error) => void;
-    _refund_policy: string | undefined;
-    _cancellation_policy: string | undefined;
-    _billing_element: any;
-    _billing_details: any;
-    _overview_subtotal: any;
-    _overview_total: any;
-    _overview_subtotal_tax: any;
-    _overview_tax_container: any;
-    _overview_incl_excl_tax: any;
-    _overview_element: any;
-    _order_element: any;
-    /**
-     * Initialize Paddle with the provided client key and set up event callbacks.
-     */
-    _initialize_paddle: () => void;
-    /**
-     * Reset the payment element by removing it if it exists.
-     */
-    _reset: () => void;
-    /**
-     * Initialize the order by verifying authentication and making a POST request.
-     */
-    _init_order: () => Promise<void>;
-    /**
-     * Set the current step in the payment process.
-     */
-    _set_step: () => Promise<void | null>;
-    /**
-     * Navigate to the next step in the payment process.
-     */
-    _next: () => Promise<void | null>;
-    /**
-     * Navigate to the previous step in the payment process.
-     */
-    _prev: () => Promise<void | null>;
-    /**
-     * Render the steps element in the UI.
-     */
-    _render_steps_element: () => void;
-    /**
-     * Render the overview element in the UI.
-     */
-    _render_overview_element: () => void;
-    /**
-     * Render the order element in the UI.
-     */
-    _render_order_element: () => void;
-    _render_refunds_element: () => void;
-    _render_billing_element: () => void;
-    _render_payment_element: () => Promise<void>;
-    _render_processing_element: () => void;
-    _show_processing: (status?: string | null) => Promise<void>;
-    _update_processing: (status: string) => Promise<void>;
-    style: ({ theme, font_size, border_radius, bg, bg_1, divider_bg, fg, fg_1, fg_2, theme_fg, missing_fg, selected, button, }?: {
+    let on_error: (data: string | Error) => any;
+    function style({ theme, // light or dark
+    font_size, border_radius, bg, bg_1, divider_bg, fg, fg_1, fg_2, theme_fg, missing_fg, selected, button, }?: {
         theme?: string | undefined;
         font_size?: number | undefined;
         border_radius?: number | undefined;
@@ -1102,22 +1031,7 @@ declare const Payments: {
             border_inset: boolean;
             hover_brightness: number[];
         } | undefined;
-    }) => void;
-    create_checkout_dropin: ({ steps_container, order_container, billing_container, payment_container, processing_container, overview_container, sign_in_redirect, on_error, }: {
-        steps_container: any;
-        order_container: any;
-        billing_container: any;
-        payment_container: any;
-        processing_container: any;
-        overview_container: any;
-        sign_in_redirect?: string | null;
-        on_error?: (error: string | Error) => void;
-    }) => void;
-    create_refunds_dropin: ({ refunds_container, days_refundable, on_error, }: {
-        refunds_container: any;
-        days_refundable?: number;
-        on_error?: (error: any) => void;
-    }) => void;
+    }): void;
     /**
      * @docs:
      * @nav: Frontend
@@ -1130,7 +1044,7 @@ declare const Payments: {
      *   @name: currency
      *   @description: The currency from the product object.
      */
-    get_currency_symbol: (currency: string) => string | null;
+    function get_currency_symbol(currency: string): string | null;
     /**
      * @docs:
      * @nav: Frontend
@@ -1140,7 +1054,7 @@ declare const Payments: {
      * @type: array[object]
      * @return: Returns the backend defined payment products.
      */
-    get_products: () => Promise<any[]>;
+    function get_products(): Request.ResultPromiseFromInfo<PaddleBackend.Endpoints.GetProducts>;
     /**
      * @docs:
      * @nav: Frontend
@@ -1155,7 +1069,7 @@ declare const Payments: {
      *   @type: string
      *   @desc: The id of the payment product.
      */
-    get_product: (id: string) => Promise<any>;
+    function get_product(id: string): Request.ResultPromise<Product>;
     /**
      * @docs:
      * @nav: Frontend
@@ -1168,7 +1082,7 @@ declare const Payments: {
      *   @type: string
      *   @desc: The id of the payment.
      */
-    get_payment: (id: string) => Promise<any>;
+    function get_payment(payload: PaddleBackend.Endpoints.GetPayment["payload"]): Request.ResultPromiseFromInfo<PaddleBackend.Endpoints.GetPayment>;
     /**
      * @docs:
      * @nav: Frontend
@@ -1197,11 +1111,7 @@ declare const Payments: {
      *     @value: "paid"
      *     @desc: Payments that are paid.
      */
-    get_payments: ({ days, limit, status, }?: {
-        days?: number | undefined;
-        limit?: null | undefined;
-        status?: null | undefined;
-    }) => Promise<any>;
+    function get_payments(payload: PaddleBackend.Endpoints.GetPayments["payload"]): Request.ResultPromiseFromInfo<PaddleBackend.Endpoints.GetPayments>;
     /**
      * @docs:
      * @nav: Frontend
@@ -1217,10 +1127,7 @@ declare const Payments: {
      *   @type: number
      *   @desc: Limit the amount of response payment objects.
      */
-    get_refundable_payments: ({ days, limit, }?: {
-        days?: number | undefined;
-        limit?: null | undefined;
-    }) => Promise<any>;
+    function get_refundable_payments(payload?: PaddleBackend.Endpoints.GetRefundablePayments["payload"]): Request.ResultPromiseFromInfo<PaddleBackend.Endpoints.GetRefundablePayments>;
     /**
      * @docs:
      * @nav: Frontend
@@ -1236,10 +1143,7 @@ declare const Payments: {
      *   @type: number
      *   @desc: Limit the amount of response payment objects.
      */
-    get_refunded_payments: ({ days, limit, }?: {
-        days?: number | undefined;
-        limit?: null | undefined;
-    }) => Promise<any>;
+    function get_refunded_payments(payload?: PaddleBackend.Endpoints.GetRefundedPayments["payload"]): Request.ResultPromiseFromInfo<PaddleBackend.Endpoints.GetRefundedPayments>;
     /**
      * @docs:
      * @nav: Frontend
@@ -1255,10 +1159,7 @@ declare const Payments: {
      *   @type: number
      *   @desc: Limit the amount of response payment objects.
      */
-    get_refunding_payments: ({ days, limit, }?: {
-        days?: null | undefined;
-        limit?: null | undefined;
-    }) => Promise<any>;
+    function get_refunding_payments(payload?: PaddleBackend.Endpoints.GetRefundingPayments["payload"]): Request.ResultPromiseFromInfo<PaddleBackend.Endpoints.GetRefundingPayments>;
     /**
      * @docs:
      * @nav: Frontend
@@ -1281,7 +1182,7 @@ declare const Payments: {
      *   @type: string
      *   @desc: The refund reason.
      */
-    create_refund: (payment: number | string, line_items?: any[] | null, reason?: string) => Promise<any>;
+    function create_refund(payload: PaddleBackend.Endpoints.RefundPayment["payload"]): Request.ResultPromiseFromInfo<PaddleBackend.Endpoints.RefundPayment>;
     /**
      * @docs:
      * @nav: Frontend
@@ -1295,7 +1196,7 @@ declare const Payments: {
      *   @type: string
      *   @desc: The product id.
      */
-    cancel_subscription: (product: string) => Promise<any>;
+    function cancel_subscription(payload: PaddleBackend.Endpoints.CancelSubscription["payload"]): Request.ResultPromiseFromInfo<PaddleBackend.Endpoints.CancelSubscription>;
     /**
      * @docs:
      * @nav: Frontend
@@ -1308,7 +1209,7 @@ declare const Payments: {
      *   @type: string
      *   @desc: The product id.
      */
-    is_subscribed: (product: string) => Promise<any>;
+    function is_subscribed(payload: PaddleBackend.Endpoints.IsSubscribed["payload"]): Request.ResultPromiseFromInfo<PaddleBackend.Endpoints.IsSubscribed>;
     /**
      * @docs:
      * @nav: Frontend
@@ -1316,9 +1217,12 @@ declare const Payments: {
      * @title: Get active subscriptions
      * @desc: Get the active subscriptions of the authenticated user.
      */
-    get_active_subscriptions: () => Promise<any>;
-    cart: {
-        items: any[];
+    function get_active_subscriptions(): Request.ResultPromiseFromInfo<PaddleBackend.Endpoints.GetActiveSubscriptions>;
+    namespace Cart {
+        let items: {
+            product: Product;
+            quantity: number;
+        }[];
         /**
          * @docs:
          * @nav: Frontend
@@ -1329,7 +1233,7 @@ declare const Payments: {
          *
          *   The current cart items are accessible as `Payments.cart.items`.
          */
-        refresh: () => void;
+        function refresh(): void;
         /**
          * @docs:
          * @nav: Frontend
@@ -1340,7 +1244,7 @@ declare const Payments: {
          *
          *   The current cart items are accessible as `Payments.cart.items`.
          */
-        save: () => void;
+        function save(): void;
         /**
          * @docs:
          * @nav: Frontend
@@ -1363,7 +1267,7 @@ declare const Payments: {
          *   @description: The quantity to add.
          *   @type: number
          */
-        add: (id: string, quantity?: number) => Promise<void>;
+        function add(id: string, quantity?: number): Promise<void>;
         /**
          * @docs:
          * @nav: Frontend
@@ -1384,7 +1288,7 @@ declare const Payments: {
          *   @description: The quantity to remove. When the quantity value is "all", the entire product will be removed from the shopping cart.
          *   @type: number | "all"
          */
-        remove: (id: string, quantity?: number | "all") => Promise<void>;
+        function remove(id: string, quantity?: number | "all"): Promise<void>;
         /**
          * @docs:
          * @nav: Frontend
@@ -1397,8 +1301,7 @@ declare const Payments: {
          *
          *   The current cart items are accessible as `Payments.cart.items`.
          */
-        clear: () => Promise<void>;
-    };
-};
-export { Payments };
+        function clear(): Promise<void>;
+    }
+}
 export { Payments as payments };