eternal-timer 2.3.0 → 2.4.0

package/dist/esm/TimersStore/PlainTextTimersStore.js

@@ -0,0 +1,52 @@
+import { validate } from "uuid";
+import { TimersStore } from "./TimersStore.js";
+export class PlainTextTimersStore extends TimersStore {
+    constructor(timerfile) {
+        super(timerfile);
+    }
+    /**
+     * checkTimerfileSyntax
+     * @description Checks the syntax of the timer file.
+     * @param fileData
+     * @returns void
+     * @throws If syntax is invalid
+     */
+    async checkTimerfileSyntax(timers) {
+        const throwing = () => {
+            throw new Error(`Timer file's syntax is wrong`);
+        };
+        for (const timer of timers) {
+            if (Object.keys(timer).length !== 3)
+                throwing();
+            if (!validate(timer.id))
+                throwing();
+            if (isNaN(Number(timer.start)))
+                throwing();
+            if (isNaN(Number(timer.stop)))
+                throwing();
+            if (Number(timer.start) > Number(timer.stop))
+                throwing();
+        }
+        return;
+    }
+    toStringifyTimers(timers) {
+        if (timers.length === 0) {
+            return "";
+        }
+        return timers.map(timer => `${timer.id} ${timer.start} ${timer.stop}`).join("\n");
+    }
+    parseTimers(data) {
+        return data
+            .split(/\r?\n/)
+            .filter((line) => line.trim())
+            .map((line) => {
+            const [id, startStr, stopStr] = line.split(" ");
+            return {
+                id: id,
+                start: Number(startStr),
+                stop: Number(stopStr),
+            };
+        });
+    }
+}
+//# sourceMappingURL=PlainTextTimersStore.js.map

package/dist/esm/TimersStore/PlainTextTimersStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlainTextTimersStore.js","sourceRoot":"","sources":["../../../src/TimersStore/PlainTextTimersStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAGhC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,OAAO,oBAAqB,SAAQ,WAAwB;IAEjE,YACC,SAAiB;QAEjB,KAAK,CAAC,SAAS,CAAC,CAAC;IAClB,CAAC;IAED;;;;;;OAMM;IACa,KAAK,CAAC,oBAAoB,CAAC,MAA4B;QACzE,MAAM,QAAQ,GAAG,GAAG,EAAE;YACrB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACjD,CAAC,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5B,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;gBAAE,QAAQ,EAAE,CAAC;YAChD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,QAAQ,EAAE,CAAC;YACpC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAAE,QAAQ,EAAE,CAAC;YAC3C,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAAE,QAAQ,EAAE,CAAC;YAC1C,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,QAAQ,EAAE,CAAC;QAC1D,CAAC;QACD,OAAO;IACR,CAAC;IAEe,iBAAiB,CAAC,MAA4B;QAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACX,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnF,CAAC;IAEe,WAAW,CAAC,IAAY;QACvC,OAAO,IAAI;aACT,KAAK,CAAC,OAAO,CAAC;aACd,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC7B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAChD,OAAO;gBACN,EAAE,EAAE,EAAG;gBACP,KAAK,EAAE,MAAM,CAAC,QAAS,CAAC;gBACxB,IAAI,EAAE,MAAM,CAAC,OAAQ,CAAC;aACA,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC;CACD"}

package/dist/esm/TimersStore/TimersStore.d.ts

@@ -0,0 +1,12 @@
+import type { StorageType, Timer } from "../types.js";
+export declare abstract class TimersStore<T extends StorageType> {
+    protected readonly timerfile: string;
+    protected constructor(timerfile: string);
+    loadTimers(): Promise<Timer<T>[]>;
+    saveTimers(timers: Timer<T>[]): Promise<void>;
+    appendTimer(timer: Timer<T>): Promise<void>;
+    protected abstract checkTimerfileSyntax(timers: Timer<T>[]): Promise<void>;
+    abstract toStringifyTimers(timers: Timer<T>[]): string;
+    abstract parseTimers(data: string): Timer<T>[];
+}
+//# sourceMappingURL=TimersStore.d.ts.map

package/dist/esm/TimersStore/TimersStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimersStore.d.ts","sourceRoot":"","sources":["../../../src/TimersStore/TimersStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEtD,8BAAsB,WAAW,CAAC,CAAC,SAAS,WAAW;IACtD,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAErC,SAAS,aACR,SAAS,EAAE,MAAM;IAKL,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAWjC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASrD,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;aAC1D,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM;aAChD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;CACrD"}

