@vandenberghinc/volt 1.1.26 → 1.1.28

package/backend/dist/esm/file_watcher.js

@@ -1,329 +0,0 @@
-/*
- * Author: Daan van den Bergh
- * Copyright: © 2022 - 2024 Daan van den Bergh.
- * @deprecated use tsc & nodemon instead.
- */
-export {};
-// // ---------------------------------------------------------
-// // Libraries.
-// import * as fs from "fs";
-// import * as path from "path";
-// import { spawn, type ChildProcess } from "child_process";
-// import { vlib } from "./vinc.js";
-// import { BrowserPreview } from "./plugins/browser.js";
-// import { logger, LogSource } from "./logger.js";
-// // ---------------------------------------------------------
-// // Static endpoints file watcher watcher only used for checking static files with reloads.
-// class StaticFileWatcher {
-//     private server: any;
-//     private mtimes: Map<string, number>;
-//     private endpoints: Map<string, any>;
-//     // @ts-ignore
-//     private log_source: LogSource;
-//     private interval: NodeJS.Timeout | undefined;
-//     constructor(server: any) {
-//         this.server = server;
-//         this.mtimes = new Map();
-//         this.endpoints = new Map();
-//         this.log_source = new LogSource("StaticFileWatcher");
-//     }
-//     async start(): Promise<void> {
-//         // Set interval.
-//         this.interval = setInterval(async () => {
-//             // Changed endpoints.
-//             const changed_endpoints: string[] = [];
-//             let changed_aspect_ratio = false;
-//             // Check file paths.
-//             for (const endpoint of this.endpoints.values()) {
-//                 if (endpoint._path && !endpoint.view?.is_js_ts_view) {
-//                     const path = new vlib.Path(endpoint._path);
-//                     if (path.mtime !== this.mtimes.get(endpoint._path)) {
-//                         if (this.mtimes.get(endpoint._path) != null) {
-//                             logger.log(1, `Refreshing endpoint ${endpoint.method}:${endpoint.endpoint}.`)
-//                             // Image.
-//                             if (endpoint.is_image_endpoint) {
-//                                 endpoint._clear_cache();
-//                                 const aspect_ratio = await endpoint.get_aspect_ratio()
-//                                 if (aspect_ratio && this.server.statics_aspect_ratios.get(endpoint.endpoint) !== aspect_ratio) {
-//                                     changed_aspect_ratio = true;
-//                                     this.server.statics_aspect_ratios.set(endpoint.endpoint, aspect_ratio);
-//                                 }
-//                             }
-//                             // Static file.
-//                             else if (endpoint.view == null) {
-//                                 endpoint._load_data_by_path(this.server);
-//                                 changed_endpoints.push(endpoint.endpoint);
-//                             }
-//                             // Refresh browser.
-//                             if (this.server.browser_preview) {
-//                                 await this.server.browser_preview.refresh(endpoint.endpoint);
-//                             }
-//                         }
-//                         this.mtimes.set(endpoint._path, path.mtime);
-//                     }
-//                 }
-//             }
-//             // Iterate all endpoints using view to check if any included scripts have changed.
-//             for (const endpoint of this.endpoints.values()) {
-//                 if (endpoint.view && !endpoint.view?.is_js_ts_view) {
-//                     let changed = changed_aspect_ratio;
-//                     if (!changed && changed_endpoints.length > 0) {
-//                         changed = endpoint.view._embedded_sources.some(url => {
-//                             return changed_endpoints.includes(url);
-//                         });
-//                     }
-//                     if (changed) {
-//                         logger.log(1, `Refreshing endpoint ${endpoint.method}:${endpoint.endpoint}.`)
-//                         endpoint._refresh(this.server)
-//                         if (this.server.browser_preview) {
-//                             await this.server.browser_preview.refresh(endpoint.endpoint);
-//                         }
-//                     }
-//                 }
-//             }
-//         }, 500)
-//     }
-//     add(endpoint: any): void {
-//         if (endpoint._path) {
-//             this.mtimes.set(endpoint._path, new vlib.Path(endpoint._path).mtime)   
-//         }
-//         this.endpoints.set(endpoint.endpoint, endpoint);
-//     }
-//     has(endpoint: string): boolean {
-//         return this.endpoints.has(endpoint);
-//     }
-//     stop(): void {
-//         if (this.interval) {
-//             clearInterval(this.interval)
-//         }
-//     }
-// }
-// // ---------------------------------------------------------
-// // File watcher watching entire files and restarting when needed.
-// /*  @docs:
-//  *  @nav: Backend
-//     @chapter: Server
-//     @title: FileWatcher
-//     @description: 
-//         Used to watch all included files and restart the server when any changes have been made.
-//     @parameter:
-//         @name: source
-//         @description: The path to the source directory to watch.
-//         @type: string
-//     @parameter:
-//         @name: config
-//         @description: The path to the server's configuration file.
-//         @type: string
-//     @parameter:
-//         @name: interval
-//         @description: The interval in milliseconds between file change checks.
-//         @type: number
-//     @parameter:
-//         @name: start_file
-//         @description: The optional start js file to start the server.
-//         @type: string
-//  */
-// class FileWatcher {
-//     private source: string;
-//     private config?: string;
-//     private interval: number;
-//     private excluded: string[];
-//     private additional_paths: string[];
-//     private start_file?: string;
-//     // @ts-ignore
-//     private log_source: LogSource;
-//     private args: string[];
-//     private mtimes: Record<string, number>;
-//     public promise: Promise<any>;
-//     private proc!: ChildProcess;
-//     private has_changed: boolean = false;
-//     private _com_file?: any;
-//     constructor({
-//         source,
-//         config = undefined,
-//         interval = 750,
-//         excluded = [],
-//         additional_paths = [],
-//         start_file = undefined,
-//     }: {
-//         source: vlib.Path | string,
-//         config?: string,
-//         interval?: number,
-//         excluded?: string[],
-//         additional_paths?: string[],
-//         start_file?: string,
-//     }) {
-//         // Arguments.
-//         // this.source = source == null ? source : new vlib.Path(source).abs().str();
-//         this.config = config;
-//         this.interval = interval;
-//         this.excluded = excluded ?? [];
-//         this.excluded = this.excluded.filter(Boolean).map(path => new vlib.Path(path).abs().str())
-//         this.start_file = start_file;
-//         // Check source.
-//         if (source) {
-//             source = new vlib.Path(source).abs().str();
-//         }
-//         if ((source as any) instanceof vlib.Path) {
-//             source = (source as any).str();
-//         }
-//         this.source = source as string;
-//         if (this.source == null) {
-//             throw Error("Define argument: source.");
-//         }
-//         this.log_source = new LogSource("FileWatcher");
-//         // Check if the excluded paths exist for user mistakes, these happen often.
-//         this.excluded.forEach(path => {
-//             if (!new vlib.Path(path).exists()) {
-//                 logger.warn(1, `Excluded file watcher path ${path} does not exist.`);
-//             }
-//         })
-//         // Attributes.
-//         this.additional_paths = additional_paths.map(path => new vlib.Path(path).abs().str());
-//         this.args = [];
-//         this.mtimes = {};
-//         this.promise = new Promise(() => {});
-//     }
-//     // Add path.
-//     add_path(path: string | vlib.Path): void {
-//         try {
-//             const add = new vlib.Path(path).abs().str();
-//             logger.log(2, "Add file watcher exclude", add)
-//             this.additional_paths.push(add)
-//         } catch (e) {
-//             logger.warn(0, `Additional file watcher path ${path.toString()} does not exist.`);
-//         }
-//     }
-//     // Add exclude.
-//     add_exclude(path: string | vlib.Path): void {
-//         try {
-//             const add = new vlib.Path(path).abs().str();
-//             logger.log(2, "Add file watcher exclude", add)
-//             this.excluded.push(add)
-//         } catch (e) {
-//             logger.warn(1, `Excluded file watcher path ${path.toString()} does not exist.`);
-//         }
-//     }
-//     // Start.
-//     async start(): Promise<void> {
-//         process.on('SIGTERM', () => {
-//             this.proc.kill("SIGTERM");
-//             process.exit(0)
-//         });
-//         process.on('SIGINT', () => {
-//             this.proc.kill("SIGINT");
-//             process.exit(0)
-//         });
-//         // Spawn process.
-//         this.scan_files();
-//         this.has_changed = false;
-//         this.spawn_process();
-//         this.args.push("--file-watcher-restart")
-//         // Start scan loop.
-//         await this.scan();
-//     }
-//     // Scan.
-//     async scan(): Promise<void> {
-//         this.scan_files()
-//         let interval = this.interval;
-//         if (this.has_changed) {
-//             interval += 250;
-//             await new Promise((resolve) => {
-//                 setTimeout(async () => {
-//                     this.scan_files()
-//                     this.has_changed = false;
-//                     await this.restart_process();
-//                     resolve(null);
-//                 }, 250)
-//             })
-//         }
-//         setTimeout(() => this.scan(), interval);
-//     }
-//     // Scan files.
-//     scan_files(): void {
-//         const scan_files = (dir: string) => {
-//             fs.readdirSync(dir).forEach((name) => scan_file(path.join(dir, name)));    
-//         }
-//         const scan_file = (path: string) => {
-//             if (this.excluded.includes(path)) {
-//                 return null;
-//             }
-//             let stat;
-//             try {
-//                 stat = fs.statSync(path);
-//             } catch (e) {
-//                 delete this.mtimes[path]; // a file was deleted.
-//                 return;    
-//             }
-//             if (this.mtimes[path] != stat.mtimeMs) {
-//                 if (this.mtimes[path] != null) {
-//                     logger.log(1, `Source file ${path} changed.`);
-//                 }
-//                 this.has_changed = true;
-//             }
-//             this.mtimes[path] = stat.mtimeMs;
-//             if (stat.isDirectory()) {
-//                 scan_files(path)
-//             }
-//         }
-//         scan_files(this.source);
-//         this.additional_paths.forEach((path) => scan_file(path));
-//     }
-//     // Spawn process.
-//     spawn_process(): void {
-//         if (this._com_file === undefined) {
-//             // @ts-ignore
-//             this._com_file = new vlib.Path(`/tmp/${String.random(12)}`);
-//         }
-//         if (this.config == null && this.start_file == null) {
-//             throw new Error("When 'Server.file_watcher.start_file' is undefined, the server must be started using `$ volt --start` in order to use the file watcher.");
-//         }
-//         this.proc = spawn(
-//             this.start_file ? "node" : "volt",
-//             this.start_file
-//                 ? [this.start_file, ...this.args, ...process.argv]
-//                 : ["--start", "--config", this.config || "", ...this.args, ...process.argv],
-//             {
-//                 cwd: this.source,
-//                 stdio: "inherit",
-//                 env: {
-//                     ...process.env,
-//                     "VOLT_FILE_WATCHER": "1",
-//                     "VOLT_STARTED_FILE": this._com_file.str(),
-//                 },
-//             }
-//         );
-//         this.proc.on("exit", (code) => {
-//             if (code === 0) {
-//                 this.scan_files(); // scan again so any subsequent file changes will be updated as well.
-//                 this.has_changed = false;
-//                 this.spawn_process();
-//             } else {
-//                 process.exit(code || 1);
-//             }
-//         })
-//         this.proc.on("error", (e) => {
-//             console.error(e)
-//             process.exit(1);
-//         })
-//     }
-//     // Spawn process.
-//     async restart_process(): Promise<void> {
-//         logger.log(0, `Restarting server due to file changes.`);
-//         this._com_file.save_sync("0");
-//         this.has_changed = false;
-//         this.proc.kill("SIGINT");
-//         await new Promise<void>((resolve) => {
-//             const loop = () => {
-//                 if (this._com_file.load_sync() === "1") {
-//                     return resolve();
-//                 }
-//                 setTimeout(loop, 150)
-//             }
-//             loop();
-//         })
-//     }
-// }
-// // ---------------------------------------------------------
-// // Exports.
-// export { StaticFileWatcher, FileWatcher };

