@vandenberghinc/volt 1.2.5 → 1.2.6

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

@@ -1,126 +0,0 @@
-/**
- * @author ...
- * @copyright ...
- */
-import { AnyElement } from "../ui/any_element.js";
-import { Compression } from "./compression.js";
-import type { Mail } from "../../../backend/src/plugins/mail/mail.js";
-/** A file attachment with an internal byte buffer and compression/encoding helpers. */
-export declare class Attachment {
-    /** File or directory name. */
-    name: string;
-    /** Path relative to the dropped root. */
-    path: string;
-    /** MIME type of the data. */
-    mime_type: string;
-    /** Charset used for text decoding (if applicable). */
-    charset?: string;
-    /** Whether the internal buffer is gzip-compressed. */
-    compressed: boolean;
-    /** Optional original File/Blob source. */
-    file?: File | Blob;
-    /** Internal raw buffer (compressed or not depending on state). */
-    private _bytes;
-    /** Create an Attachment from initial metadata and/or bytes. */
-    constructor(init: Attachment.Opts);
-    /** Current size of the internal buffer in bytes (compressed if flagged). */
-    get size(): number;
-    /** Get a copy of the internal buffer (leave compression state unchanged). */
-    bytes(): Uint8Array;
-    /** Replace the internal buffer (optionally update compression flag). */
-    set_bytes(bytes: Compression.BytesLike, compressed?: boolean): this;
-    /** Ensure the buffer is gzip-compressed (noop if already compressed). */
-    compress(options?: Compression.GzipOptions): this;
-    /** Ensure the buffer is uncompressed (noop if already uncompressed). */
-    decompress(): this;
-    /** Return Base64 of the current buffer (compressed or not). */
-    to_base64({ url_safe }?: {
-        url_safe?: boolean;
-    }): string;
-    /**
-     * Return a string view of the data using a charset.
-     * @param decompress Whether to decompress first if compressed. Default true.
-     * @param encoding Charset label; defaults to this.charset or "utf-8".
-     */
-    to_string(decompress?: boolean, encoding?: string): string;
-    /**
-     * Parse JSON from the data.
-     * @param decompress Whether to decompress first if compressed. Default true.
-     */
-    to_json<T = unknown>(decompress?: boolean): T;
-    /**
-     * Convert this attachment to a backend REST API attachment payload.
-     *
-     * This returns an object compatible with the server's `Mail.Attachment.RestAPI`
-     * shape using either:
-     *  - `{ content, encoding }` (default; embeds the payload), or
-     *  - `{ url }` (streams from an http(s)/data URL).
-     *
-     * @param opts Conversion options.
-     * @param opts.encoding Output string encoding for `content`. Defaults to `"base64"`.
-     *                      Supported: `"base64" | "hex" | "utf8"`.
-     *                      Use `"utf8"` only for textual data.
-     * @param opts.decompress Whether to decompress before encoding. Defaults to `true`.
-     * @param opts.url Optional http(s) or data: URL. When provided, `content`/`encoding`
-     *                 are omitted and the server will stream from this URL.
-     *
-     * @returns A REST API attachment payload with metadata plus either `{ content, encoding }` or `{ url }`.
-     */
-    to_rest_api(opts?: {
-        encoding?: "base64" | "hex" | "utf8";
-        decompress?: boolean;
-        url?: string;
-    }): Mail.Attachment.RestAPI;
-    /** Clone the attachment, including bytes and metadata. */
-    clone(): Attachment;
-}
-export declare namespace Attachment {
-    /** Options for constructing an Attachment. */
-    interface Opts {
-        /** File or directory name. */
-        name: string;
-        /** Path relative to the dropped root (if available). */
-        path?: string;
-        /** MIME type of the data. */
-        mime_type?: string;
-        /** Charset used for text decoding (if applicable). */
-        charset?: string;
-        /** Initial bytes to load into the attachment. */
-        bytes?: Compression.BytesLike;
-        /** Original File/Blob (if created from user drop). */
-        file?: File | Blob;
-        /** Whether bytes are already gzip-compressed. */
-        compressed?: boolean;
-    }
-    /** Create an Attachment from a Blob/File; optionally read and compress. */
-    function from_blob(blob: Blob | File, opts?: {
-        name?: string;
-        read?: boolean;
-        compress?: boolean;
-        charset?: string | "auto";
-    }): Promise<Attachment>;
-    /** Parameters for the {@link on_drop} handler. */
-    interface OnDropOpts {
-        /** Callback invoked per created attachment (files only). */
-        callback: (attachment: Attachment) => any;
-        /** Whether to read bytes immediately. Default true. */
-        read?: boolean;
-        /** Whether to gzip after reading. Default false. */
-        compress?: boolean;
-        /** Max uncompressed size per file (-1 disables). Default 50MB. */
-        max_size?: number;
-        /** Max cumulative uncompressed size (-1 disables). Default 50MB. */
-        total_max_size?: number;
-        /** Called at drag start. */
-        on_start?: (event: DragEvent) => any;
-        /** Called at drag end. */
-        on_stop?: (event: DragEvent) => any;
-        /** Error callback. */
-        on_error?: (error: Error) => any;
-    }
-    /**
-     * Handle drag/drop; recursively traverses directories and adds only files.
-     * Uses FS Access API when available, falls back to WebKit entries, otherwise flat files only.
-     */
-    function on_drop(node: AnyElement, sink: Attachment[], opts: OnDropOpts): void;
-}

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