package/dist/esm/TimersStore/TimersStore.js

@@ -0,0 +1,37 @@
+import fs from "fs";
+export class TimersStore {
+    timerfile;
+    constructor(timerfile) {
+        this.timerfile = timerfile;
+    }
+    async loadTimers() {
+        try {
+            const data = await fs.promises.readFile(this.timerfile, "utf-8");
+            const timersData = this.parseTimers(data);
+            await this.checkTimerfileSyntax(timersData);
+            return timersData;
+        }
+        catch (e) {
+            throw new Error("Error when loading timer data", { cause: e });
+        }
+    }
+    async saveTimers(timers) {
+        const data = this.toStringifyTimers(timers);
+        try {
+            await fs.promises.writeFile(this.timerfile, data, "utf-8");
+        }
+        catch (e) {
+            throw new Error(`Error when saving timer data`, { cause: e });
+        }
+    }
+    async appendTimer(timer) {
+        try {
+            await fs.promises.appendFile(this.timerfile, this.toStringifyTimers([timer]) + "\n");
+            return;
+        }
+        catch (e) {
+            throw new Error(`Error when appending timer data`, { cause: e });
+        }
+    }
+}
+//# sourceMappingURL=TimersStore.js.map

package/dist/esm/TimersStore/TimersStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimersStore.js","sourceRoot":"","sources":["../../../src/TimersStore/TimersStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAIpB,MAAM,OAAgB,WAAW;IACb,SAAS,CAAS;IAErC,YACC,SAAiB;QAEjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5B,CAAC;IAEM,KAAK,CAAC,UAAU;QACtB,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACjE,MAAM,UAAU,GAAe,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;YAC5C,OAAO,UAAU,CAAC;QACnB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;IACF,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,MAAkB;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAE5C,IAAI,CAAC;YACJ,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;IACF,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,KAAe;QACvC,IAAI,CAAC;YACJ,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YACrF,OAAO;QACR,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;IACF,CAAC;CAKD"}

package/dist/esm/index.d.ts

@@ -1,4 +1,4 @@
 export type { Timer, CreateTimerOptions, StorageType } from "./types.js";
-export { JSONLTimersManager } from "./JSONLTimersManager.js";
-export { PlainTextTimersManager } from "./PlainTextTimersManager.js";
+export { JSONLTimersManager } from "./TimersManager/JSONLTimersManager.js";
+export { PlainTextTimersManager } from "./TimersManager/PlainTextTimersManager.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/esm/index.js

@@ -1,3 +1,3 @@
-export { JSONLTimersManager } from "./JSONLTimersManager.js";
-export { PlainTextTimersManager } from "./PlainTextTimersManager.js";
+export { JSONLTimersManager } from "./TimersManager/JSONLTimersManager.js";
+export { PlainTextTimersManager } from "./TimersManager/PlainTextTimersManager.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/esm/types.d.ts

@@ -1,12 +1,15 @@
 export type StorageType = "JSONL" | "PlainText";