package/backend/dist/esm/logger.d.ts

@@ -1,3 +0,0 @@
-import * as vlib from "@vandenberghinc/vlib";
-export declare const logger: vlib.Logging.Logger;
-export default logger;

package/backend/dist/esm/logger.js

@@ -1,11 +0,0 @@
-/*
- * Author: Daan van den Bergh
- * Copyright: © 2022 - 2024 Daan van den Bergh.
- */
-// ---------------------------------------------------------
-// Logger.
-import * as vlib from "@vandenberghinc/vlib";
-export const logger = new vlib.logging.Logger({
-    log_level: 0,
-});
-export default logger;

package/backend/dist/esm/meta.d.ts

@@ -1,50 +0,0 @@
-export declare class Meta {
-    author: string | null;
-    title: string | null;
-    description: string | null;
-    image: string | null;
-    robots: string;
-    charset: string;
-    viewport: string;
-    favicon: string;
-    constructor({ author, title, description, image, robots, charset, viewport, favicon, }?: {
-        author?: string | null;
-        title?: string | null;
-        description?: string | null;
-        image?: string | null;
-        robots?: string;
-        charset?: string;
-        viewport?: string;
-        favicon?: string;
-    });
-    copy(override?: {
-        author?: string | null;
-        title?: string | null;
-        description?: string | null;
-        image?: string | null;
-        robots?: string;
-        charset?: string;
-        viewport?: string;
-        favicon?: string;
-    }): Meta;
-    set_author(value: string | null): this;
-    set_title(value: string | null): this;
-    set_description(value: string | null): this;
-    set_image(value: string | null): this;
-    set_robots(value: string): this;
-    set_charset(value: string): this;
-    set_viewport(value: string): this;
-    set_favicon(value: string): this;
-    obj(): {
-        author: string | null;
-        title: string | null;
-        description: string | null;
-        image: string | null;
-        robots: string;
-        charset: string;
-        viewport: string;
-        favicon: string;
-    };
-    build_html(domain?: string | null): string;
-}
-export default Meta;