@@ -1,306 +0,0 @@
-/**
- * @author ...
- * @copyright ...
- */
-import { Compression } from "./compression.js";
-/** A file attachment with an internal byte buffer and compression/encoding helpers. */
-export class Attachment {
-    /** File or directory name. */
-    name;
-    /** Path relative to the dropped root. */
-    path;
-    /** MIME type of the data. */
-    mime_type;
-    /** Charset used for text decoding (if applicable). */
-    charset;
-    /** Whether the internal buffer is gzip-compressed. */
-    compressed;
-    /** Optional original File/Blob source. */
-    file;
-    /** Internal raw buffer (compressed or not depending on state). */
-    _bytes;
-    /** Create an Attachment from initial metadata and/or bytes. */
-    constructor(init) {
-        this.name = init.name;
-        this.path = init.path ?? "";
-        this.mime_type = init.mime_type ?? "";
-        this.charset = init.charset;
-        this.file = init.file;
-        this.compressed = !!init.compressed;
-        this._bytes = init.bytes ? Compression.to_uint8(init.bytes) : new Uint8Array(0);
-    }
-    /** Current size of the internal buffer in bytes (compressed if flagged). */
-    get size() { return this._bytes.byteLength; }
-    /** Get a copy of the internal buffer (leave compression state unchanged). */
-    bytes() { return new Uint8Array(this._bytes); }
-    /** Replace the internal buffer (optionally update compression flag). */
-    set_bytes(bytes, compressed = false) {
-        this._bytes = Compression.to_uint8(bytes);
-        this.compressed = compressed;
-        return this;
-    }
-    /** Ensure the buffer is gzip-compressed (noop if already compressed). */
-    compress(options = { level: 9 }) {
-        if (!this.compressed) {
-            this._bytes = Compression.compress(this._bytes, options);
-            this.compressed = true;
-        }
-        return this;
-    }
-    /** Ensure the buffer is uncompressed (noop if already uncompressed). */
-    decompress() {
-        if (this.compressed) {
-            this._bytes = Compression.decompress(this._bytes);
-            this.compressed = false;
-        }
-        return this;
-    }
-    /** Return Base64 of the current buffer (compressed or not). */
-    to_base64({ url_safe = false } = {}) {
-        return Compression.to_base64(this._bytes, { url_safe });
-    }
-    /**
-     * Return a string view of the data using a charset.
-     * @param decompress Whether to decompress first if compressed. Default true.
-     * @param encoding Charset label; defaults to this.charset or "utf-8".
-     */
-    to_string(decompress = true, encoding) {
-        const buf = decompress && this.compressed ? Compression.decompress(this._bytes) : this._bytes;
-        const enc = (encoding ?? this.charset ?? "utf-8").toLowerCase();
-        if (enc === "utf-8" || enc === "utf8")
-            return new TextDecoder().decode(buf);
-        try {
-            return new TextDecoder(enc).decode(buf);
-        }
-        catch {
-            return new TextDecoder().decode(buf);
-        }
-    }
-    /**
-     * Parse JSON from the data.
-     * @param decompress Whether to decompress first if compressed. Default true.
-     */
-    to_json(decompress = true) {
-        return JSON.parse(this.to_string(decompress));
-    }
-    /**
-     * Convert this attachment to a backend REST API attachment payload.
-     *
-     * This returns an object compatible with the server's `Mail.Attachment.RestAPI`
-     * shape using either:
-     *  - `{ content, encoding }` (default; embeds the payload), or
-     *  - `{ url }` (streams from an http(s)/data URL).
-     *
-     * @param opts Conversion options.
-     * @param opts.encoding Output string encoding for `content`. Defaults to `"base64"`.
-     *                      Supported: `"base64" | "hex" | "utf8"`.
-     *                      Use `"utf8"` only for textual data.
-     * @param opts.decompress Whether to decompress before encoding. Defaults to `true`.
-     * @param opts.url Optional http(s) or data: URL. When provided, `content`/`encoding`
-     *                 are omitted and the server will stream from this URL.
-     *
-     * @returns A REST API attachment payload with metadata plus either `{ content, encoding }` or `{ url }`.
-     */
-    to_rest_api(opts = {}) {
-        const { encoding = "base64", decompress = true, url } = opts;
-        const base = {
-            name: this.name,
-            path: this.path || undefined,
-            mime_type: this.mime_type || undefined,
-            charset: this.charset || undefined,
-            compressed: this.compressed || undefined,
-        };
-        if (url) {
-            return { ...base, url };
-        }
-        const bytes = decompress && this.compressed ? Compression.decompress(this._bytes) : this._bytes;
-        if (encoding === "base64") {
-            return { ...base, content: Compression.to_base64(bytes, { url_safe: false }), encoding };
-        }
-        if (encoding === "hex") {
-            // encode bytes -> hex (lowercase)
-            const hex = (() => {
-                const v = bytes;
-                let out = "";
-                for (let i = 0; i < v.length; i++) {
-                    const h = v[i].toString(16).padStart(2, "0");
-                    out += h;
-                }
-                return out;
-            })();
-            return { ...base, content: hex, encoding };
-        }
-        if (encoding === "utf8") {
-            // textual encoding (may be lossy for binary data)
-            const text = new TextDecoder().decode(bytes);
-            return { ...base, content: text, encoding };
-        }
-        // fallback to base64 if unsupported encoding is passed
-        return { ...base, content: Compression.to_base64(bytes, { url_safe: false }), encoding: "base64" };
-    }
-    /** Clone the attachment, including bytes and metadata. */
-    clone() {
-        return new Attachment({
-            name: this.name,
-            path: this.path,
-            mime_type: this.mime_type,
-            charset: this.charset,
-            bytes: this.bytes(),
-            file: this.file,
-            compressed: this.compressed,
-        });
-    }
-}
-(function (Attachment) {
-    /** Create an Attachment from a Blob/File; optionally read and compress. */
-    async function from_blob(blob, opts = {}) {
-        const name = (opts.name ?? blob.name) || "blob";
-        const mime_type = blob.type || "";
-        const charset = (() => {
-            const label = opts.charset ?? "auto";
-            if (label !== "auto")
-                return label;
-            const m = /charset\s*=\s*([^;]+)/i.exec(mime_type);
-            return m ? m[1].trim().toLowerCase() : undefined;
-        })();
-        const att = new Attachment({ name, mime_type, charset, file: blob, bytes: new Uint8Array(0), compressed: false });
-        if (opts.read !== false) {
-            const ab = "arrayBuffer" in blob
-                ? await blob.arrayBuffer()
-                : await new Promise((res, rej) => {
-                    const r = new FileReader();
-                    r.onerror = () => rej(r.error);
-                    r.onload = () => res(r.result);
-                    r.readAsArrayBuffer(blob);
-                });
-            att.set_bytes(new Uint8Array(ab), false);
-            if (opts.compress)
-                att.compress();
-        }
-        return att;
-    }
-    Attachment.from_blob = from_blob;
-    /**
-     * Handle drag/drop; recursively traverses directories and adds only files.
-     * Uses FS Access API when available, falls back to WebKit entries, otherwise flat files only.
-     */
-    function on_drop(node, sink, opts) {
-        let { callback, read = true, compress = false, on_start, on_stop, on_error = (e) => console.error(e), max_size = 50 * 1024 * 1024, total_max_size = 50 * 1024 * 1024, } = opts;
-        /** Sum current sink sizes. */
-        const sink_total = () => sink.reduce((a, b) => a + b.size, 0);
-        /** Guard size constraints. */
-        const enforce_sizes = (file) => {
-            if (max_size !== -1 && file.size > max_size) {
-                on_error(new Error(`Attachment '${file.name}' exceeds the size limit of ${Math.round(max_size / (1024 * 1024))}MB.`));
-                return false;
-            }
-            if (total_max_size !== -1 && (sink_total() + file.size) > total_max_size) {
-                on_error(new Error(`Attachment '${file.name}' exceeds the total size limit of ${Math.round(total_max_size / (1024 * 1024))}MB.`));
-                return false;
-            }
-            return true;
-        };
-        /** Push a file as Attachment (respects read/compress). */
-        const push_file = async (file, rel_path = "") => {
-            if (!enforce_sizes(file))
-                return;
-            try {
-                const att = await Attachment.from_blob(file, { read, compress });
-                att.path = rel_path || file.path || file.name;
-                sink.push(att);
-                callback(att);
-            }
-            catch (e) {
-                on_error(e instanceof Error ? e : new Error(String(e)));
-            }
-        };
-        /** FS Access API: recursively collect files from a directory handle. */
-        const walk_fs_handle = async (handle, prefix = "") => {
-            if (handle.kind === "file") {
-                const file = await handle.getFile();
-                await push_file(file, `${prefix}${file.name}`);
-                return;
-            }
-            if (handle.kind === "directory") {
-                // @ts-ignore: async iterator is standard on Chromium
-                for await (const [name, child] of handle.entries()) {
-                    await walk_fs_handle(child, `${prefix}${name}/`);
-                }
-            }
-        };
-        /** WebKit fallback: recursively collect files from a FileSystemEntry directory. */
-        const walk_webkit_entry = async (entry, prefix = "") => {
-            if (entry.isFile) {
-                await new Promise((resolve, reject) => {
-                    entry.file(async (file) => { try {
-                        await push_file(file, `${prefix}${file.name}`);
-                        resolve();
-                    }
-                    catch (e) {
-                        reject(e);
-                    } }, reject);
-                });
-                return;
-            }
-            if (entry.isDirectory) {
-                const reader = entry.createReader();
-                const read_all = async () => new Promise((res, rej) => reader.readEntries((ents) => res(ents), rej));
-                // readEntries may return partial batches; keep reading until empty
-                for (;;) {
-                    const batch = await read_all();
-                    if (!batch.length)
-                        break;
-                    for (const child of batch) {
-                        await walk_webkit_entry(child, `${prefix}${entry.name ? entry.name + "/" : ""}${child.name ? "" : ""}`);
-                        // Note: child.name is already included when recursing into child; build prefix at directory level:
-                    }
-                }
-            }
-        };
-        node.ondragover = (event) => {
-            event.preventDefault();
-            event.dataTransfer && (event.dataTransfer.dropEffect = "copy");
-            on_start?.(event);
-        };
-        node.ondragend = (event) => { event.preventDefault(); on_stop?.(event); };
-        node.ondrop = (event) => {
-            event.preventDefault();
-            const items = event.dataTransfer?.items;
-            if (!items)
-                return;
-            // Process each DataTransferItem
-            (async () => {
-                for (let i = 0; i < items.length; i++) {
-                    const item = items[i];
-                    if (item.kind !== "file")
-                        continue;
-                    // Prefer FS Access API if available.
-                    const get_handle = item.getAsFileSystemHandle?.bind(item);
-                    if (get_handle) {
-                        try {
-                            const handle = await get_handle();
-                            // handle can be file or directory
-                            await walk_fs_handle(handle, "");
-                            continue;
-                        }
-                        catch { /* fall through to other paths */ }
-                    }
-                    // WebKit directory traversal fallback.
-                    const entry = item.webkitGetAsEntry?.();
-                    if (entry && (entry.isDirectory || entry.isFile)) {
-                        try {
-                            await walk_webkit_entry(entry, "");
-                            continue;
-                        }
-                        catch { /* fall through */ }
-                    }
-                    // Basic file fallback: just the file (most browsers).
-                    const file = item.getAsFile();
-                    if (file)
-                        await push_file(file, file.name);
-                }
-            })().catch((e) => on_error(e instanceof Error ? e : new Error(String(e))));
-        };
-    }
-    Attachment.on_drop = on_drop;
-})(Attachment || (Attachment = {}));

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

