@stella_project/stellalib 1.0.0

package/dist/Structures/Filters.d.ts

@@ -0,0 +1,140 @@
+/**
+ * @license
+ * StellaLib — Copyright (c) 2026 AntonyZ, x2sadddDM, SynX, Astel (OSL-3.0)
+ * Derived from LithiumX — Copyright (c) 2025 Anantix Network (MIT)
+ * See LICENSE and THIRD-PARTY-NOTICES.md for full license details.
+ */
+import { Band } from "../Utils/FiltersEqualizers";
+declare class Filters {
+    distortion: DistortionOptions | null;
+    equalizer: Band[];
+    karaoke: KaraokeOptions | null;
+    player: any;
+    rotation: RotationOptions | null;
+    timescale: TimescaleOptions | null;
+    vibrato: VibratoOptions | null;
+    volume: number;
+    private filterStatus;
+    constructor(player: any);
+    private updateFilters;
+    private applyFilter;
+    private setFilterStatus;
+    /**
+     * Sets the equalizer bands and updates the filters.
+     * @param bands The equalizer bands.
+     */
+    setEqualizer(bands?: Band[]): this;
+    /** Applies the distortion audio effect. */
+    distort(): this;
+    /** Applies the karaoke options specified by the filter. */
+    setKaraoke(status: boolean, karaoke?: KaraokeOptions): this;
+    /** Applies the timescale options specified by the filter. */
+    setTimescale(timescale?: TimescaleOptions | null): this;
+    /** Applies the vibrato options specified by the filter. */
+    setVibrato(vibrato?: VibratoOptions | null): this;
+    /** Applies the rotation options specified by the filter. */
+    setRotation(rotation?: RotationOptions | null): this;
+    /** Applies the distortion options specified by the filter. */
+    setDistortion(distortion?: DistortionOptions | null): this;
+    /**
+     * Set the 8D audio effect.
+     * @param status Whether to enable or disable.
+     */
+    setEightD(status: boolean): this;
+    /**
+     * Set the nightcore effect.
+     * @param status Whether to enable or disable.
+     */
+    setNightcore(status: boolean): this;
+    /**
+     * Set the slowmo effect.
+     * @param status Whether to enable or disable.
+     */
+    setSlowmo(status: boolean): this;
+    /**
+     * Set the soft effect.
+     * @param status Whether to enable or disable.
+     */
+    setSoft(status: boolean): this;
+    /**
+     * Set the treble bass effect.
+     * @param status Whether to enable or disable.
+     */
+    setTrebleBass(status: boolean): this;
+    /**
+     * Set the TV effect.
+     * @param status Whether to enable or disable.
+     */
+    setTV(status: boolean): this;
+    /**
+     * Set the vaporwave effect.
+     * @param status Whether to enable or disable.
+     */
+    setVaporwave(status: boolean): this;
+    /**
+     * Set the bass boost effect.
+     * @param status Whether to enable or disable.
+     */
+    setBassBoost(status: boolean): this;
+    /**
+     * Set the distort effect.
+     * @param status Whether to enable or disable.
+     */
+    setDistort(status: boolean): this;
+    /**
+     * Set a filter by name.
+     * @param filter The filter name.
+     * @param status Whether to enable or disable.
+     */
+    setFilter(filter: keyof AvailableFilters | string, status: boolean): Promise<this>;
+    /** Removes all audio effects and resets the filter status. */
+    clearFilters(): Promise<this>;
+    /** Returns the status of the specified filter. */
+    getFilterStatus(filter: keyof AvailableFilters): boolean;
+}
+/** Options for adjusting the timescale of audio. */
+interface TimescaleOptions {
+    speed?: number;
+    pitch?: number;
+    rate?: number;
+}
+/** Options for applying vibrato effect to audio. */
+interface VibratoOptions {
+    frequency: number;
+    depth: number;
+}
+/** Options for applying rotation effect to audio. */
+interface RotationOptions {
+    rotationHz: number;
+}
+/** Options for applying karaoke effect to audio. */
+interface KaraokeOptions {
+    level?: number;
+    monoLevel?: number;
+    filterBand?: number;
+    filterWidth?: number;
+}
+interface DistortionOptions {
+    sinOffset?: number;
+    sinScale?: number;
+    cosOffset?: number;
+    cosScale?: number;
+    tanOffset?: number;
+    tanScale?: number;
+    offset?: number;
+    scale?: number;
+}
+interface AvailableFilters {
+    bassboost: boolean;
+    distort: boolean;
+    eightD: boolean;
+    karaoke: boolean;
+    nightcore: boolean;
+    slowmo: boolean;
+    soft: boolean;
+    trebleBass: boolean;
+    tv: boolean;
+    vaporwave: boolean;
+}
+export { Filters, TimescaleOptions, VibratoOptions, RotationOptions, KaraokeOptions, DistortionOptions, AvailableFilters, };
+//# sourceMappingURL=Filters.d.ts.map

