eternal-timer 2.2.0 → 2.3.0

package/README.md

@@ -33,20 +33,25 @@ async function main() {
     const manager = new JSONLTimersManager();
 
     // Create a timer (5 seconds) with a title and description
-    const timerId = await manager.createTimer(5000, 'My Timer', 'This is a test timer.');
+    const timerId = await manager.createTimer({length: 5000, title: 'My Timer', description: 'This is a test timer.'});
     console.log('Timer created:', timerId);
 
     // Monitor timers (executes when timer expires)
     const interval = manager.checkTimers(async (timer) => {
         console.log('Timer expired:', timer.id, timer.title);
+        // Once the timer expires, you can remove it
+        await manager.removeTimer(timer.id);
     });
 
     // Display all timers
     const timers = await manager.showTimers();
     console.log('Active timers:', timers);
 
-    // Remove a timer
-    await manager.removeTimer(timerId);
+    // To stop monitoring, for example after 10 seconds
+    setTimeout(() => {
+        clearInterval(interval);
+        console.log('Stopped monitoring timers.');
+    }, 10000);
 }
 
 main();
@@ -70,7 +75,18 @@ async function main() {
     // Monitor timers
     const interval = manager.checkTimers(async (timer) => {
         console.log('Timer expired:', timer.id);
+        await manager.removeTimer(timer.id);
     });
+
+    // Display all timers
+    const timers = await manager.showTimers();
+    console.log('Active timers:', timers);
+    
+    // Stop monitoring after a while
+    setTimeout(() => {
+        clearInterval(interval);
+        console.log('Stopped monitoring timers.');
+    }, 10000);
 }
 
 main();
@@ -78,79 +94,94 @@ main();
 
 ## API
 
-### `new JSONLTimersManager(timerfiledir?: string)`
+### `JSONLTimersManager`
 
-Creates a manager for timers stored in the **JSON Lines** format.
+#### `constructor(timerfiledir?: string)`
+Creates a manager for timers stored in **JSON Lines** format.
 
-**Parameters:**
-- `timerfiledir` (string, optional): The path to the timer file. If omitted, the default is `.timers.jsonl` in the project root.
+- **`timerfiledir`** (optional, string): Path to the timer file. Defaults to `.timers.jsonl` in the project root.
 
-### `new PlainTextTimersManager(timerfiledir?: string)`
+### `PlainTextTimersManager`
 
-Creates a manager for timers stored in the **plain-text** format.
+#### `constructor(timerfiledir?: string)`
+Creates a manager for timers stored in **plain-text** format.
 
-**Parameters:**
-- `timerfiledir` (string, optional): The path to the timer file. If omitted, the default is `.timers` in the project root.
+- **`timerfiledir`** (optional, string): Path to the timer file. Defaults to `.timers` in the project root.
 
 ---
 
-### `createTimer(length: number, title?: string, description?: string): Promise<string>`
+### `createTimer(options: CreateTimerOptions<T>): Promise<string>`
+
+Creates a new timer and saves it to the file.
+
+#### Parameters
+
+- **`options`**
 
-Creates a new timer.
+  When using `"PlainText"` storage:
+  - `number` — Timer duration in milliseconds.
 
-**Parameters:**
-- `length` (number): Timer duration in milliseconds
-- `title` (string, optional): A title for the timer. **Only available for `JSONLTimersManager`**.
-- `description` (string, optional): A description for the timer. **Only available for `JSONLTimersManager`**.
+  When using `"JSONL"` storage:
+  - `{ length: number; title?: string; description?: string }`
+    - `length` (number): Timer duration in milliseconds.
+    - `title` (optional, string): A title for the timer.
+    - `description` (optional, string): A description for the timer.
 