@@ -1,44 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
- */
-import type { Users as UsersBackend } from "../../../backend/src/users.js";
-import { Request } from "./request.js";
-export declare namespace Auth {
-    /**
-     * Make a sign in request.
-     * @param payload The request payload.
-     * @docs
-     */
-    function sign_in(payload: UsersBackend.Endpoints.SignIn["payload"]): Request.ResultPromiseFromInfo<UsersBackend.Endpoints.SignIn>;
-    /**
-     * Make a sign up request.
-     *
-     * Note that a request can be made first without the `payload.code` field,
-     * when all other fields are correctly defined it will return a {@link Status.two_factor_auth_required} backend status.
-     * Indicating a two-factor authentication challenge is sent, prompt the user to the next screen where the user can fill in the 2fa code.
-     * Then retrieve the 2fa code and resubmit the request with the code included.
-     *
-     * @param payload The request payload.
-     * @docs
-     */
-    function sign_up(payload: UsersBackend.Endpoints.SignUp["payload"]): Request.ResultPromiseFromInfo<UsersBackend.Endpoints.SignUp>;
-    /**
-     * Make a sign out request.
-     * @docs
-     */
-    function sign_out(): Request.ResultPromiseFromInfo<UsersBackend.Endpoints.SignOut>;
-    /**
-     * Make a send 2FA request.
-     * @param payload The request payload.
-     * @docs
-     */
-    function send_2fa(payload: UsersBackend.Endpoints.Send2FA["payload"]): Request.ResultPromiseFromInfo<UsersBackend.Endpoints.Send2FA>;
-    /**
-     * Make a forgot password request.
-     * @param payload The request payload.
-     * @docs
-     */
-    function forgot_password(payload: UsersBackend.Endpoints.ForgotPassword["payload"]): Request.ResultPromiseFromInfo<UsersBackend.Endpoints.ForgotPassword>;
-}
-export { Auth as auth };

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