package/backend/dist/esm/mutex.d.ts

@@ -1,24 +0,0 @@
-/** @docs
- *  @chapter: System
- *  @title: Mutex
- *  @desc: A mutual exclusion primitive useful for protecting shared data structures from concurrent access
- */
-export declare class Mutex {
-    private locked;
-    private queue;
-    constructor();
-    /** @docs
-     *  @title: Lock
-     *  @desc: Acquire the mutex lock. Should be awaited
-     *  @returns
-     *      @type Promise<void>
-     *      @desc Resolves when the lock is acquired
-     */
-    lock(): Promise<void>;
-    /** @docs
-     *  @title: Unlock
-     *  @desc: Release the mutex lock
-     */
-    unlock(): void;
-}
-export default Mutex;

package/backend/dist/esm/mutex.js

@@ -1,48 +0,0 @@
-/*
- * Author: Daan van den Bergh
- * Copyright: © 2022 - 2024 Daan van den Bergh.
- */
-/** @docs
- *  @chapter: System
- *  @title: Mutex
- *  @desc: A mutual exclusion primitive useful for protecting shared data structures from concurrent access
- */
-export class Mutex {
-    locked;
-    queue;
-    constructor() {
-        this.locked = false;
-        this.queue = [];
-    }
-    /** @docs
-     *  @title: Lock
-     *  @desc: Acquire the mutex lock. Should be awaited
-     *  @returns
-     *      @type Promise<void>
-     *      @desc Resolves when the lock is acquired
-     */
-    async lock() {
-        if (!this.locked) {
-            this.locked = true;
-        }
-        else {
-            return new Promise((resolve) => {
-                this.queue.push(resolve);
-            });
-        }
-    }
-    /** @docs
-     *  @title: Unlock
-     *  @desc: Release the mutex lock
-     */
-    unlock() {
-        if (this.queue.length > 0) {
-            const next_resolve = this.queue.shift();
-            next_resolve();
-        }
-        else {
-            this.locked = false;
-        }
-    }
-}
-export default Mutex;

