eternal-timer 2.0.4 → 2.2.0

package/README.md

@@ -1,6 +1,6 @@
 # eternal-timer
 
-![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/SUKEsann2000/eternal-timer/publish.yml)
+![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/SUKEsann2000/eternal-timer/run_test.yml)
 ![NPM Downloads](https://img.shields.io/npm/dm/eternal-timer)
 
 A simple and persistent timer library for Node.js. Timers are saved to a file and maintain their state even after process restart.
@@ -9,6 +9,7 @@ A simple and persistent timer library for Node.js. Timers are saved to a file an
 
 - **Monitor Timers (asynchronous)**: Start monitoring expired timers asynchronously; the function returns immediately and the callback is called when timers expire.
 - **Persistence**: Save timer data to a file that persists across process restarts
+- **Choice of Format**: Choose between JSON Lines for rich data or plain text for lightweight storage.
 
 ## Installation
 
@@ -18,21 +19,26 @@ npm install eternal-timer
 
 ## Usage
 
-### Basic Example
+You can choose between two manager classes depending on the desired storage format.
+
+### `JSONLTimersManager` (JSON Lines)
+
+Use this manager to store timers in a `.jsonl` file, which allows for storing `title` and `description`.
 
 ```javascript
-import { TimersManager } from 'eternal-timer';
+import { JSONLTimersManager } from 'eternal-timer';
 
 async function main() {
-    const manager = new TimersManager();
+    // By default, timers are stored in '.timers.jsonl' in the project root.
+    const manager = new JSONLTimersManager();
 
-    // Create a timer (5 seconds)
-    const timerId = await manager.createTimer(5000);
+    // Create a timer (5 seconds) with a title and description
+    const timerId = await manager.createTimer(5000, 'My Timer', 'This is a test timer.');
     console.log('Timer created:', timerId);
 
     // Monitor timers (executes when timer expires)
-    const intervalId = manager.checkTimers(async (timer) => {
-        console.log('Timer expired:', timer.id);
+    const interval = manager.checkTimers(async (timer) => {
+        console.log('Timer expired:', timer.id, timer.title);
     });
 
     // Display all timers
@@ -46,21 +52,56 @@ async function main() {
 main();
 ```
 
+### `PlainTextTimersManager` (Plain Text)
+
+Use this manager for a more lightweight plain-text format.
+
+```javascript
+import { PlainTextTimersManager } from 'eternal-timer';
+
+async function main() {
+    // By default, timers are stored in '.timers' in the project root.
+    const manager = new PlainTextTimersManager();
+
+    // Create a timer (5 seconds)
+    const timerId = await manager.createTimer(5000);
+    console.log('Timer created:', timerId);
+
+    // Monitor timers
+    const interval = manager.checkTimers(async (timer) => {
+        console.log('Timer expired:', timer.id);
+    });
+}
+
+main();
+```
+
 ## API
 
-### `new TimersManager(timerfiledir?: string)`
+### `new JSONLTimersManager(timerfiledir?: string)`
+
+Creates a manager for timers stored in the **JSON Lines** format.
+
+**Parameters:**
+- `timerfiledir` (string, optional): The path to the timer file. If omitted, the default is `.timers.jsonl` in the project root.
+
+### `new PlainTextTimersManager(timerfiledir?: string)`
 
-Creates a new `TimersManager` instance.
+Creates a manager for timers stored in the **plain-text** format.
 
 **Parameters:**
-- `timerfiledir` (string, optional): The path to the directory where the timer file is stored. If omitted, `.timers` under the project root is used.
+- `timerfiledir` (string, optional): The path to the timer file. If omitted, the default is `.timers` in the project root.
 
-### `createTimer(length: number): Promise<string>`
+---
+
+### `createTimer(length: number, title?: string, description?: string): Promise<string>`
 
 Creates a new timer.
 
 **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`**.
 
 **Returns:** Promise that resolves to the timer ID (UUID)
 
@@ -107,6 +148,8 @@ type Timer = {
     id: string;      // Unique timer identifier (UUID)
     start: number;   // Timer start timestamp
     stop: number;    // Timer end timestamp
+    title?: string;
+    description?: string;
 }
 ```
 
@@ -118,13 +161,31 @@ type Timer = {
 - `npm run test`: Test the compiled code
 - `npm run lint`: Lint all codes
 
-## Storage
+## Storage Formats
 
-Timer data is stored in the `.timers` file in the project root. Each line follows this format:
+You can choose between two storage formats by selecting the appropriate manager class.
 
-```
-{id} {start_timestamp} {stop_timestamp}
-```
+### 1. JSON Lines (via `JSONLTimersManager`)
+This is the recommended format for storing rich metadata.
+
+- **Pros**: Allows for storing `title` and `description`.
+- **Cons**: Involves JSON parsing, which may have a minor performance overhead.
+- **Default File**: `.timers.jsonl`
+- **Format**:
+  ```json
+  {"id":"...","start":1678886400000,"stop":1678886405000,"title":"My Timer","description":"..."}
+  ```
+
+### 2. Plain Text (via `PlainTextTimersManager`)
+This format is more lightweight and slightly faster.
+
+- **Pros**: Simple and efficient.
+- **Cons**: Cannot store additional data like `title` or `description`.
+- **Default File**: `.timers`
+- **Format**:
+  ```
+  {id} {start_timestamp} {stop_timestamp}
+  ```
 
 ## License
 
@@ -135,5 +196,3 @@ Licensed under the Apache License, Version 2.0. See the `LICENSE` file for detai
 ## Repository
 
 https://github.com/SUKEsann2000/eternal-timer
-
-

package/dist/cjs/JSONLTimersManager.cjs

@@ -0,0 +1,193 @@
+"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 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(length, title, description) {
+        try {
+            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),
+                ...(title !== undefined && { title }),
+                ...(description !== undefined && { 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);
+            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)
+                    continue;
+                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: 50ms)
+     * @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 = 50) {
+        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);
+                    }
+                }
+            }
+            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.d.ts