package/dist/Structures/Filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Filters.d.ts","sourceRoot":"","sources":["../../src/Structures/Filters.ts"],"names":[],"mappings":"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"}

package/dist/Structures/Filters.js

@@ -0,0 +1,315 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Filters = void 0;
+/**
+ * @license
+ * StellaLib — Copyright (c) 2026 AntonyZ, x2sadddDM, SynX, Astel (OSL-3.0)
+ * Derived from LithiumX — Copyright (c) 2025 Anantix Network (MIT)
+ * See LICENSE and THIRD-PARTY-NOTICES.md for full license details.
+ */
+const FiltersEqualizers_1 = require("../Utils/FiltersEqualizers");
+class Filters {
+    distortion;
+    equalizer;
+    karaoke;
+    player;
+    rotation;
+    timescale;
+    vibrato;
+    volume;
+    filterStatus;
+    constructor(player) {
+        this.distortion = null;
+        this.equalizer = [];
+        this.karaoke = null;
+        this.player = player;
+        this.rotation = null;
+        this.timescale = null;
+        this.vibrato = null;
+        this.volume = 1.0;
+        this.filterStatus = {
+            bassboost: false,
+            distort: false,
+            eightD: false,
+            karaoke: false,
+            nightcore: false,
+            slowmo: false,
+            soft: false,
+            trebleBass: false,
+            tv: false,
+            vaporwave: false,
+        };
+    }
+    async updateFilters() {
+        const { distortion, equalizer, karaoke, rotation, timescale, vibrato, volume } = this;
+        await this.player.node.rest.updatePlayer({
+            guildId: this.player.guild,
+            data: {
+                filters: {
+                    distortion,
+                    equalizer,
+                    karaoke,
+                    rotation,
+                    timescale,
+                    vibrato,
+                    volume,
+                },
+            },
+        });
+        return this;
+    }
+    applyFilter(filter, shouldUpdate = true) {
+        this[filter.property] = filter.value;
+        if (shouldUpdate) {
+            this.updateFilters();
+        }
+        return this;
+    }
+    setFilterStatus(filter, status) {
+        this.filterStatus[filter] = status;
+        return this;
+    }
+    /**
+     * Sets the equalizer bands and updates the filters.
+     * @param bands The equalizer bands.
+     */
+    setEqualizer(bands) {
+        return this.applyFilter({ property: "equalizer", value: bands ?? [] });
+    }
+    /** Applies the distortion audio effect. */
+    distort() {
+        return this.setDistortion({
+            sinOffset: 0,
+            sinScale: 0.2,
+            cosOffset: 0,
+            cosScale: 0.2,
+            tanOffset: 0,
+            tanScale: 0.2,
+            offset: 0,
+            scale: 1.2,
+        }).setFilterStatus("distort", true);
+    }
+    /** Applies the karaoke options specified by the filter. */
+    setKaraoke(status, karaoke) {
+        return this.applyFilter({
+            property: "karaoke",
+            value: karaoke ?? null,
+        }).setFilterStatus("karaoke", status);
+    }
+    /** Applies the timescale options specified by the filter. */
+    setTimescale(timescale) {
+        return this.applyFilter({ property: "timescale", value: timescale ?? null });
+    }
+    /** Applies the vibrato options specified by the filter. */
+    setVibrato(vibrato) {
+        return this.applyFilter({ property: "vibrato", value: vibrato ?? null });
+    }
+    /** Applies the rotation options specified by the filter. */
+    setRotation(rotation) {
+        return this.applyFilter({ property: "rotation", value: rotation ?? null });
+    }
+    /** Applies the distortion options specified by the filter. */
+    setDistortion(distortion) {
+        return this.applyFilter({ property: "distortion", value: distortion ?? null });
+    }
+    /**
+     * Set the 8D audio effect.
+     * @param status Whether to enable or disable.
+     */
+    setEightD(status) {
+        if (status) {
+            return this.setRotation({ rotationHz: 0.2 }).setFilterStatus("eightD", status);
+        }
+        else {
+            return this.setRotation(null).setFilterStatus("eightD", status);
+        }
+    }
+    /**
+     * Set the nightcore effect.
+     * @param status Whether to enable or disable.
+     */
+    setNightcore(status) {
+        if (status) {
+            return this.setTimescale({
+                speed: 1.1,
+                pitch: 1.125,
+                rate: 1.05,
+            }).setFilterStatus("nightcore", status);
+        }
+        else {
+            return this.setTimescale(null).setFilterStatus("nightcore", status);
+        }
+    }
+    /**
+     * Set the slowmo effect.
+     * @param status Whether to enable or disable.
+     */
+    setSlowmo(status) {
+        if (status) {
+            return this.setTimescale({
+                speed: 0.7,
+                pitch: 1.0,
+                rate: 0.8,
+            }).setFilterStatus("slowmo", status);
+        }
+        else {
+            return this.setTimescale(null).setFilterStatus("slowmo", status);
+        }
+    }
+    /**
+     * Set the soft effect.
+     * @param status Whether to enable or disable.
+     */
+    setSoft(status) {
+        if (status) {
+            return this.setEqualizer(FiltersEqualizers_1.softEqualizer).setFilterStatus("soft", status);
+        }
+        else {
+            return this.setEqualizer([]).setFilterStatus("soft", status);
+        }
+    }
+    /**
+     * Set the treble bass effect.
+     * @param status Whether to enable or disable.
+     */
+    setTrebleBass(status) {
+        if (status) {
+            return this.setEqualizer(FiltersEqualizers_1.trebleBassEqualizer).setFilterStatus("trebleBass", status);
+        }
+        else {
+            return this.setEqualizer([]).setFilterStatus("trebleBass", status);
+        }
+    }
+    /**
+     * Set the TV effect.
+     * @param status Whether to enable or disable.
+     */
+    setTV(status) {
+        if (status) {
+            return this.setEqualizer(FiltersEqualizers_1.tvEqualizer).setFilterStatus("tv", status);
+        }
+        else {
+            return this.setEqualizer([]).setFilterStatus("tv", status);
+        }
+    }
+    /**
+     * Set the vaporwave effect.
+     * @param status Whether to enable or disable.
+     */
+    setVaporwave(status) {
+        if (status) {
+            return this.setEqualizer(FiltersEqualizers_1.vaporwaveEqualizer)
+                .setTimescale({ pitch: 0.55 })
+                .setFilterStatus("vaporwave", status);
+        }
+        else {
+            return this.setEqualizer([])
+                .setTimescale(null)
+                .setFilterStatus("vaporwave", status);
+        }
+    }
+    /**
+     * Set the bass boost effect.
+     * @param status Whether to enable or disable.
+     */
+    setBassBoost(status) {
+        if (status) {
+            return this.setEqualizer(FiltersEqualizers_1.bassBoostEqualizer).setFilterStatus("bassboost", status);
+        }
+        else {
+            return this.setEqualizer([]).setFilterStatus("bassboost", status);
+        }
+    }
+    /**
+     * Set the distort effect.
+     * @param status Whether to enable or disable.
+     */
+    setDistort(status) {
+        if (status) {
+            return this.setDistortion({
+                sinOffset: 0,
+                sinScale: 0.2,
+                cosOffset: 0,
+                cosScale: 0.2,
+                tanOffset: 0,
+                tanScale: 0.2,
+                offset: 0,
+                scale: 1.2,
+            }).setFilterStatus("distort", status);
+        }
+        else {
+            return this.setDistortion(null).setFilterStatus("distort", status);
+        }
+    }
+    /**
+     * Set a filter by name.
+     * @param filter The filter name.
+     * @param status Whether to enable or disable.
+     */
+    async setFilter(filter, status) {
+        if (typeof status !== "boolean")
+            throw new Error("Status must be a boolean");
+        switch (filter) {
+            case "bassboost":
+                this.setBassBoost(status);
+                break;
+            case "distort":
+                this.setDistort(status);
+                break;
+            case "eightD":
+                this.setEightD(status);
+                break;
+            case "nightcore":
+                this.setNightcore(status);
+                break;
+            case "slowmo":
+                this.setSlowmo(status);
+                break;
+            case "soft":
+                this.setSoft(status);
+                break;
+            case "trebleBass":
+                this.setTrebleBass(status);
+                break;
+            case "tv":
+                this.setTV(status);
+                break;
+            case "vaporwave":
+                this.setVaporwave(status);
+                break;
+            default: throw new Error(`Invalid filter: "${filter}"`);
+        }
+        await this.updateFilters();
+        return this;
+    }
+    /** Removes all audio effects and resets the filter status. */
+    async clearFilters() {
+        this.filterStatus = {
+            bassboost: false,
+            distort: false,
+            eightD: false,
+            karaoke: false,
+            nightcore: false,
+            slowmo: false,
+            soft: false,
+            trebleBass: false,
+            tv: false,
+            vaporwave: false,
+        };
+        this.player.filters = new Filters(this.player);
+        this.setEqualizer([]);
+        this.setDistortion(null);
+        this.setKaraoke(false);
+        this.setRotation(null);
+        this.setTimescale(null);
+        this.setVibrato(null);
+        await this.updateFilters();
+        return this;
+    }
+    /** Returns the status of the specified filter. */
+    getFilterStatus(filter) {
+        return this.filterStatus[filter];
+    }
+}
+exports.Filters = Filters;
+//# sourceMappingURL=Filters.js.map