-export type Timer<T extends StorageType> = {
+export type Timer<T extends StorageType> = T extends "JSONL" ? {
     id: string;
     start: number;
     stop: number;
-} & (T extends "JSONL" ? {
     title?: string;
     description?: string;
-} : object);
+} : {
+    id: string;
+    start: number;
+    stop: number;
+};
 export type CreateTimerOptions<T extends StorageType> = T extends "JSONL" ? {
     length: number;
     title?: string;

package/dist/esm/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;AAEhD,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,WAAW,IAAI;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CAChB,GAAG,CAAC,CAAC,SAAS,OAAO,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,CAAC;AAE5E,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,OAAO,GACnE;IACI,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,GACV,CAAC,SAAS,WAAW,GACnB,MAAM,GACN,KAAK,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;AAEhD,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,WAAW,IACnC,CAAC,SAAS,OAAO,GACX;IACI,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,GACD;IACI,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEZ,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,OAAO,GACnE;IACI,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,GACV,CAAC,SAAS,WAAW,GACnB,MAAM,GACN,KAAK,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eternal-timer",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "timer for node.js package",
   "scripts": {
     "dev": "nodemon --watch src --exec ts-node src/index.ts",

package/dist/cjs/JSONLTimersManager.cjs

@@ -1,199 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.JSONLTimersManager = void 0;
-const fs_1 = __importDefault(require("fs"));
-const uuid_1 = require("uuid");
-const readline_1 = __importDefault(require("readline"));
-const TimersManager_js_1 = require("./TimersManager.cjs");
-const Log_js_1 = require("./Log.cjs");
-/**
- * JSONLTimersManager
- * @description
- * Manages timers stored in a  JSONL file.
- * (This is a abstract class)
- *
- * - Timers are persisted in a file
- * - Expired timers are detected by polling
- */
-class JSONLTimersManager extends TimersManager_js_1.TimersManager {
-    getDefaultFilename() {
-        return ".timers.jsonl";
-    }
-    async checkTimerfileSyntax(fileData) {
-        const throwing = () => {
-            throw new Error(`Timer file's syntax is wrong`);
-        };
-        const timersData = fileData
-            .split('\n')
-            .map(l => l.trim())
-            .filter(l => l !== "");
-        for (const timerData of timersData) {
-            const parsed = JSON.parse(timerData);
-            if (!parsed.id || typeof parsed.id !== "string" || parsed.id.length !== 36)
-                throwing();
-            if (!parsed.start || typeof parsed.start !== "number" || parsed.start.toString().trim() === "")
-                throwing();
-            if (!parsed.stop || typeof parsed.stop !== "number" || parsed.stop.toString().trim() === "")
-                throwing();
-            if (parsed.title && typeof parsed.title !== "string")
-                throwing();
-            if (parsed.description && typeof parsed.description !== "string")
-                throwing();
-        }
-        return;
-    }
-    /**
-     * createTimer
-     * @description Creates a new timer.
-     * @param length Timer duration in milliseconds
-     * @param title(string, optional) Title of the timer(only for JSONLTimersManager)
-     * @param description(string, optional) Description of the timer(only for JSONLTimersManager)
-     * @returns Promise that resolves to the timer ID (UUID)
-     * @throws If length is invalid(e.g. length < 0) or file operation fails
-     * @example
-     * const manager = new JSONLTimersManager();
-     * const newTimer = await manager.createTimer(5000);
-     * // newTimer will be id of the timer
-     */
-    async createTimer(options) {
-        try {
-            let length = typeof options === "object" ? options.length : options;
-            if (length < 0) {
-                throw new Error(`Invailed length: ${length}`);
-            }
-            const timersRaw = await fs_1.default.promises.readFile(this.timerfiledir, "utf-8");
-            await this.checkTimerfileSyntax(timersRaw);
-            length = Math.trunc(length);
-            // uuid, start, end
-            const id = (0, uuid_1.v4)();
-            const now = Date.now();
-            const newTimerData = JSON.stringify({
-                id,
-                start: now,
-                stop: (now + length),
-                ...(typeof options === "object" && options.title !== undefined && { title: options.title }),
-                ...(typeof options === "object" && options.description !== undefined && { description: options.description }),
-            });
-            await fs_1.default.promises.appendFile(this.timerfiledir, newTimerData + "\n");
-            return id;
-        }
-        catch (e) {
-            throw new Error(`Error when creating timer: ${e}`);
-        }
-    }
-    /**
-     * removeTimer
-     * @description Removes a timer by ID.
-     * @param id ID of the timer to remove
-     * @returns void
-     * @throws If file operation fails
-     * @example
-     * await manager.removeTimer(id);
-     */
-    async removeTimer(id) {
-        try {
-            const timersRaw = await fs_1.default.promises.readFile(this.timerfiledir, "utf-8");
-            await this.checkTimerfileSyntax(timersRaw);
-            const rl = readline_1.default.createInterface({
-                input: fs_1.default.createReadStream(this.timerfiledir),
-                crlfDelay: Infinity,
-            });
-            let newTimersData = "";
-            let found = false;
-            for await (const line of rl) {
-                if (!line.trim())
-                    continue;
-                const timerData = JSON.parse(line);
-                if (timerData.id === id) {
-                    found = true;
-                    continue;
-                }
-                newTimersData += `${JSON.stringify(timerData, null, 0)}\n`;
-            }
-            if (!found) {
-                throw new Error(`Timer with id ${id} not found`);
-            }
-            await fs_1.default.promises.writeFile(this.timerfiledir, newTimersData, "utf-8");
-            return;
-        }
-        catch (e) {
-            throw new Error(`Error when removing timer: ${e}`);
-        }
-    }
-    /**
-     * @description Starts monitoring expired timers asynchronously and returns immediately. The callback is invoked asynchronously when a timer expires.
-     * The callback is awaited before continuing.
-     * @param callback Function invoked when an expired timer is detected (called asynchronously)
-     * @param interval (number, optional): Check interval in milliseconds (default: 200ms)
-     * @throws If file operation fails
-     * @returns (NodeJS.Timeout) intervalId interval id of checkTimers
-     * @example
-     * const interval = manager.checkTimers((timer) => {
-     *     console.log(`A timer was stopped: ${timer.id}`);
-     * });
-     */
-    checkTimers(callback, interval = 200) {
-        return setInterval(async () => {
-            if (this.checkLock)
-                return;
-            this.checkLock = true;
-            try {
-                const rl = readline_1.default.createInterface({
-                    input: fs_1.default.createReadStream(this.timerfiledir),
-                    crlfDelay: Infinity,
-                });
-                for await (const line of rl) {
-                    if (!line.trim())
-                        continue;
-                    const timerData = JSON.parse(line);
-                    const now = Date.now();
-                    if (Number(timerData.stop) <= now) {
-                        await this.removeTimer(timerData.id);
-                        callback(timerData).catch(async (e) => {
-                            await Log_js_1.Log.ensureLogger();
-                            if (Log_js_1.Log.loggerInstance) {
-                                Log_js_1.Log.loggerInstance.error(`Error in callback of checkTimers: ${e}`);
-                            }
-                        });
-                    }
-                }
-            }
-            catch (e) {
-                await Log_js_1.Log.ensureLogger();
-                if (Log_js_1.Log.loggerInstance) {
-                    Log_js_1.Log.loggerInstance.error(`Error when checking alarm: ${e}`);
-                }
-            }
-            finally {
-                this.checkLock = false;
-            }
-        }, interval);
-    }
-    /**
-     * showTimers
-     * @description Retrieves all active timers.
-     * @returns Array of `Timer` objects
-     * @throws If file operation fails
-     * @example
-     * const timers = await manager.showTimers();
-     * console.log(JSON.stringify(timers))
-     */
-    async showTimers() {
-        try {
-            const timersRaw = await fs_1.default.promises.readFile(this.timerfiledir, "utf-8");
-            const timersData = timersRaw
-                .split(/\r?\n/)
-                .filter(t => t.trim())
-                .map(line => JSON.parse(line));
-            return timersData;
-        }
-        catch (e) {
-            throw new Error(`Error when showing timers: ${e}`);
-        }
-    }
-}
-exports.JSONLTimersManager = JSONLTimersManager;
-//# sourceMappingURL=JSONLTimersManager.js.map

package/dist/cjs/JSONLTimersManager.cjs.map

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

package/dist/cjs/JSONLTimersManager.d.ts

@@ -1,63 +0,0 @@
-import type { Timer, CreateTimerOptions } from "./types.js";
-import { TimersManager } from "./TimersManager.js";
-/**
- * JSONLTimersManager
- * @description
- * Manages timers stored in a  JSONL file.
- * (This is a abstract class)
- *
- * - Timers are persisted in a file
- * - Expired timers are detected by polling
- */
-export declare class JSONLTimersManager extends TimersManager<"JSONL"> {
-    protected getDefaultFilename(): string;
-    protected checkTimerfileSyntax(fileData: string): Promise<void>;
-    /**
-     * createTimer
-     * @description Creates a new timer.
-     * @param length Timer duration in milliseconds
-     * @param title(string, optional) Title of the timer(only for JSONLTimersManager)
-     * @param description(string, optional) Description of the timer(only for JSONLTimersManager)
-     * @returns Promise that resolves to the timer ID (UUID)
-     * @throws If length is invalid(e.g. length < 0) or file operation fails
-     * @example
-     * const manager = new JSONLTimersManager();
-     * const newTimer = await manager.createTimer(5000);
-     * // newTimer will be id of the timer
-     */
-    createTimer(options: CreateTimerOptions<"JSONL">): Promise<string>;
-    /**
-     * removeTimer
-     * @description Removes a timer by ID.
-     * @param id ID of the timer to remove
-     * @returns void
-     * @throws If file operation fails
-     * @example
-     * await manager.removeTimer(id);
-     */
-    removeTimer(id: string): Promise<void>;
-    /**
-     * @description Starts monitoring expired timers asynchronously and returns immediately. The callback is invoked asynchronously when a timer expires.
-     * The callback is awaited before continuing.
-     * @param callback Function invoked when an expired timer is detected (called asynchronously)
-     * @param interval (number, optional): Check interval in milliseconds (default: 200ms)
-     * @throws If file operation fails
-     * @returns (NodeJS.Timeout) intervalId interval id of checkTimers
-     * @example
-     * const interval = manager.checkTimers((timer) => {
-     *     console.log(`A timer was stopped: ${timer.id}`);
-     * });
-     */
-    checkTimers(callback: (timer: Timer<"JSONL">) => Promise<void>, interval?: number): NodeJS.Timeout;
-    /**
-     * showTimers
-     * @description Retrieves all active timers.
-     * @returns Array of `Timer` objects
-     * @throws If file operation fails
-     * @example
-     * const timers = await manager.showTimers();
-     * console.log(JSON.stringify(timers))
-     */
-    showTimers(): Promise<Timer<"JSONL">[]>;
-}
-//# sourceMappingURL=JSONLTimersManager.d.ts.map

package/dist/cjs/JSONLTimersManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"JSONLTimersManager.d.ts","sourceRoot":"","sources":["../../src/JSONLTimersManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,aAAa,CAAC,OAAO,CAAC;cAC1C,kBAAkB,IAAI,MAAM;cAI/B,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBrE;;;;;;;;;;;;OAYM;IACgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BxF;;;;;;;;OAQM;IACgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC5D;;;;;;;;;;;OAWM;IACU,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAE,MAAY,GAAG,MAAM,CAAC,OAAO;IAoCvH;;;;;;;;OAQM;IACgB,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;CAa7D"}

package/dist/cjs/PlainTextTimersManager.cjs

@@ -1,200 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PlainTextTimersManager = void 0;
-const fs_1 = __importDefault(require("fs"));
-const uuid_1 = require("uuid");
-const readline_1 = __importDefault(require("readline"));
-const TimersManager_js_1 = require("./TimersManager.cjs");
-const Log_js_1 = require("./Log.cjs");
-class PlainTextTimersManager extends TimersManager_js_1.TimersManager {
-    getDefaultFilename() {
-        return ".timers";
-    }
-    /**
-     * checkTimerfileSyntax
-     * @description Checks the syntax of the timer file.
-     * @param fileData
-     * @returns void
-     * @throws If syntax is invalid
-     */
-    async checkTimerfileSyntax(fileData) {
-        const throwing = () => {
-            throw new Error(`Timer file's syntax is wrong`);
-        };
-        const timersData = fileData
-            .split('\n')
-            .map(l => l.trim())
-            .filter(l => l !== "");
-        for (const timerData of timersData) {
-            const timerArray = timerData.split(/\s+/);
-            if (timerArray.length !== 3)
-                throwing();
-            if (timerArray[0]?.length !== 36)
-                throwing();
-            if (timerArray[1].trim() === "")
-                throwing();
-            if (timerArray[2].trim() === "")
-                throwing();
-        }
-        return;
-    }
-    /**
-     * createTimer
-     * @description Creates a new timer.
-     * @param length
-     * @returns Promise that resolves to the timer ID (UUID)
-     * @throws If length is invalid(e.g. length < 0) or file operation fails
-     * @example
-     * const manager = new PlainTextTimersManager();
-     * const newTimer = await manager.createTimer(5000);
-     * // newTimer will be id of the timer
-     */
-    async createTimer(options) {
-        try {
-            if (options < 0) {
-                throw new Error(`Invailed length: ${options}`);
-            }
-            const timersRaw = await fs_1.default.promises.readFile(this.timerfiledir, "utf-8");
-            await this.checkTimerfileSyntax(timersRaw);
-            const length = Math.trunc(options);
-            // uuid, start, end
-            const id = (0, uuid_1.v4)();
-            const now = Date.now();
-            const newTimerData = `${id} ${now.toString()} ${(now + length).toString()}`;
-            await fs_1.default.promises.appendFile(this.timerfiledir, newTimerData + "\n");
-            return id;
-        }
-        catch (e) {
-            throw new Error(`Error when creating timer: ${e}`);
-        }
-    }
-    /**
-     * removeTimer
-     * @description Removes a timer by ID.
-     * @param id ID of the timer to remove
-     * @returns void
-     * @throws If file operation fails
-     * @example
-     * await manager.removeTimer(id);
-     */
-    async removeTimer(id) {
-        try {
-            const timersRaw = await fs_1.default.promises.readFile(this.timerfiledir, "utf-8");
-            await this.checkTimerfileSyntax(timersRaw);
-            const rl = readline_1.default.createInterface({
-                input: fs_1.default.createReadStream(this.timerfiledir),
-                crlfDelay: Infinity,
-            });
-            const newTimersDataLines = [];
-            let found = false;
-            for await (const line of rl) {
-                if (!line.trim())
-                    continue;
-                const [timerId] = line.split(" ");
-                if (timerId === id) {
-                    found = true;
-                    continue;
-                }
-                newTimersDataLines.push(line);
-            }
-            if (!found) {
-                throw new Error(`Timer with id ${id} not found`);
-            }
-            await fs_1.default.promises.writeFile(this.timerfiledir, newTimersDataLines.join("\n"), "utf-8");
-            return;
-        }
-        catch (e) {
-            throw new Error(`Error when removing timer: ${e}`);
-        }
-    }
-    /**
-     * checkTimers
-     * @description Starts monitoring expired timers asynchronously and returns immediately. The callback is invoked asynchronously when a timer expires.
-     * The callback is awaited before continuing.
-     * @param callback Function invoked when an expired timer is detected (called asynchronously)
-     * @param interval (number, optional): Check interval in milliseconds (default: 200ms)
-     * @throws If file operation fails
-     * @returns (NodeJS.Timeout) intervalId interval id of checkTimers
-     * @example
-     * const interval = manager.checkTimers((timer) => {
-     *     console.log(`A timer was stopped: ${timer.id}`);
-     * });
-     */
-    checkTimers(callback, interval = 200) {
-        return setInterval(async () => {
-            if (this.checkLock)
-                return;
-            this.checkLock = true;
-            try {
-                const rl = readline_1.default.createInterface({
-                    input: fs_1.default.createReadStream(this.timerfiledir),
-                    crlfDelay: Infinity,
-                });
-                for await (const line of rl) {
-                    if (!line.trim())
-                        continue;
-                    const [id, startStr, stopStr] = line.split(" ");
-                    const timer = {
-                        id: id,
-                        start: Number(startStr),
-                        stop: Number(stopStr),
-                    };
-                    const now = Date.now();
-                    if (Number(timer.stop) <= now) {
-                        await this.removeTimer(timer.id);
-                        callback(timer).catch(async (e) => {
-                            await Log_js_1.Log.ensureLogger();
-                            if (Log_js_1.Log.loggerInstance) {
-                                Log_js_1.Log.loggerInstance.error(`Error in timer callback: ${e}`);
-                            }
-                        });
-                    }
-                }
-            }
-            catch (e) {
-                await Log_js_1.Log.ensureLogger();
-                if (Log_js_1.Log.loggerInstance) {
-                    Log_js_1.Log.loggerInstance.error(`Error when checking alarm: ${e}`);
-                }
-            }
-            finally {
-                this.checkLock = false;
-            }
-        }, interval);
-    }
-    /**
-     * showTimers
-     * @description Retrieves all active timers.
-     * @returns Array of `Timer` objects
-     * @throws If file operation fails
-     * @example
-     * const timers = await manager.showTimers();
-     * console.log(JSON.stringify(timers))
-     */
-    async showTimers() {
-        try {
-            const timersRaw = await fs_1.default.promises.readFile(this.timerfiledir, "utf-8");
-            const timersData = timersRaw.split(/\r?\n/);
-            const timersJSON = [];
-            for (const timerData of timersData) {
-                const splitedTimerData = timerData.split(" ");
-                if (!timerData.trim())
-                    continue;
-                timersJSON.push({
-                    id: splitedTimerData[0],
-                    start: Number(splitedTimerData[1]),
-                    stop: Number(splitedTimerData[2]),
-                });
-            }
-            return timersJSON;
-        }
-        catch (e) {
-            throw new Error(`Error when showing timers: ${e}`);
-        }
-    }
-}
-exports.PlainTextTimersManager = PlainTextTimersManager;
-//# sourceMappingURL=PlainTextTimersManager.js.map