@elara-services/packages 4.0.3 → 4.6.0

package/index.d.ts

@@ -184,4 +184,22 @@ declare module "@elara-services/packages" {
     }): string | string[]
 
     export async function fetch(url: string, key?: string, body?: any, postRequest?: boolean, returnRaw?: boolean): Promise<object|string|null>;
+
+
+    export class Duration extends null {
+        static get timeIds(): Set<string>;
+        static validate(value: string): boolean;
+        static parse(value: string): number | null;
+        static determineTimeType(str: string): number;
+    };
+
+    export class Tasks extends null {
+        static create(options: {
+            id: string;
+            time: string;
+            shouldCancel?: boolean
+        }, run: Function): void;
+        
+        static delete(id: string): void;
+    }
 }

package/index.js

@@ -6,4 +6,6 @@ exports.randomWeight = require("./packages/random/weight");
 exports.Languages = require("./packages/languages");
 exports.SlashBuilder = require("./packages/SlashBuilder");
 exports.Interactions = require("./packages/Interactions");
-exports.fetch = require("./packages/fetch");
+exports.fetch = require("./packages/fetch");
+exports.Duration = require("./packages/duration");
+exports.Tasks = require("./packages/Tasks");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elara-services/packages",
-  "version": "4.0.3",
+  "version": "4.6.0",
   "description": "",
   "main": "index.js",
   "types": "./index.d.ts",

package/packages/Tasks.js

@@ -0,0 +1,22 @@
+let nodeSchedule;
+
+try {
+    nodeSchedule = require("node-schedule");
+} catch { };
+
+module.exports = class Tasks extends null {
+    static create({ id = "", time = "", shouldCancel = true } = {}, run) {
+        if (!nodeSchedule) return `[Tasks:Create:ERROR]: I was unable to locate the 'node-schedule' package!`;
+        if (!id || !time || !run) return `[Tasks:Create:ERROR]: You didn't provide a valid ID, Time or Run function`;
+        if (nodeSchedule.scheduledJobs[id]) return `[Tasks:Create:ERROR]: Found (${id}) already in the scheduledJobs object.`;
+        return nodeSchedule.scheduleJob(id, time, () => {
+            run();
+            if (shouldCancel) return nodeSchedule.cancelJob(id);
+        });
+    };
+
+    static delete(id) {
+        if (!nodeSchedule) return null;
+        return nodeSchedule.cancelJob(id);
+    };
+};

package/packages/duration.js

@@ -0,0 +1,74 @@
+module.exports = class Duration extends null {
+    static parse(value) {
+        const MATCHES_ALL = value.match(/\d+\s*[A-Za-z]+/g);
+        if (MATCHES_ALL) {
+            let totalTime = 0;
+            for (const dur of MATCHES_ALL) {
+                const [ num, str ] = [
+                    parseInt(dur.match(/\d+/g)[0]),
+                    dur.match(/[A-Za-z]+/g)[0]
+                ];
+                if (isNaN(num)) totalTime = 0;
+                else totalTime += num * module.exports.determineTimeType(str);
+            }
+            if (totalTime) return totalTime;
+        }
+    
+        return null;
+    };
+
+    static determineTimeType(str) {
+        switch (str) {
+            case "ms": case "millisecond": case "milliseconds": return 1;
+            
+            case "s": case "second": case "seconds": return 1000;
+            
+            case "m": case "min": case "mins": case "minute": case "minutes": return 60 * 1000;
+            
+            case "h": case "hr": case "hour": case "hours": return 60 * 60 * 1000;
+            
+            case "d": case "day": case "days": return 24 * 60 * 60 * 1000;
+            
+            case "w": case "week": case "weeks": return 7 * 24 * 60 * 60 * 1000;
+            
+            case "mo": case "month": case "months": return 30 * 24 * 60 * 60 * 1000;
+            
+            case "y": case "year": case "years": return 365 * 24 * 60 * 60 * 1000;
+            
+            default: return 1;
+        }
+    };
+
+    static validate(value) {
+        const MATCHES_ALL = value.match(/\d+\s*[A-Za-z]+/g);
+        if (MATCHES_ALL) {
+            for (const match of MATCHES_ALL) {
+                let [ num, str ] = [
+                    match.match(/\d+/g),
+                    match.match(/[A-Za-z]+/g)
+                ]
+                if (!num || (num.length !== 1)) return false;
+                if (!str || (str.length !== 1)) return false;
+                if (!Number.isInteger(parseInt(num[0]))) return false;
+                if (!module.exports.timeIds.has(str[0])) return false;
+            }
+    
+            return true;
+        }
+    
+        return false;
+    }
+
+    static get timeIds() {
+        return new Set([
+            "ms", "millisecond", "milliseconds",
+            "s", "second", "seconds",
+            "m", "min", "mins", "minute", "minutes",
+            "h", "hr", "hrs", "hour", "hours",
+            "d", "day", "days",
+            "w", "week", "weeks",
+            "mo", "month", "months",
+            "y", "year", "years"
+        ])
+    }
+}