@@ -0,0 +1,63 @@
+import type { Timer } from "./types.cjs";
+import { TimersManager } from "./TimersManager.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
+ */
+export declare class JSONLTimersManager extends TimersManager {
+    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(length: number, title?: string, description?: string): 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: 50ms)
+     * @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) => 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[]>;
+}
+//# sourceMappingURL=JSONLTimersManager.d.ts.map

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

@@ -0,0 +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"}

package/dist/cjs/JSONLTimersManager.js.map

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

package/dist/cjs/Log.cjs

@@ -0,0 +1,82 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Log = void 0;
+class Log {
+    static logger = null;
+    static initPromise = null;
+    static async ensureLogger() {
+        if (Log.logger)
+            return;
+        if (!Log.initPromise) {
+            Log.initPromise = (async () => {
+                try {
+                    const logtape = await Promise.resolve().then(() => __importStar(require("@logtape/logtape")));
+                    Log.logger = logtape.getLogger(["eternal-timer"]);
+                }
+                catch {
+                    console.info("Tip: Install the optional package '@logtape/logtape' to customize logging behavior.");
+                }
+            })();
+        }
+        await Log.initPromise;
+    }
+    static get loggerInstance() {
+        return Log.logger;
+    }
+}
+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.d.ts

@@ -0,0 +1,8 @@
+import type { Logger } from "@logtape/logtape";
+export declare class Log {
+    private static logger;
+    private static initPromise;
+    static ensureLogger(): Promise<void>;
+    static get loggerInstance(): Logger | null;
+}
+//# sourceMappingURL=Log.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Log.d.ts","sourceRoot":"","sources":["../../src/Log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,qBAAa,GAAG;IACf,OAAO,CAAC,MAAM,CAAC,MAAM,CAAuB;IAC5C,OAAO,CAAC,MAAM,CAAC,WAAW,CAA8B;WAEpC,YAAY;IAiBhC,WAAkB,cAAc,IAAI,MAAM,GAAG,IAAI,CAEhD;CACD"}

package/dist/cjs/Log.js.map

@@ -0,0 +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"}