@vandenberghinc/volt 1.2.5 → 1.2.6

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

@@ -1,70 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh.
- */
-import type { Server } 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 Server.RegisteredEndpoint<any, any, any>, SuccessBody extends ResponseBodyBase = undefined, ErrorBody extends ResponseBodyBase = undefined> = E extends Server.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>;

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

@@ -1,117 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh.
- */
-/**
- * Make a request with a specific generic typing, optionally passing
- * the request method, endpoint, request body and response body types.
- */
-export async function request(options) {
-    const { method = 'GET', url = null, data = null, json = true, credentials = "same-origin", headers = {}, } = options;
-    if (url instanceof RegExp) {
-        throw Error("The 'url' parameter cannot be a RegExp.");
-    }
-    // — prepare headers —
-    if (json && data != null && !headers['Content-Type']) {
-        headers['Content-Type'] = 'application/json';
-    }
-    // — build URL + body —
-    let finalUrl = url;
-    let body;
-    if (data != null && typeof data === 'object') {
-        if (method.toUpperCase() === 'GET') {
-            // @todo do without any cast.
-            finalUrl = `${url}?${new URLSearchParams(data).toString()}`;
-        }
-        else {
-            body = JSON.stringify(data);
-        }
-    }
-    else if (data != null) {
-        body = String(data);
-    }
-    const init = { method, credentials, headers };
-    if (body !== undefined)
-        init.body = body;
-    try {
-        const response = await fetch(finalUrl, init);
-        const status = response.status;
-        // — parse payload once —
-        let payload;
-        const clone = response.clone(); // @dev.
-        if (json) {
-            try {
-                payload = await response.json();
-            }
-            catch (e) {
-                // malformed JSON still counts as a “success” fetch
-                console.log("[debug] Unable to parse a json from response:", await clone.text(), "- Error: ", JSON.stringify(e, null, 4));
-                console.log("[debug] Response:", response);
-                return {
-                    status,
-                    error: { message: `Failed to parse JSON response: ${e.message}` },
-                };
-            }
-        }
-        else {
-            try {
-                payload = await response.text();
-            }
-            catch (e) {
-                return {
-                    status,
-                    error: { message: `Failed to parse text response: ${e.message}` },
-                };
-            }
-        }
-        // console.log("Payload", json, payload)
-        // — handle HTTP errors (4xx/5xx) by resolving with an error object —
-        if (!response.ok) {
-            // if server wrapped its error in { error: { message, type?, invalid_fields? }, … }
-            if (payload &&
-                typeof payload === 'object' &&
-                payload.error &&
-                typeof payload.error === 'object' &&
-                typeof payload.error.message === 'string') {
-                return {
-                    status,
-                    error: {
-                        message: payload.error.message,
-                        type: typeof payload.error.type === "string" ? payload.error.type : undefined,
-                        invalid_fields: payload.error.invalid_fields && typeof payload.error.invalid_fields === "object" && !Array.isArray(payload.error.invalid_fields)
-                            ? payload.error.invalid_fields
-                            : undefined,
-                    },
-                    data: payload.data,
-                };
-            }
-            // otherwise fall back to a generic single‐message error
-            const msg = typeof payload === 'string'
-                ? payload
-                : payload?.error?.toString() ?? JSON.stringify(payload);
-            return {
-                status,
-                error: { message: msg },
-                data: payload.data,
-            };
-        }
-        // — 2xx: success —
-        return { status, data: payload };
-    }
-    catch (networkErr) {
-        // genuine network / system failure
-        throw networkErr;
-    }
-}
-;
-// void request<{
-//     method: "GET",
-//     endpoint: "/example",
-//     payload: { id: string },
-//     result: { name: string, age: number },
-//     error: { reason: string }
-// }>({
-//     method: "GET",
-//     url: "/example",
-//     data: { id: "123" }
-// })

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

@@ -1,3 +0,0 @@
-export declare namespace Settings {
-    const production: boolean;
-}

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

@@ -1,5 +0,0 @@
-// Settings.
-export var Settings;
-(function (Settings) {
-    Settings.production = "{{PRODUCTION}}";
-})(Settings || (Settings = {}));

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

@@ -1,21 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
- */
-export declare const Statics: {
-    aspect_ratios: any;
-    /**
-     * Retrieve the aspect ratio of a static endpoint.
-     *
-     * All aspect ratios are embedded into the compiled HTML document.
-     *
-     * @warning This function only works when the endpoint has been defined using the `Endpoint.view` attribute.
-     *
-     * @param endpoint The static image endpoint.
-     *
-     * @nav Frontend/Static
-     * @docs
-     */
-    aspect_ratio(endpoint: string): any;
-};
-export { Statics as statics };

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