-**Returns:** Promise that resolves to the timer ID (UUID)
+  - `number` — Timer duration in milliseconds.  
+    ⚠ Not recommended. See [Storage Formats](#storage-formats).
 
-**Throws:** If length is invalid(e.g. length < 0) or file operation fails
+**Returns** A `Promise<string>` that resolves to the timer's unique ID (UUID).
+
+**Throws** An error if: `length` is invalid (e.g., negative) or a file operation fails
 
 ### `removeTimer(id: string): Promise<void>`
 
-Removes a timer by ID.
+Removes a timer by its ID.
 
-**Parameters:**
-- `id` (string): ID of the timer to remove
+- **`id`**: The ID of the timer to remove.
 
-**Returns:** void
+**Returns:** A `Promise` that resolves when the timer is removed.
 
-**Throws:** If the timer with the specified ID is not found or if a file operation fails.
+**Throws:** An error if the timer with the specified ID is not found or if a file operation fails.
 
-### `checkTimers(callback: (timer: Timer) => Promise<void>, interval?: number): Promise<NodeJS.Timeout>`
+### `checkTimers(callback: (timer: Timer) => Promise<void>, interval?: number): NodeJS.Timeout`
 
-Starts monitoring expired timers and returns immediately.
+Starts monitoring for expired timers at a specified interval. This function runs asynchronously and will not block execution.
 
-The callback is invoked when a timer expires during periodic checks.
-The callback is awaited before the next timer check continues.
+When an expired timer is found, the provided `callback` function is invoked with the `timer` object. The function waits for the `callback`'s `Promise` to resolve before proceeding to the next check, preventing race conditions. Error handling has been added within the `callback` to prevent the application from crashing if an error occurs during timer processing.
 
-**Parameters:**
-- `callback`: Function invoked when an expired timer is detected (called during periodic checks and awaited)
-- `interval` (number, optional): Check interval in milliseconds (default: 50ms)
+- **`callback`**: An async function that is called with the expired `timer` object.
+- **`interval`** (optional, number): The interval in milliseconds to check for expired timers. Defaults to `200ms`.
 
-**Returns:** interval id of checkTimers
+**Returns:** A `NodeJS.Timeout` object that can be used with `clearInterval()` to stop monitoring.
 
-**Throws:** If file operation fails
+**Throws:** An error if a file operation fails during monitoring.
 
 ### `showTimers(): Promise<Timer[]>`
 
 Retrieves all active timers.
 
-**Returns:** Array of `Timer` objects
+**Returns:** A `Promise` that resolves to an array of `Timer` objects.
 
-**Throws:** If file operation fails
+**Throws:** An error if a file operation fails.
 
 ## Type Definition
 
+The `StorageType` has the following structure:
 ```typescript
-type Timer = {
-    id: string;      // Unique timer identifier (UUID)
-    start: number;   // Timer start timestamp
-    stop: number;    // Timer end timestamp
-    title?: string;
-    description?: string;
-}
+type StorageType = "JSONL" | "PlainText"
+```
+
+The `Timer` object has the following structure:
+
+```typescript
+type Timer<T extends StorageType> = {
+  id: string;
+  start: number;
+  stop: number;
+} & (T extends "JSONL"
+  ? { title?: string; description?: string }
+  : object);
 ```
 
 ## Scripts
@@ -168,7 +199,7 @@ You can choose between two storage formats by selecting the appropriate manager
 ### 1. JSON Lines (via `JSONLTimersManager`)
 This is the recommended format for storing rich metadata.
 
-- **Pros**: Allows for storing `title` and `description`.
+- **Pros**: Allows for storing `title` and `description`. Improved memory efficiency due to line-by-line file reading.
 - **Cons**: Involves JSON parsing, which may have a minor performance overhead.
 - **Default File**: `.timers.jsonl`
 - **Format**:
@@ -179,7 +210,7 @@ This is the recommended format for storing rich metadata.
 ### 2. Plain Text (via `PlainTextTimersManager`)
 This format is more lightweight and slightly faster.
 
-- **Pros**: Simple and efficient.
+- **Pros**: Simple and efficient. Improved memory efficiency due to line-by-line file reading.
 - **Cons**: Cannot store additional data like `title` or `description`.
 - **Default File**: `.timers`
 - **Format**:

package/dist/cjs/JSONLTimersManager.cjs

@@ -6,6 +6,7 @@ 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");
 /**
@@ -57,8 +58,9 @@ class JSONLTimersManager extends TimersManager_js_1.TimersManager {
      * const newTimer = await manager.createTimer(5000);
      * // newTimer will be id of the timer
      */
-    async createTimer(length, title, description) {
+    async createTimer(options) {
         try {
+            let length = typeof options === "object" ? options.length : options;
             if (length < 0) {
                 throw new Error(`Invailed length: ${length}`);
             }
@@ -72,8 +74,8 @@ class JSONLTimersManager extends TimersManager_js_1.TimersManager {
                 id,
                 start: now,
                 stop: (now + length),
-                ...(title !== undefined && { title }),
-                ...(description !== undefined && { description }),
+                ...(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;
@@ -95,15 +97,16 @@ class JSONLTimersManager extends TimersManager_js_1.TimersManager {
         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 = "";
-            const timersData = timersRaw
-                .split(/\r?\n/)
-                .filter(t => t.trim())
-                .map(line => JSON.parse(line));
             let found = false;
-            for (const timerData of timersData) {
-                if (!timerData)
+            for await (const line of rl) {
+                if (!line.trim())
                     continue;
+                const timerData = JSON.parse(line);
                 if (timerData.id === id) {
                     found = true;
                     continue;
@@ -124,7 +127,7 @@ class JSONLTimersManager extends TimersManager_js_1.TimersManager {
      * @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: 50ms)
+     * @param interval (number, optional): Check interval in milliseconds (default: 200ms)
      * @throws If file operation fails
      * @returns (NodeJS.Timeout) intervalId interval id of checkTimers
      * @example
@@ -132,26 +135,29 @@ class JSONLTimersManager extends TimersManager_js_1.TimersManager {
      *     console.log(`A timer was stopped: ${timer.id}`);
      * });
      */
-    checkTimers(callback, interval = 50) {
+    checkTimers(callback, interval = 200) {
         return setInterval(async () => {
             if (this.checkLock)
                 return;
             this.checkLock = true;
             try {
-                const timersDataRaw = await fs_1.default.promises.readFile(this.timerfiledir, "utf-8");
-                const timersMap = new Map();
-                const timersData = timersDataRaw
-                    .split(/\r?\n/)
-                    .filter(line => line.trim())
-                    .map(line => JSON.parse(line));
-                for (const timer of timersData) {
-                    timersMap.set(timer.id, timer);
-                }
-                const now = Date.now();
-                for (const timer of timersMap.values()) {
-                    if (Number(timer.stop) <= now) {
-                        await this.removeTimer(timer.id);
-                        await callback(timer);
+                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}`);
+                            }
+                        });
                     }
                 }
             }

package/dist/cjs/JSONLTimersManager.cjs.map

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

package/dist/cjs/JSONLTimersManager.d.ts

@@ -1,5 +1,5 @@
-import type { Timer } from "./types.cjs";
-import { TimersManager } from "./TimersManager.cjs";
+import type { Timer, CreateTimerOptions } from "./types.js";
+import { TimersManager } from "./TimersManager.js";
 /**
  * JSONLTimersManager
  * @description
@@ -9,7 +9,7 @@ import { TimersManager } from "./TimersManager.cjs";
  * - Timers are persisted in a file
  * - Expired timers are detected by polling
  */
-export declare class JSONLTimersManager extends TimersManager {
+export declare class JSONLTimersManager extends TimersManager<"JSONL"> {
     protected getDefaultFilename(): string;
     protected checkTimerfileSyntax(fileData: string): Promise<void>;
     /**
@@ -25,7 +25,7 @@ export declare class JSONLTimersManager extends TimersManager {
      * const newTimer = await manager.createTimer(5000);
      * // newTimer will be id of the timer
      */
-    createTimer(length: number, title?: string, description?: string): Promise<string>;
+    createTimer(options: CreateTimerOptions<"JSONL">): Promise<string>;
     /**
      * removeTimer
      * @description Removes a timer by ID.
@@ -40,7 +40,7 @@ export declare class JSONLTimersManager extends TimersManager {
      * @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: 50ms)
+     * @param interval (number, optional): Check interval in milliseconds (default: 200ms)
      * @throws If file operation fails
      * @returns (NodeJS.Timeout) intervalId interval id of checkTimers
      * @example
@@ -48,7 +48,7 @@ export declare class JSONLTimersManager extends TimersManager {
      *     console.log(`A timer was stopped: ${timer.id}`);
      * });
      */
-    checkTimers(callback: (timer: Timer) => Promise<void>, interval?: number): NodeJS.Timeout;
+    checkTimers(callback: (timer: Timer<"JSONL">) => Promise<void>, interval?: number): NodeJS.Timeout;
     /**
      * showTimers
      * @description Retrieves all active timers.
@@ -58,6 +58,6 @@ export declare class JSONLTimersManager extends TimersManager {
      * const timers = await manager.showTimers();
      * console.log(JSON.stringify(timers))
      */
-    showTimers(): Promise<Timer[]>;
+    showTimers(): Promise<Timer<"JSONL">[]>;
 }
 //# sourceMappingURL=JSONLTimersManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"JSONLTimersManager.d.ts","sourceRoot":"","sources":["../../src/JSONLTimersManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IACpD,SAAS,CAAC,kBAAkB,IAAI,MAAM;cAItB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBrE;;;;;;;;;;;;OAYM;IACO,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA4B/F;;;;;;;;OAQM;IACO,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BnD;;;;;;;;;;;OAWM;IACC,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,CAAC,OAAO;IAoCpG;;;;;;;;OAQM;IACO,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;CAa3C"}
+{"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/Log.cjs

@@ -58,25 +58,4 @@ class Log {
     }
 }
 exports.Log = Log;
-/*
-let logger: Logger | null = null;
-let initPromise: Promise<void> | null = null;
-
-export async function ensureLogger() {
-    if (logger) return;
-    if (!initPromise) {
-        initPromise = (async () => {
-            try {
-                const logtape = await import("@logtape/logtape");
-                logger = logtape.getLogger(["eternal-timer"]);
-            } catch {
-                console.info(
-                    "Tip: Install the optional package '@logtape/logtape' to customize logging behavior.",
-                );
-            }
-        })();
-    }
-    await initPromise;
-}
-*/ 
 //# sourceMappingURL=Log.js.map

package/dist/cjs/{Log.js.map → Log.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"Log.js","sourceRoot":"","sources":["../../src/Log.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,MAAa,GAAG;IACP,MAAM,CAAC,MAAM,GAAkB,IAAI,CAAC;IACpC,MAAM,CAAC,WAAW,GAAyB,IAAI,CAAC;IAEjD,MAAM,CAAC,KAAK,CAAC,YAAY;QAC/B,IAAI,GAAG,CAAC,MAAM;YAAE,OAAO;QACvB,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACtB,GAAG,CAAC,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC7B,IAAI,CAAC;oBACJ,MAAM,OAAO,GAAG,wDAAa,kBAAkB,GAAC,CAAC;oBACjD,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;gBACnD,CAAC;gBAAC,MAAM,CAAC;oBACR,OAAO,CAAC,IAAI,CACX,qFAAqF,CACrF,CAAC;gBACH,CAAC;YACF,CAAC,CAAC,EAAE,CAAC;QACN,CAAC;QACD,MAAM,GAAG,CAAC,WAAW,CAAC;IACvB,CAAC;IAEM,MAAM,KAAK,cAAc;QAC/B,OAAO,GAAG,CAAC,MAAM,CAAC;IACnB,CAAC;;AAvBF,kBAwBC;AAED;;;;;;;;;;;;;;;;;;;;EAoBE"}
+{"version":3,"file":"Log.js","sourceRoot":"","sources":["../../src/Log.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,MAAa,GAAG;IACP,MAAM,CAAC,MAAM,GAAkB,IAAI,CAAC;IACpC,MAAM,CAAC,WAAW,GAAyB,IAAI,CAAC;IAEjD,MAAM,CAAC,KAAK,CAAC,YAAY;QAC/B,IAAI,GAAG,CAAC,MAAM;YAAE,OAAO;QACvB,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACtB,GAAG,CAAC,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC7B,IAAI,CAAC;oBACJ,MAAM,OAAO,GAAG,wDAAa,kBAAkB,GAAC,CAAC;oBACjD,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;gBACnD,CAAC;gBAAC,MAAM,CAAC;oBACR,OAAO,CAAC,IAAI,CACX,qFAAqF,CACrF,CAAC;gBACH,CAAC;YACF,CAAC,CAAC,EAAE,CAAC;QACN,CAAC;QACD,MAAM,GAAG,CAAC,WAAW,CAAC;IACvB,CAAC;IAEM,MAAM,KAAK,cAAc;QAC/B,OAAO,GAAG,CAAC,MAAM,CAAC;IACnB,CAAC;;AAvBF,kBAwBC"}

package/dist/cjs/PlainTextTimersManager.cjs

@@ -6,6 +6,7 @@ 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 {
@@ -51,14 +52,14 @@ class PlainTextTimersManager extends TimersManager_js_1.TimersManager {
      * const newTimer = await manager.createTimer(5000);
      * // newTimer will be id of the timer
      */
-    async createTimer(length) {
+    async createTimer(options) {
         try {
-            if (length < 0) {
-                throw new Error(`Invailed length: ${length}`);
+            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);
-            length = Math.trunc(length);
+            const length = Math.trunc(options);
             // uuid, start, end
             const id = (0, uuid_1.v4)();
             const now = Date.now();
@@ -83,23 +84,26 @@ class PlainTextTimersManager extends TimersManager_js_1.TimersManager {
         try {
             const timersRaw = await fs_1.default.promises.readFile(this.timerfiledir, "utf-8");
             await this.checkTimerfileSyntax(timersRaw);
-            const newTimersData = [];
-            const timersData = timersRaw.split(/\r?\n/);
+            const rl = readline_1.default.createInterface({
+                input: fs_1.default.createReadStream(this.timerfiledir),
+                crlfDelay: Infinity,
+            });
+            const newTimersDataLines = [];
             let found = false;
-            for (const timerData of timersData) {
-                if (!timerData.trim())
+            for await (const line of rl) {
+                if (!line.trim())
                     continue;
-                const [timerId] = timerData.split(" ");
+                const [timerId] = line.split(" ");
                 if (timerId === id) {
                     found = true;
                     continue;
                 }
-                newTimersData.push(timerData);
+                newTimersDataLines.push(line);
             }
             if (!found) {
                 throw new Error(`Timer with id ${id} not found`);
             }
-            await fs_1.default.promises.writeFile(this.timerfiledir, newTimersData.join("\n"), "utf-8");
+            await fs_1.default.promises.writeFile(this.timerfiledir, newTimersDataLines.join("\n"), "utf-8");
             return;
         }
         catch (e) {
@@ -111,7 +115,7 @@ class PlainTextTimersManager extends TimersManager_js_1.TimersManager {
      * @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: 50ms)
+     * @param interval (number, optional): Check interval in milliseconds (default: 200ms)
      * @throws If file operation fails
      * @returns (NodeJS.Timeout) intervalId interval id of checkTimers
      * @example
@@ -119,30 +123,34 @@ class PlainTextTimersManager extends TimersManager_js_1.TimersManager {
      *     console.log(`A timer was stopped: ${timer.id}`);
      * });
      */
-    checkTimers(callback, interval = 50) {
+    checkTimers(callback, interval = 200) {
         return setInterval(async () => {
             if (this.checkLock)
                 return;
             this.checkLock = true;
             try {
-                const timersDataRaw = await fs_1.default.promises.readFile(this.timerfiledir, "utf-8");
-                const timersMap = new Map();
-                const timersData = timersDataRaw.split(/\r?\n/);
-                for (const timerData of timersData) {
-                    if (!timerData.trim())
+                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] = timerData.split(" ");
-                    timersMap.set(id, {
+                    const [id, startStr, stopStr] = line.split(" ");
+                    const timer = {
                         id: id,
                         start: Number(startStr),
                         stop: Number(stopStr),
-                    });
-                }
-                const now = Date.now();
-                for (const timer of timersMap.values()) {
+                    };
+                    const now = Date.now();
                     if (Number(timer.stop) <= now) {
                         await this.removeTimer(timer.id);
-                        await callback(timer);
+                        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}`);
+                            }
+                        });
                     }
                 }
             }

package/dist/cjs/PlainTextTimersManager.cjs.map

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

package/dist/cjs/PlainTextTimersManager.d.ts

@@ -1,6 +1,6 @@
-import type { Timer } from "./types.cjs";
-import { TimersManager } from "./TimersManager.cjs";
-export declare class PlainTextTimersManager extends TimersManager {
+import type { Timer, CreateTimerOptions } from "./types.js";
+import { TimersManager } from "./TimersManager.js";
+export declare class PlainTextTimersManager extends TimersManager<"PlainText"> {
     protected getDefaultFilename(): string;
     /**
      * checkTimerfileSyntax
@@ -21,7 +21,7 @@ export declare class PlainTextTimersManager extends TimersManager {
      * const newTimer = await manager.createTimer(5000);
      * // newTimer will be id of the timer
      */
-    createTimer(length: number): Promise<string>;
+    createTimer(options: CreateTimerOptions<"PlainText">): Promise<string>;
     /**
      * removeTimer
      * @description Removes a timer by ID.
@@ -37,7 +37,7 @@ export declare class PlainTextTimersManager extends TimersManager {
      * @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: 50ms)
+     * @param interval (number, optional): Check interval in milliseconds (default: 200ms)
      * @throws If file operation fails
      * @returns (NodeJS.Timeout) intervalId interval id of checkTimers
      * @example
@@ -45,7 +45,7 @@ export declare class PlainTextTimersManager extends TimersManager {
      *     console.log(`A timer was stopped: ${timer.id}`);
      * });
      */
-    checkTimers(callback: (timer: Timer) => Promise<void>, interval?: number): NodeJS.Timeout;
+    checkTimers(callback: (timer: Timer<"PlainText">) => Promise<void>, interval?: number): NodeJS.Timeout;
     /**
      * showTimers
      * @description Retrieves all active timers.
@@ -55,6 +55,6 @@ export declare class PlainTextTimersManager extends TimersManager {
      * const timers = await manager.showTimers();
      * console.log(JSON.stringify(timers))
      */
-    showTimers(): Promise<Timer[]>;
+    showTimers(): Promise<Timer<"PlainText">[]>;
 }
 //# sourceMappingURL=PlainTextTimersManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PlainTextTimersManager.d.ts","sourceRoot":"","sources":["../../src/PlainTextTimersManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,qBAAa,sBAAuB,SAAQ,aAAa;IACxD,SAAS,CAAC,kBAAkB,IAAI,MAAM;IAItC;;;;;;OAMG;cACa,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrE;;;;;;;;;;OAUG;IACU,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBzD;;;;;;;;OAQG;IACU,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BnD;;;;;;;;;;;;OAYG;IACI,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,CAAC,OAAO;IAuCpG;;;;;;;;OAQG;IACU,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;CAoB3C"}
+{"version":3,"file":"PlainTextTimersManager.d.ts","sourceRoot":"","sources":["../../src/PlainTextTimersManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,qBAAa,sBAAuB,SAAQ,aAAa,CAAC,WAAW,CAAC;IACrE,SAAS,CAAC,kBAAkB,IAAI,MAAM;IAItC;;;;;;OAMG;cACsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9E;;;;;;;;;;OAUG;IACmB,WAAW,CAAC,OAAO,EAAE,kBAAkB,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAsB5F;;;;;;;;OAQG;IACmB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B5D;;;;;;;;;;;;OAYG;IACa,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAE,MAAY,GAAG,MAAM,CAAC,OAAO;IAyC3H;;;;;;;;OAQG;IACmB,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;CAoBjE"}

package/dist/cjs/TimersManager.d.ts

@@ -1,4 +1,4 @@
-import type { Timer } from "./types.cjs";
+import type { CreateTimerOptions, StorageType, Timer } from "./types.js";
 /**
  * TimersManager
  * @description
@@ -8,7 +8,7 @@ import type { Timer } from "./types.cjs";
  * - Timers are persisted in a file
  * - Expired timers are detected by polling
  */
-export declare abstract class TimersManager {
+export declare abstract class TimersManager<T extends StorageType> {
     protected readonly timerfiledir: string;
     protected checkLock: boolean;
     protected abstract getDefaultFilename(): string;
@@ -37,7 +37,7 @@ export declare abstract class TimersManager {
      * const newTimer = await manager.createTimer(5000);
      * // newTimer will be id of the timer
      */
-    abstract createTimer(length: number, title?: string, description?: string): Promise<string>;
+    abstract createTimer(options: CreateTimerOptions<T>): Promise<string>;
     /**
      * removeTimer
      * @description Removes a timer by ID.
@@ -52,7 +52,7 @@ export declare abstract class TimersManager {
      * @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: 50ms)
+     * @param interval (number, optional): Check interval in milliseconds (default: 200ms)
      * @throws If file operation fails
      * @returns (NodeJS.Timeout) intervalId interval id of checkTimers
      * @example
@@ -60,7 +60,7 @@ export declare abstract class TimersManager {
      *     console.log(`A timer was stopped: ${timer.id}`);
      * });
      */
-    abstract checkTimers(callback: (timer: Timer) => Promise<void>, interval?: number): NodeJS.Timeout;
+    abstract checkTimers(callback: (timer: Timer<T>) => Promise<void>, interval?: number): NodeJS.Timeout;
     /**
      * showTimers
      * @description Retrieves all active timers.
@@ -70,6 +70,6 @@ export declare abstract class TimersManager {
      * const timers = await manager.showTimers();
      * console.log(JSON.stringify(timers))
      */
-    abstract showTimers(): Promise<Timer[]>;
+    abstract showTimers(): Promise<Timer<T>[]>;
 }
 //# sourceMappingURL=TimersManager.d.ts.map