package/dist/Structures/Filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Filters.js","sourceRoot":"","sources":["../../src/Structures/Filters.ts"],"names":[],"mappings":"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"}

package/dist/Structures/LRUCache.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * StellaLib — Copyright (c) 2026 AntonyZ, x2sadddDM, SynX, Astel (OSL-3.0)
+ * See LICENSE and THIRD-PARTY-NOTICES.md for full license details.
+ */
+/**
+ * A memory-efficient LRU (Least Recently Used) cache with TTL support.
+ * Evicts the oldest entries when maxSize is exceeded.
+ */
+export declare class LRUCache<K, V> {
+    private readonly cache;
+    private readonly maxSize;
+    private readonly ttl;
+    /**
+     * @param maxSize Maximum number of entries (default: 200).
+     * @param ttl Time-to-live in ms (0 = no expiry, default: 0).
+     */
+    constructor(maxSize?: number, ttl?: number);
+    /** Number of entries in the cache. */
+    get size(): number;
+    /** Get a value by key. Returns undefined if not found or expired. */
+    get(key: K): V | undefined;
+    /** Check if a key exists and is not expired. */
+    has(key: K): boolean;
+    /** Set a key-value pair. Evicts LRU entry if at capacity. */
+    set(key: K, value: V): void;
+    /** Delete a key. */
+    delete(key: K): boolean;
+    /** Clear all entries. */
+    clear(): void;
+    /** Prune all expired entries. Call periodically to free memory. */
+    prune(): number;
+    /** Get memory usage estimate in bytes (rough). */
+    get memoryEstimate(): number;
+}
+//# sourceMappingURL=LRUCache.d.ts.map