package/backend/dist/esm/payments/paddle.d.ts

@@ -1,160 +0,0 @@
-export interface ProductObject {
-    id: string;
-    name: string;
-    price: number;
-    currency: string;
-    tax_category: string;
-    icon?: string;
-    frequency?: number;
-    interval?: 'day' | 'week' | 'month' | 'year';
-    trial?: {
-        frequency: number;
-        interval: 'day' | 'week' | 'month' | 'year';
-    } | null;
-    plans?: ProductObject[];
-    description: string;
-    paddle_prod_id?: string;
-    price_id?: string;
-    is_subscription?: boolean;
-    subscription_id?: string;
-}
-export interface PaymentBillingDetails {
-    name?: string;
-    email?: string;
-    business?: string;
-    vat_id?: string;
-    address?: string;
-    city?: string;
-    postal_code?: string;
-    province?: string;
-    country?: string;
-    tax_identifier?: string;
-}
-export interface LineItem {
-    product: string;
-    item_id: string;
-    paddle_prod_id: string;
-    quantity: number;
-    tax_rate: number;
-    tax: number;
-    discount: number;
-    subtotal: number;
-    total: number;
-    status: 'paid' | 'refunded' | 'refunding';
-}
-export interface ExpandedLineItem extends Omit<LineItem, 'product'> {
-    product: ProductObject;
-}
-export type PaymentStatus = 'open' | 'paid' | 'past_due' | 'unknown';
-export interface Payment {
-    id: string;
-    uid: string;
-    cus_id: string;
-    tran_id: string;
-    timestamp: number;
-    status: PaymentStatus;
-    line_items: LineItem[];
-    billing_details: PaymentBillingDetails;
-    sub_id?: string;
-}
-export interface ExpandedPayment extends Omit<Payment, 'line_items'> {
-    line_items: ExpandedLineItem[];
-}
-export type SubscriptionStatus = 'active' | 'cancelling' | 'cancelled';
-export interface Subscription {
-    uid: string;
-    id: string;
-    cus_id: string;
-    status: SubscriptionStatus;
-    plans: string[];
-}
-export interface PaddleConstructorOptions {
-    api_key: string;
-    client_key: string;
-    sandbox?: boolean;
-    products?: ProductObject[];
-    inclusive_tax?: boolean;
-    _server?: any;
-}
-export declare class Paddle {
-    type: string;
-    private client_key;
-    private sandbox;
-    private inclusive_tax;
-    private products;
-    private server;
-    private _host;
-    private _headers;
-    private webhook_key?;
-    private _has_create_products_permission?;
-    private _settings_db;
-    private _sub_db;
-    private _active_sub_db;
-    private _pay_db;
-    private performance;
-    constructor({ api_key, client_key, sandbox, products, inclusive_tax, _server, }: PaddleConstructorOptions);
-    private _req;
-    private _add_subscription;
-    private _delete_subscription;
-    private _check_subscription;
-    private _get_active_subscriptions;
-    private _save_subscription;
-    private _load_subscription;
-    private _get_subscriptions;
-    private _save_payment;
-    private _load_payment;
-    private _load_payment_by_transaction;
-    private _delete_payment;
-    _delete_user(uid: string): Promise<void>;
-    _get_all_active_subscriptions(): Promise<any[]>;
-    private _get_product_by_paddle_prod_id;
-    private _get_products;
-    private _get_prices;
-    private _check_product;
-    private _cancel_subscription;
-    private _initialize_products;
-    _initialize(): Promise<void>;
-    private _exec_user_callback;
-    private _payment_webhook;
-    private _subscription_webhook;
-    private _subscription_cancelled_webhook;
-    private _adjustment_webhook;
-    private _create_webhook;
-    get_product(id: string): Promise<ProductObject | null>;
-    get_product(id: string, throw_err: true): Promise<ProductObject>;
-    get_product(id: string, throw_err: boolean): Promise<ProductObject | null>;
-    get_product_sync(id: string): ProductObject | null;
-    get_product_sync(id: string, throw_err: true): ProductObject;
-    get_product_sync(id: string, throw_err: boolean): ProductObject | null;
-    get_payment(id: string): Promise<Payment>;
-    get_payments({ uid, days, limit, status, }: {
-        uid: string;
-        days?: number;
-        limit?: number;
-        status?: string | string[];
-    }): Promise<Payment[]>;
-    get_refundable_payments({ uid, days, limit, }: {
-        uid: string;
-        days?: number;
-        limit?: number;
-    }): Promise<Payment[]>;
-    get_refunded_payments({ uid, days, limit, }: {
-        uid: string;
-        days?: number;
-        limit?: number;
-    }): Promise<Payment[]>;
-    get_refunding_payments({ uid, days, limit, }: {
-        uid: string;
-        days?: number;
-        limit?: number;
-    }): Promise<Payment[]>;
-    create_refund(payment: Payment | string, line_items?: LineItem[] | undefined, reason?: string): Promise<void>;
-    cancel_subscription(uid: string, products: string | (string | ProductObject)[], _throw_no_cancelled_err?: boolean): Promise<void>;
-    cancel_subscription_by_id(subscription: string | Subscription, immediate?: boolean): Promise<void>;
-    get_active_subscriptions(uid: string): Promise<string[]>;
-    get_subscriptions(uid: string): Promise<Subscription[]>;
-    is_subscribed(uid: string, product: string): Promise<boolean>;
-    generate_invoice(payment: Payment | ExpandedPayment): Promise<Buffer>;
-    dev_cancel_all_subscriptions(): Promise<void>;
-}
-export default Paddle;

package/backend/dist/esm/plugins/browser.d.ts

@@ -1,36 +0,0 @@
-export declare class BrowserPreview {
-    private browser_type;
-    private browser;
-    private context;
-    private page;
-    /**
-     * Initializes the browser_controller with the specified browser type.
-     * @param {string} browser - The browser to launch ('chrome' or 'firefox').
-     */
-    constructor(browser?: string);
-    /**
-     * Starts the browser and opens a new page.
-     */
-    start(): Promise<void>;
-    /**
-     * Stops the browser and cleans up resources.
-     */
-    stop(): Promise<void>;
-    /**
-     * Refreshes the active tab if its URL matches the specified endpoint.
-     * @param {string | RegExp} endpoint - The server endpoint URL to check against the active tab.
-     */
-    refresh(endpoint: string | RegExp): Promise<void>;
-    /**
-     * Opens the specified endpoint in the browser.
-     * @param {string} endpoint - The URL to navigate to.
-     */
-    navigate(endpoint: string): Promise<void>;
-    /**
-     * Normalizes URLs by removing trailing slashes and converting to lowercase.
-     * @param {string} url - The URL to normalize.
-     * @returns {string} - The normalized URL.
-     */
-    _normalize_url(url: string): string;
-}
-export default BrowserPreview;