@@ -1,43 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
- */
-// Static module
-if (window.volt_statics_aspect_ratios === undefined) {
-    window.volt_statics_aspect_ratios = {};
-}
-export const Statics = {
-    get aspect_ratios() {
-        return window.volt_statics_aspect_ratios;
-    },
-    set aspect_ratios(aspect_ratios) {
-        window.volt_statics_aspect_ratios = aspect_ratios;
-    },
-    /**
-     * Retrieve the aspect ratio of a static endpoint.
-     *
-     * All aspect ratios are embedded into the compiled HTML document.
-     *
-     * @warning This function only works when the endpoint has been defined using the `Endpoint.view` attribute.
-     *
-     * @param endpoint The static image endpoint.
-     *
-     * @nav Frontend/Static
-     * @docs
-     */
-    aspect_ratio(endpoint) {
-        if (endpoint.charAt(0) !== "/") {
-            endpoint = "/" + endpoint;
-        }
-        const index = endpoint.indexOf("?");
-        if (index !== -1) {
-            endpoint = endpoint.substring(0, index);
-        }
-        endpoint = endpoint.replace(/\/\//g, "/");
-        while (endpoint.charAt(endpoint.length - 1) === "/") {
-            endpoint = endpoint.substring(0, endpoint.length - 1);
-        }
-        return this.aspect_ratios[endpoint];
-    }
-};
-export { Statics as statics }; // also export as lowercase for compatibility.

package/frontend/dist/frontend/src/modules/stripe/cart.d.ts

@@ -1,112 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2026 - 2026 Daan van den Bergh. All rights reserved
- *
- * Persistent shopping cart for Stripe checkout (frontend).
- *
- * - Stores product ids and/or subscription plan ids (strings).
- * - Persists across reloads using localStorage.
- */
-/**
- * Shopping cart module for Stripe checkout, managing product ids and subscription plan ids with quantities.
- */
-export declare namespace Cart {
-    /**
-     * Internal persisted cart schema (versioned).
-     */
-    interface PersistedCart {
-        /** Schema version for future migrations. */
-        version: number;
-        /** Stored cart items. */
-        items: Cart.CartItem[];
-    }
-    /** Nested types for the {@link PersistedCart} type. */
-    namespace PersistedCart {
-        /** Type guard. */
-        function is(value: unknown): value is PersistedCart;
-    }
-    /**
-     * A single cart line item (product id or subscription plan id).
-     */
-    interface CartItem {
-        /** The product id or subscription plan id to purchase/subscribe to. */
-        product_id: string;
-        /** The quantity (>= 1). For subscription plans, backend enforces quantity === 1. */
-        quantity: number;
-    }
-    /** Nested types for the {@link CartItem} type. */
-    namespace CartItem {
-        /** Type guard. */
-        function is(value: unknown): value is CartItem;
-    }
-    /** The cart storage version. */
-    const version: number;
-    /** Cached items in memory for fast access. */
-    let items: Cart.CartItem[];
-    /**
-     * Add an item to the cart (or increment quantity if it already exists).
-     * @param product_id The product id or subscription plan id.
-     * @param quantity Quantity to add (defaults to 1).
-     */
-    function add(product_id: string, quantity?: number): Promise<void>;
-    /**
-     * Set an absolute quantity for an item.
-     * If the item doesn't exist yet, it will be added.
-     * @param product_id The product id or subscription plan id.
-     * @param quantity The absolute quantity (>= 1).
-     */
-    function set_quantity(product_id: string, quantity: number): Promise<void>;
-    /**
-     * Remove an item entirely from the cart.
-     * @param product_id The product id or subscription plan id.
-     */
-    function remove(product_id: string): void;
-    /**
-     * Clear the cart.
-     */
-    function clear(): void;
-    /**
-     * Start a Stripe hosted Checkout Session for the current cart and redirect the browser.
-     *
-     * This function is intentionally small and opinionated:
-     * - validates the cart locally (fail fast)
-     * - creates a backend session id first (idempotency)
-     * - creates the Stripe Checkout Session on the backend
-     * - redirects to the hosted URL
-     *
-     * @throws {Error} When validation fails or the backend returns an error.
-     */
-    function checkout(opts: {
-        /**
-         * The success URL after payment completes.
-         * You may pass an absolute https URL, or a relative path (e.g. "/billing/success").
-         */
-        success_url: string;
-        /**
-         * The cancel URL when the user cancels out of Stripe Checkout.
-         * You may pass an absolute https URL, or a relative path (e.g. "/pricing").
-         */
-        cancel_url: string;
-        /**
-         * Whether to require tax ID collection in Checkout.
-         * This is useful for B2B (e.g. VAT ID).
-         */
-        tax_id_collection_enabled?: boolean;
-        /**
-         * Whether to clear the cart after a successful session creation + redirect.
-         * Defaults to true (safe, since checkout is now owned by Stripe).
-         */
-        clear_cart_on_redirect?: boolean;
-    }): Promise<{
-        /**
-         * The Stripe Checkout Session id created on the backend.
-         */
-        checkout_session_id: string;
-        /**
-         * The Stripe hosted Checkout URL the browser will be redirected to.
-         */
-        checkout_url: string;
-    }>;
-}
-/** Snake case compatibility. */
-export { Cart as cart };