package/dist/Structures/LRUCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LRUCache.d.ts","sourceRoot":"","sources":["../../src/Structures/LRUCache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8C;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAE7B;;;OAGG;gBACS,OAAO,SAAM,EAAE,GAAG,SAAI;IAKlC,sCAAsC;IACtC,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,qEAAqE;IAC9D,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAgBjC,gDAAgD;IACzC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAI3B,6DAA6D;IACtD,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAiBlC,oBAAoB;IACb,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAI9B,yBAAyB;IAClB,KAAK,IAAI,IAAI;IAIpB,mEAAmE;IAC5D,KAAK,IAAI,MAAM;IAatB,kDAAkD;IAClD,IAAW,cAAc,IAAI,MAAM,CAGlC;CACD"}

package/dist/Structures/LRUCache.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * @license
+ * StellaLib — Copyright (c) 2026 AntonyZ, x2sadddDM, SynX, Astel (OSL-3.0)
+ * See LICENSE and THIRD-PARTY-NOTICES.md for full license details.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LRUCache = void 0;
+/**
+ * A memory-efficient LRU (Least Recently Used) cache with TTL support.
+ * Evicts the oldest entries when maxSize is exceeded.
+ */
+class LRUCache {
+    cache = new Map();
+    maxSize;
+    ttl;
+    /**
+     * @param maxSize Maximum number of entries (default: 200).
+     * @param ttl Time-to-live in ms (0 = no expiry, default: 0).
+     */
+    constructor(maxSize = 200, ttl = 0) {
+        this.maxSize = maxSize;
+        this.ttl = ttl;
+    }
+    /** Number of entries in the cache. */
+    get size() {
+        return this.cache.size;
+    }
+    /** Get a value by key. Returns undefined if not found or expired. */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return undefined;
+        // Check TTL expiry
+        if (this.ttl > 0 && Date.now() > entry.expiry) {
+            this.cache.delete(key);
+            return undefined;
+        }
+        // Move to end (most recently used) by re-inserting
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry.value;
+    }
+    /** Check if a key exists and is not expired. */
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    /** Set a key-value pair. Evicts LRU entry if at capacity. */
+    set(key, value) {
+        // Delete first to reset position if already exists
+        this.cache.delete(key);
+        // Evict oldest entries if at capacity
+        while (this.cache.size >= this.maxSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined)
+                this.cache.delete(firstKey);
+            else
+                break;
+        }
+        this.cache.set(key, {
+            value,
+            expiry: this.ttl > 0 ? Date.now() + this.ttl : 0,
+        });
+    }
+    /** Delete a key. */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /** Clear all entries. */
+    clear() {
+        this.cache.clear();
+    }
+    /** Prune all expired entries. Call periodically to free memory. */
+    prune() {
+        if (this.ttl <= 0)
+            return 0;
+        const now = Date.now();
+        let pruned = 0;
+        for (const [key, entry] of this.cache) {
+            if (now > entry.expiry) {
+                this.cache.delete(key);
+                pruned++;
+            }
+        }
+        return pruned;
+    }
+    /** Get memory usage estimate in bytes (rough). */
+    get memoryEstimate() {
+        // Rough estimate: 100 bytes overhead per Map entry + key/value sizes
+        return this.cache.size * 100;
+    }
+}
+exports.LRUCache = LRUCache;
+//# sourceMappingURL=LRUCache.js.map

package/dist/Structures/LRUCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LRUCache.js","sourceRoot":"","sources":["../../src/Structures/LRUCache.ts"],"names":[],"mappings":"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"}