@@ -1,80 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2022 - 2025 Daan van den Bergh. All rights reserved
- */
-import { request } from "./request.js";
-// Namespace.
-export var Auth;
-(function (Auth) {
-    /**
-     * Make a sign in request.
-     * @param payload The request payload.
-     * @docs
-     */
-    function sign_in(payload) {
-        return request({
-            method: "POST",
-            url: "/volt/api/v1/auth/signin",
-            data: payload,
-        });
-    }
-    Auth.sign_in = sign_in;
-    /**
-     * Make a sign up request.
-     *
-     * Note that a request can be made first without the `payload.code` field,
-     * when all other fields are correctly defined it will return a {@link Status.two_factor_auth_required} backend status.
-     * Indicating a two-factor authentication challenge is sent, prompt the user to the next screen where the user can fill in the 2fa code.
-     * Then retrieve the 2fa code and resubmit the request with the code included.
-     *
-     * @param payload The request payload.
-     * @docs
-     */
-    function sign_up(payload) {
-        return request({
-            method: "POST",
-            url: "/volt/api/v1/auth/signup",
-            data: payload,
-        });
-    }
-    Auth.sign_up = sign_up;
-    /**
-     * Make a sign out request.
-     * @docs
-     */
-    function sign_out() {
-        return request({
-            method: "POST",
-            url: "/volt/api/v1/auth/signout",
-        });
-    }
-    Auth.sign_out = sign_out;
-    /**
-     * Make a send 2FA request.
-     * @param payload The request payload.
-     * @docs
-     */
-    function send_2fa(payload) {
-        return request({
-            method: "POST",
-            url: "/volt/api/v1/auth/2fa",
-            data: payload,
-        });
-    }
-    Auth.send_2fa = send_2fa;
-    /**
-     * Make a forgot password request.
-     * @param payload The request payload.
-     * @docs
-     */
-    function forgot_password(payload) {
-        return request({
-            method: "POST",
-            url: "/volt/api/v1/auth/forgot_password",
-            data: payload,
-        });
-    }
-    Auth.forgot_password = forgot_password;
-})(Auth || (Auth = {}));
-;
-export { Auth as auth }; // also export as lowercase for compatibility.