eternal-timer 2.5.0 → 3.0.0

package/README.md

@@ -2,6 +2,7 @@
 
 ![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)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SUKEsann2000/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.
 
@@ -23,7 +24,7 @@ You can choose between two manager classes depending on the desired storage form
 
 ### `JSONLTimersManager` (JSON Lines)
 
-Use this manager to store timers in a `.jsonl` file, which allows for storing `title` and `description`.
+Use this manager to store timers in a `.jsonl` file, which allows for storing `extra` data.
 
 ```javascript
 import { JSONLTimersManager } from 'eternal-timer';
@@ -33,12 +34,12 @@ async function main() {
     const manager = new JSONLTimersManager();
 
     // Create a timer (5 seconds) with a title and description
-    const timerId = await manager.createTimer({length: 5000, title: 'My Timer', description: 'This is a test timer.'});
+    const timerId = await manager.createTimer({length: 5000, extra: { title: 'My Timer', description: 'This is a test timer.' }});
     console.log('Timer created:', timerId);
 
     // Monitor timers (executes when timer expires)
     const interval = await manager.checkTimers(async (timer) => {
-        console.log('Timer expired:', timer.id, timer.title);
+        console.log('Timer expired:', timer.id, timer.extra?.title);
     });
 
     // Display all timers
@@ -98,25 +99,57 @@ Creates a manager for timers stored in **JSON Lines** format.
 
 - **`timerfiledir`** (optional, string): Path to the timer file. Defaults to `.timers.jsonl` in the project root.
 
-#### `changeTitle(id: string, newTitle: string): Promise<void>`
-Changes the title of an existing timer.
+#### `changeExtra(id: string, newExtra: Extra): Promise<void>`
+Changes the `extra` data of an existing timer.
 
 - **`id`**: The ID of the timer to modify.
-- **`newTitle`**: The new title for the timer.
+- **`newExtra`**: The new `extra` object for the timer.
 
-**Returns:** A `Promise<void>` that resolves when the timer's title has been updated.
+**Returns:** A `Promise<void>` that resolves when the timer's `extra` data has been updated.
 
 **Throws:** An error if: the timer with the specified ID is not found, or a file operation fails.
 
-#### `changeDescription(id: string, newDescription: string): Promise<void>`
-Changes the description of an existing timer.
+#### Using the `Extra` Type Parameter
 
-- **`id`**: The ID of the timer to modify.
-- **`newDescription`**: The new description for the timer.
+The `JSONLTimersManager` is a generic class that accepts a type parameter `Extra`. This allows you to define the structure of the `extra` object that will be stored with your timers. By default, `Extra` is an empty object `{}`.
 
-**Returns:** A `Promise<void>` that resolves when the timer's description has been updated.
+**Example:** Defining and using a custom `Extra` type
 
-**Throws:** An error if: the timer with the specified ID is not found, or a file operation fails.
+```typescript
+import { JSONLTimersManager } from 'eternal-timer';
+
+interface MyTimerExtra {
+  title?: string;
+  description?: string;
+  category?: string;
+}
+
+async function main() {
+    // Specify MyTimerExtra as the type argument for JSONLTimersManager
+    const manager = new JSONLTimersManager<MyTimerExtra>();
+
+    // Create a timer with custom extra data
+    const timerId = await manager.createTimer({
+        length: 10000,
+        extra: {
+            title: 'Project Alpha Deadline',
+            description: 'Final submission for project Alpha.',
+            category: 'Work'
+        }
+    });
+    console.log('Timer created:', timerId);
+
+    // Retrieve and access the custom extra data
+    const timers = await manager.showTimers();
+    const myTimer = timers.find(t => t.id === timerId);
+    if (myTimer) {
+        console.log('Timer title:', myTimer.extra?.title);
+        console.log('Timer category:', myTimer.extra?.category);
+    }
+}
+
+main();
+```
 
 ### `PlainTextTimersManager`
 
@@ -139,13 +172,9 @@ Creates a new timer and saves it to the file.
   - `number` — Timer duration in milliseconds.
 
   When using `"JSONL"` storage:
-  - `{ length: number; title?: string; description?: string }`
+  - `{ length: number; extra?: Extra }`
     - `length` (number): Timer duration in milliseconds.
-    - `title` (optional, string): A title for the timer.
-    - `description` (optional, string): A description for the timer.
-
-  - `number` — Timer duration in milliseconds.  
-    ⚠ Not recommended. See [Storage Formats](#storage-formats).
+    - `extra` (optional, Extra): An object containing arbitrary user-defined metadata.
 
 **Returns** A `Promise<string>` that resolves to the timer's unique ID (UUID).
 
@@ -207,22 +236,22 @@ type StorageType = "JSONL" | "PlainText"
 The `Timer` object has the following structure:
 
 ```typescript
-type Timer<T extends StorageType> = {
+type Timer<T extends StorageType, Extra extends object> = {
   id: string;
   start: number;
   stop: number;
 } & (T extends "JSONL"
-  ? { title?: string; description?: string }
+  ? { extra: Extra }
   : {});
 ```
+`Extra` is a generic type parameter that represents an object containing arbitrary user-defined metadata for JSONL timers. For example, it can be `{ title?: string; description?: string }`.
 
 ## Scripts
 
-- `npm run dev`: Run in development mode with nodemon
 - `npm run build`: Compile TypeScript
-- `npm start`: Run compiled JavaScript
 - `npm run test`: Test the compiled code
 - `npm run lint`: Lint all codes
+- `npm run lint:fix`: Lint all codes and fix
 
 ## Storage Formats
 

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

@@ -9,11 +9,23 @@ import { JSONLTimersStore } from "../TimersStore/JSONLTimersStore.js";
  * - Timers are persisted in a file
  * - Expired timers are detected by polling
  */
-export declare class JSONLTimersManager extends TimersManager<"JSONL"> {
-    protected TimersStore: JSONLTimersStore | null;
+export declare class JSONLTimersManager<Extra extends object = object> extends TimersManager<"JSONL", Extra> {
+    protected TimersStore: JSONLTimersStore<Extra> | null;
     protected getDefaultFilename(): string;
-    protected createTimersStore(): Promise<JSONLTimersStore>;
-    changeTitle(id: string, newTitle: string): Promise<void>;
-    changeDescription(id: string, newDescription: string): Promise<void>;
+    protected createTimersStore(): Promise<JSONLTimersStore<Extra>>;
+    protected type: "JSONL";
+    /**
+     * changeExtra
+     * @description Change extra field
+     * @param {string} id
+     * @param {Extra} newExtra
+     * @returns Promise resolving when the operation is complete
+     * @throws If timer with id not found or file operation fails
+     * @example
+     * const timer = await manager.createTimer({ length: 1000, extra: {author: "someone"} });
+     * await changeExtra(timer, {author: "SUKEsann2000"});
+     * // extra is changed and author will be "SUKEsann2000" instead of "someone"
+     */
+    changeExtra(id: string, newExtra: Extra): Promise<void>;
 }
 //# sourceMappingURL=JSONLTimersManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"JSONLTimersManager.d.ts","sourceRoot":"","sources":["../../../src/TimersManager/JSONLTimersManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEtE;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,aAAa,CAAC,OAAO,CAAC;IAC7D,UAAmB,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAQ;cAE5C,kBAAkB,IAAI,MAAM;cAItB,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAI1D,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxD,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBjF"}
+{"version":3,"file":"JSONLTimersManager.d.ts","sourceRoot":"","sources":["../../../src/TimersManager/JSONLTimersManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEtE;;;;;;;;GAQG;AACH,qBAAa,kBAAkB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC;IACnG,UAAmB,WAAW,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAQ;cAEnD,kBAAkB,IAAI,MAAM;cAItB,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAI9E,UAAmB,IAAI,EAAE,OAAO,CAAoB;IAEpD;;;;;;;;;;;OAWG;IACU,WAAW,CACvB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,KAAK,GACb,OAAO,CAAC,IAAI,CAAC;CAkBhB"}

package/dist/cjs/TimersManager/{JSONLTimersManager.cjs → JSONLTimersManager.js}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.JSONLTimersManager = void 0;
-const TimersManager_js_1 = require("./TimersManager.cjs");
-const JSONLTimersStore_js_1 = require("../TimersStore/JSONLTimersStore.cjs");
+const TimersManager_js_1 = require("./TimersManager.js");
+const JSONLTimersStore_js_1 = require("../TimersStore/JSONLTimersStore.js");
 /**
  * JSONLTimersManager
  * @description
@@ -20,7 +20,20 @@ class JSONLTimersManager extends TimersManager_js_1.TimersManager {
     async createTimersStore() {
         return new JSONLTimersStore_js_1.JSONLTimersStore(this.timerfiledir);
     }
-    async changeTitle(id, newTitle) {
+    type = "JSONL";
+    /**
+     * changeExtra
+     * @description Change extra field
+     * @param {string} id
+     * @param {Extra} newExtra
+     * @returns Promise resolving when the operation is complete
+     * @throws If timer with id not found or file operation fails
+     * @example
+     * const timer = await manager.createTimer({ length: 1000, extra: {author: "someone"} });
+     * await changeExtra(timer, {author: "SUKEsann2000"});
+     * // extra is changed and author will be "SUKEsann2000" instead of "someone"
+     */
+    async changeExtra(id, newExtra) {
         return this.runExclusive(async () => {
             this.TimersStore ??= await this.createTimersStore();
             try {
@@ -29,28 +42,11 @@ class JSONLTimersManager extends TimersManager_js_1.TimersManager {
                 if (index === -1) {
                     throw new Error(`Timer with id ${id} not found`);
                 }
-                timers[index].title = newTitle;
+                timers[index].extra = newExtra;
                 await this.TimersStore.saveTimers(timers);
             }
             catch (e) {
-                throw new Error(`Error when changing title`, { cause: e });
-            }
-        });
-    }
-    async changeDescription(id, newDescription) {
-        return this.runExclusive(async () => {
-            this.TimersStore ??= await this.createTimersStore();
-            try {
-                const timers = await this.TimersStore.loadTimers();
-                const index = timers?.findIndex(t => t.id === id);
-                if (index === -1) {
-                    throw new Error(`Timer with id ${id} not found`);
-                }
-                timers[index].description = newDescription;
-                await this.TimersStore.saveTimers(timers);
-            }
-            catch (e) {
-                throw new Error(`Error when changing description`, { cause: e });
+                throw new Error(`Error when changing extra`, { cause: e });
             }
         });
     }

package/dist/cjs/TimersManager/JSONLTimersManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSONLTimersManager.js","sourceRoot":"","sources":["../../../src/TimersManager/JSONLTimersManager.ts"],"names":[],"mappings":";;;AAAA,yDAAmD;AACnD,4EAAsE;AAEtE;;;;;;;;GAQG;AACH,MAAa,kBAAkD,SAAQ,gCAA6B;IAChF,WAAW,GAAmC,IAAI,CAAC;IAEnD,kBAAkB;QACpC,OAAO,eAAe,CAAC;IACxB,CAAC;IAEkB,KAAK,CAAC,iBAAiB;QACzC,OAAO,IAAI,sCAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IAEkB,IAAI,GAAY,OAAgB,CAAC;IAEpD;;;;;;;;;;;OAWG;IACI,KAAK,CAAC,WAAW,CACvB,EAAU,EACV,QAAe;QAEf,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE;YACnC,IAAI,CAAC,WAAW,KAAK,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACpD,IAAI,CAAC;gBACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;gBAEnD,MAAM,KAAK,GAAG,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;gBAClD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;gBAClD,CAAC;gBAED,MAAM,CAAC,KAAK,CAAE,CAAC,KAAK,GAAG,QAAQ,CAAC;gBAChC,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAC5D,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;CACD;AA9CD,gDA8CC"}

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

@@ -9,9 +9,10 @@ import { PlainTextTimersStore } from "../TimersStore/PlainTextTimersStore.js";
  * - Timers are persisted in a file
  * - Expired timers are detected by polling
  */
-export declare class PlainTextTimersManager extends TimersManager<"PlainText"> {
+export declare class PlainTextTimersManager extends TimersManager<"PlainText", object> {
     protected TimersStore: PlainTextTimersStore | null;
     protected getDefaultFilename(): string;
     protected createTimersStore(): Promise<PlainTextTimersStore>;
+    protected type: "PlainText";
 }
 //# sourceMappingURL=PlainTextTimersManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PlainTextTimersManager.d.ts","sourceRoot":"","sources":["../../../src/TimersManager/PlainTextTimersManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,SAAQ,aAAa,CAAC,WAAW,CAAC;IACrE,UAAmB,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAQ;cAEhD,kBAAkB,IAAI,MAAM;cAI/B,iBAAiB,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAGlE"}
+{"version":3,"file":"PlainTextTimersManager.d.ts","sourceRoot":"","sources":["../../../src/TimersManager/PlainTextTimersManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,SAAQ,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7E,UAAmB,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAQ;cAEhD,kBAAkB,IAAI,MAAM;cAI/B,iBAAiB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAIlE,UAAmB,IAAI,EAAE,WAAW,CAAwB;CAC5D"}

package/dist/cjs/TimersManager/{PlainTextTimersManager.cjs → PlainTextTimersManager.js}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PlainTextTimersManager = void 0;
-const TimersManager_js_1 = require("./TimersManager.cjs");
-const PlainTextTimersStore_js_1 = require("../TimersStore/PlainTextTimersStore.cjs");
+const TimersManager_js_1 = require("./TimersManager.js");
+const PlainTextTimersStore_js_1 = require("../TimersStore/PlainTextTimersStore.js");
 /**
  * PlainTextTimersManager
  * @description
@@ -20,6 +20,7 @@ class PlainTextTimersManager extends TimersManager_js_1.TimersManager {
     async createTimersStore() {
         return new PlainTextTimersStore_js_1.PlainTextTimersStore(this.timerfiledir);
     }
+    type = "PlainText";
 }
 exports.PlainTextTimersManager = PlainTextTimersManager;
 //# sourceMappingURL=PlainTextTimersManager.js.map

package/dist/cjs/TimersManager/{PlainTextTimersManager.cjs.map → PlainTextTimersManager.js.map}

@@ -1 +1 @@
-{"version":3,"file":"PlainTextTimersManager.js","sourceRoot":"","sources":["../../../src/TimersManager/PlainTextTimersManager.ts"],"names":[],"mappings":";;;AAAA,yDAAmD;AACnD,oFAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAa,sBAAuB,SAAQ,gCAA0B;IAClD,WAAW,GAAgC,IAAI,CAAC;IAEhD,kBAAkB;QACpC,OAAO,SAAS,CAAC;IAClB,CAAC;IAES,KAAK,CAAC,iBAAiB;QAChC,OAAO,IAAI,8CAAoB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpD,CAAC;CACD;AAVD,wDAUC"}
+{"version":3,"file":"PlainTextTimersManager.js","sourceRoot":"","sources":["../../../src/TimersManager/PlainTextTimersManager.ts"],"names":[],"mappings":";;;AAAA,yDAAmD;AACnD,oFAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAa,sBAAuB,SAAQ,gCAAkC;IAC1D,WAAW,GAAgC,IAAI,CAAC;IAEhD,kBAAkB;QACpC,OAAO,SAAS,CAAC;IAClB,CAAC;IAES,KAAK,CAAC,iBAAiB;QAChC,OAAO,IAAI,8CAAoB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpD,CAAC;IAEkB,IAAI,GAAgB,WAAoB,CAAC;CAC5D;AAZD,wDAYC"}

package/dist/cjs/TimersManager/TimersManager.d.ts

@@ -9,18 +9,19 @@ import { TimersStore } from "../TimersStore/TimersStore.js";
  * - Timers are persisted in a file
  * - Expired timers are detected by polling
  */
-export declare abstract class TimersManager<T extends StorageType> {
+export declare abstract class TimersManager<T extends StorageType, Extra extends object> {
     protected readonly timerfiledir: string;
     private checkLock;
-    protected TimersStore: TimersStore<T> | null;
+    protected TimersStore: TimersStore<T, Extra> | null;
     private queue;
     protected runExclusive<T>(fn: () => Promise<T>): Promise<T>;
     protected abstract getDefaultFilename(): string;
-    protected abstract createTimersStore(): Promise<TimersStore<T>>;
+    protected abstract createTimersStore(): Promise<TimersStore<T, Extra>>;
+    protected abstract type: T;
     /**
       * constructor
       * @description Initializes the TimersManager instance. If the timer file does not exist, an empty file is created.
-      * @param options (TimersManagerOptions | string, optional) Configuration object or timer file path. If a string is provided, it is treated as the timer file path. If an object is provided, `timerfiledir` can be specified.
+      * @param {string} [options] (string, optional) Configuration timer file path and it is treated as the timer file path.
       * @throws If file access or creation fails
       * @example
       * const manager = new TimersManager(); // Uses default timer file path
@@ -30,7 +31,7 @@ export declare abstract class TimersManager<T extends StorageType> {
     /**
      * createTimer
      * @description Creates a new timer.
-     * @param length Timer duration in milliseconds
+     * @param {{length: number, extra: Extra} | number} options Timer duration in milliseconds and extra field(only JSONL)
      * @returns Promise that resolves to the timer ID (UUID)
      * @throws If length is invalid(e.g. length < 0) or file operation fails
      * @example
@@ -38,12 +39,12 @@ export declare abstract class TimersManager<T extends StorageType> {
      * const newTimer = await manager.createTimer(5000);
      * // newTimer will be id of the timer
      */
-    createTimer(options: CreateTimerOptions<T>): Promise<string>;
+    createTimer(options: CreateTimerOptions<T, Extra>): Promise<string>;
     /**
      * removeTimer
      * @description Removes a timer by ID.
-     * @param id ID of the timer to remove
-     * @returns void
+     * @param {string} id ID of the timer to remove
+     * @returns Promise resolving when the operation is complete
      * @throws If file operation fails
      * @example
      * await manager.removeTimer(id);
@@ -54,16 +55,16 @@ export declare abstract class TimersManager<T extends StorageType> {
      * @description Starts monitoring timers at the specified interval.
      * When a timer expires, the provided `callback` is invoked with the timer.
      * The callback is awaited before the next processing cycle continues.
-     * @param callback Function invoked when an expired timer is detected (called asynchronously)
-     * @param interval (number, optional): Check interval in milliseconds (default: 200ms)
+     * @param {(timer: Timer<T, Extra>) => void | Promise<void>} callback Function invoked when an expired timer is detected (called asynchronously)
+     * @param {number} [interval=200] (number, optional): Check interval in milliseconds (default: 200ms)
      * @throws If file operation fails
-     * @returns (Promise<NodeJS.Timeout>) intervalId interval id of checkTimers
+     * @returns {Promise<NodeJS.Timeout>} intervalId interval id of checkTimers
      * @example
      * const interval = await manager.checkTimers((timer) => {
      *     console.log(`A timer was stopped: ${timer.id}`);
      * });
      */
-    checkTimers(callback: (timer: Timer<T>) => void | Promise<void>, interval?: number): Promise<NodeJS.Timeout>;
+    checkTimers(callback: (timer: Timer<T, Extra>) => void | Promise<void>, interval?: number): Promise<NodeJS.Timeout>;
     /**
      * showTimers
      * @description Retrieves all active timers.
@@ -73,12 +74,12 @@ export declare abstract class TimersManager<T extends StorageType> {
      * const timers = await manager.showTimers();
      * console.log(JSON.stringify(timers))
      */
-    showTimers(): Promise<Timer<T>[]>;
+    showTimers(): Promise<Timer<T, Extra>[]>;
     /**
       * adjustRemainingTime
       * @description Adjusts the remaining time of a timer.
-      * @param id ID of the timer to modify
-      * @param delay Delay in milliseconds to add/subtract from the remaining time
+      * @param {string} id ID of the timer to modify
+      * @param {number} delay Delay in milliseconds to add/subtract from the remaining time
       * @returns Promise resolving when the operation is complete
       * @throws If file operation fails
       */

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

@@ -1 +1 @@
-{"version":3,"file":"TimersManager.d.ts","sourceRoot":"","sources":["../../../src/TimersManager/TimersManager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAG5D;;;;;;;;GAQG;AACH,8BAAsB,aAAa,CAAC,CAAC,SAAS,WAAW;IACxD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IACxC,OAAO,CAAC,SAAS,CAAkB;IAEnC,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAQ;IAEpD,OAAO,CAAC,KAAK,CAAoC;IACjD,SAAS,CAAC,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC;IAM9C,SAAS,CAAC,QAAQ,CAAC,kBAAkB,IAAI,MAAM;IAC/C,SAAS,CAAC,QAAQ,CAAC,iBAAiB,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAE/D;;;;;;;;QAQO;gBAEN,OAAO,CAAC,EAAE,MAAM;IAcjB;;;;;;;;;;OAUM;IACO,WAAW,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BzE;;;;;;;;OAQM;IACO,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnD;;;;;;;;;;;;;OAaM;IACO,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IAuD9H;;;;;;;;OAQM;IACO,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAQ9C;;;;;;;QAOO;IACM,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsB1E"}
+{"version":3,"file":"TimersManager.d.ts","sourceRoot":"","sources":["../../../src/TimersManager/TimersManager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAG5D;;;;;;;;GAQG;AACH,8BAAsB,aAAa,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,SAAS,MAAM;IAC9E,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IACxC,OAAO,CAAC,SAAS,CAAkB;IAEnC,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,CAAQ;IAE3D,OAAO,CAAC,KAAK,CAAoC;IACjD,SAAS,CAAC,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC;IAM9C,SAAS,CAAC,QAAQ,CAAC,kBAAkB,IAAI,MAAM;IAC/C,SAAS,CAAC,QAAQ,CAAC,iBAAiB,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACtE,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAE3B;;;;;;;;QAQO;gBAEN,OAAO,CAAC,EAAE,MAAM;IAcjB;;;;;;;;;;OAUM;IACO,WAAW,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BhF;;;;;;;;OAQM;IACO,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnD;;;;;;;;;;;;;OAaM;IACO,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IAuDrI;;;;;;;;OAQM;IACO,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;IAQrD;;;;;;;QAOO;IACM,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsB1E"}

package/dist/cjs/TimersManager/{TimersManager.cjs → TimersManager.js}

@@ -7,8 +7,8 @@ exports.TimersManager = void 0;
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const uuid_1 = require("uuid");
-const searchRoot_js_1 = __importDefault(require("../searchRoot.cjs"));
-const Log_js_1 = require("../Log.cjs");
+const searchRoot_js_1 = __importDefault(require("../searchRoot.js"));
+const Log_js_1 = require("../Log.js");
 /**
  * TimersManager
  * @description
@@ -31,7 +31,7 @@ class TimersManager {
     /**
       * constructor
       * @description Initializes the TimersManager instance. If the timer file does not exist, an empty file is created.
-      * @param options (TimersManagerOptions | string, optional) Configuration object or timer file path. If a string is provided, it is treated as the timer file path. If an object is provided, `timerfiledir` can be specified.
+      * @param {string} [options] (string, optional) Configuration timer file path and it is treated as the timer file path.
       * @throws If file access or creation fails
       * @example
       * const manager = new TimersManager(); // Uses default timer file path
@@ -53,7 +53,7 @@ class TimersManager {
     /**
      * createTimer
      * @description Creates a new timer.
-     * @param length Timer duration in milliseconds
+     * @param {{length: number, extra: Extra} | number} options Timer duration in milliseconds and extra field(only JSONL)
      * @returns Promise that resolves to the timer ID (UUID)
      * @throws If length is invalid(e.g. length < 0) or file operation fails
      * @example
@@ -64,6 +64,9 @@ class TimersManager {
     async createTimer(options) {
         return this.runExclusive(async () => {
             this.TimersStore ??= await this.createTimersStore();
+            if (this.type === "JSONL" && typeof options === "number") {
+                throw new Error(`Cannot create timer without extra fields in JSONL`);
+            }
             let length = typeof options === "object" ? options.length : options;
             if (length < 0)
                 throw new Error(`Invalid length: ${length}`);
@@ -75,8 +78,9 @@ class TimersManager {
                 id,
                 start: now,
                 stop: stopTime,
-                ...(typeof options === "object" && options.title !== undefined && { title: options.title }),
-                ...(typeof options === "object" && options.description !== undefined && { description: options.description }),
+                ...(options && typeof options === "object" && options.extra !== undefined
+                    ? { extra: options.extra }
+                    : {}),
             };
             await this.TimersStore.appendTimer(newTimerData);
             return id;
@@ -85,8 +89,8 @@ class TimersManager {
     /**
      * removeTimer
      * @description Removes a timer by ID.
-     * @param id ID of the timer to remove
-     * @returns void
+     * @param {string} id ID of the timer to remove
+     * @returns Promise resolving when the operation is complete
      * @throws If file operation fails
      * @example
      * await manager.removeTimer(id);
@@ -109,10 +113,10 @@ class TimersManager {
      * @description Starts monitoring timers at the specified interval.
      * When a timer expires, the provided `callback` is invoked with the timer.
      * The callback is awaited before the next processing cycle continues.
-     * @param callback Function invoked when an expired timer is detected (called asynchronously)
-     * @param interval (number, optional): Check interval in milliseconds (default: 200ms)
+     * @param {(timer: Timer<T, Extra>) => void | Promise<void>} callback Function invoked when an expired timer is detected (called asynchronously)
+     * @param {number} [interval=200] (number, optional): Check interval in milliseconds (default: 200ms)
      * @throws If file operation fails
-     * @returns (Promise<NodeJS.Timeout>) intervalId interval id of checkTimers
+     * @returns {Promise<NodeJS.Timeout>} intervalId interval id of checkTimers
      * @example
      * const interval = await manager.checkTimers((timer) => {
      *     console.log(`A timer was stopped: ${timer.id}`);
@@ -183,8 +187,8 @@ class TimersManager {
     /**
       * adjustRemainingTime
       * @description Adjusts the remaining time of a timer.
-      * @param id ID of the timer to modify
-      * @param delay Delay in milliseconds to add/subtract from the remaining time
+      * @param {string} id ID of the timer to modify
+      * @param {number} delay Delay in milliseconds to add/subtract from the remaining time
       * @returns Promise resolving when the operation is complete
       * @throws If file operation fails
       */

package/dist/cjs/TimersManager/TimersManager.js.map

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

package/dist/cjs/TimersStore/JSONLTimersStore.d.ts

@@ -1,6 +1,6 @@
 import type { Timer } from "../types.js";
 import { TimersStore } from "./TimersStore.js";
-export declare class JSONLTimersStore extends TimersStore<"JSONL"> {
+export declare class JSONLTimersStore<Extra extends object> extends TimersStore<"JSONL", Extra> {
     constructor(timerfile: string);
     /**
      * checkTimerfileSyntax
@@ -9,8 +9,8 @@ export declare class JSONLTimersStore extends TimersStore<"JSONL"> {
      * @returns void
      * @throws If syntax is invalid
      */
-    protected checkTimerfileSyntax(timers: Timer<"JSONL">[]): Promise<void>;
-    toStringifyTimers(timers: Timer<"JSONL">[]): string;
-    parseTimers(data: string): Timer<"JSONL">[];
+    protected checkTimerfileSyntax(timers: Timer<"JSONL", Extra>[]): Promise<void>;
+    toStringifyTimers(timers: Timer<"JSONL", Extra>[]): string;
+    parseTimers(data: string): Timer<"JSONL", Extra>[];
 }
 //# sourceMappingURL=JSONLTimersStore.d.ts.map

package/dist/cjs/TimersStore/JSONLTimersStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JSONLTimersStore.d.ts","sourceRoot":"","sources":["../../../src/TimersStore/JSONLTimersStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,qBAAa,gBAAiB,SAAQ,WAAW,CAAC,OAAO,CAAC;gBAGxD,SAAS,EAAE,MAAM;IAKlB;;;;;;OAMG;cACsB,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IActE,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM;IAOnD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE;CAM3D"}
+{"version":3,"file":"JSONLTimersStore.d.ts","sourceRoot":"","sources":["../../../src/TimersStore/JSONLTimersStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,qBAAa,gBAAgB,CAAC,KAAK,SAAS,MAAM,CAAE,SAAQ,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;gBAGrF,SAAS,EAAE,MAAM;IAKlB;;;;;;OAMG;cACsB,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7E,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,MAAM;IAO1D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE;CAMlE"}

package/dist/cjs/TimersStore/{JSONLTimersStore.cjs → JSONLTimersStore.js}

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.JSONLTimersStore = void 0;
 const uuid_1 = require("uuid");
-const TimersStore_js_1 = require("./TimersStore.cjs");
+const TimersStore_js_1 = require("./TimersStore.js");
 class JSONLTimersStore extends TimersStore_js_1.TimersStore {
     constructor(timerfile) {
         super(timerfile);
@@ -19,6 +19,10 @@ class JSONLTimersStore extends TimersStore_js_1.TimersStore {
             throw new Error(`Timer file's syntax is wrong`);
         };
         for (const timer of timers) {
+            if (Object.keys(timer).length !== 4)
+                throwing();
+            if (Object.keys(timer).length !== 4)
+                throwing();
             if (!timer.id || !(0, uuid_1.validate)(timer.id))
                 throwing();
             if (!timer.start || typeof timer.start !== "number")
@@ -27,9 +31,7 @@ class JSONLTimersStore extends TimersStore_js_1.TimersStore {
                 throwing();
             if (timer.start > timer.stop)
                 throwing();
-            if (timer.title && typeof timer.title !== "string")
-                throwing();
-            if (timer.description && typeof timer.description !== "string")
+            if (!timer.extra || typeof timer.extra !== "object")
                 throwing();
         }
     }

package/dist/cjs/TimersStore/JSONLTimersStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSONLTimersStore.js","sourceRoot":"","sources":["../../../src/TimersStore/JSONLTimersStore.ts"],"names":[],"mappings":";;;AAAA,+BAAgC;AAGhC,qDAA+C;AAE/C,MAAa,gBAAuC,SAAQ,4BAA2B;IAEtF,YACC,SAAiB;QAEjB,KAAK,CAAC,SAAS,CAAC,CAAC;IAClB,CAAC;IAED;;;;;;OAMG;IACgB,KAAK,CAAC,oBAAoB,CAAC,MAA+B;QAC5E,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,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;gBAAE,QAAQ,EAAE,CAAC;YAChD,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,IAAA,eAAQ,EAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,QAAQ,EAAE,CAAC;YACjD,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;gBAAE,QAAQ,EAAE,CAAC;YAChE,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,QAAQ,EAAE,CAAC;YAC9D,IAAI,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI;gBAAE,QAAQ,EAAE,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;gBAAE,QAAQ,EAAE,CAAC;QACjE,CAAC;IACF,CAAC;IAEe,iBAAiB,CAAC,MAA+B;QAChE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACX,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,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,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAA0B,CAAC,CAAC;IAC5D,CAAC;CACD;AA3CD,4CA2CC"}

package/dist/cjs/TimersStore/PlainTextTimersStore.d.ts

@@ -1,6 +1,6 @@
 import type { Timer } from "../types.js";
 import { TimersStore } from "./TimersStore.js";
-export declare class PlainTextTimersStore extends TimersStore<"PlainText"> {
+export declare class PlainTextTimersStore extends TimersStore<"PlainText", object> {
     constructor(timerfile: string);
     /**
      * checkTimerfileSyntax
@@ -9,8 +9,8 @@ export declare class PlainTextTimersStore extends TimersStore<"PlainText"> {
      * @returns void
      * @throws If syntax is invalid
      */
-    protected checkTimerfileSyntax(timers: Timer<"PlainText">[]): Promise<void>;
-    toStringifyTimers(timers: Timer<"PlainText">[]): string;
-    parseTimers(data: string): Timer<"PlainText">[];
+    protected checkTimerfileSyntax(timers: Timer<"PlainText", object>[]): Promise<void>;
+    toStringifyTimers(timers: Timer<"PlainText", object>[]): string;
+    parseTimers(data: string): Timer<"PlainText", object>[];
 }
 //# sourceMappingURL=PlainTextTimersStore.d.ts.map

package/dist/cjs/TimersStore/PlainTextTimersStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlainTextTimersStore.d.ts","sourceRoot":"","sources":["../../../src/TimersStore/PlainTextTimersStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,qBAAa,oBAAqB,SAAQ,WAAW,CAAC,WAAW,CAAC;gBAGhE,SAAS,EAAE,MAAM;IAKlB;;;;;;OAMM;cACmB,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1E,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,GAAG,MAAM;IAOvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,EAAE;CAa/D"}
+{"version":3,"file":"PlainTextTimersStore.d.ts","sourceRoot":"","sources":["../../../src/TimersStore/PlainTextTimersStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,qBAAa,oBAAqB,SAAQ,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC;gBAGxE,SAAS,EAAE,MAAM;IAKlB;;;;;;OAMM;cACmB,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAclF,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,GAAG,MAAM;IAO/D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE;CAavE"}

package/dist/cjs/TimersStore/{PlainTextTimersStore.cjs → PlainTextTimersStore.js}

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PlainTextTimersStore = void 0;
 const uuid_1 = require("uuid");
-const TimersStore_js_1 = require("./TimersStore.cjs");
+const TimersStore_js_1 = require("./TimersStore.js");
 class PlainTextTimersStore extends TimersStore_js_1.TimersStore {
     constructor(timerfile) {
         super(timerfile);

package/dist/cjs/TimersStore/{PlainTextTimersStore.cjs.map → PlainTextTimersStore.js.map}

@@ -1 +1 @@
-{"version":3,"file":"PlainTextTimersStore.js","sourceRoot":"","sources":["../../../src/TimersStore/PlainTextTimersStore.ts"],"names":[],"mappings":";;;AAAA,+BAAgC;AAGhC,qDAA+C;AAE/C,MAAa,oBAAqB,SAAQ,4BAAwB;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,IAAA,eAAQ,EAAC,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;AAjDD,oDAiDC"}
+{"version":3,"file":"PlainTextTimersStore.js","sourceRoot":"","sources":["../../../src/TimersStore/PlainTextTimersStore.ts"],"names":[],"mappings":";;;AAAA,+BAAgC;AAGhC,qDAA+C;AAE/C,MAAa,oBAAqB,SAAQ,4BAAgC;IAEzE,YACC,SAAiB;QAEjB,KAAK,CAAC,SAAS,CAAC,CAAC;IAClB,CAAC;IAED;;;;;;OAMM;IACa,KAAK,CAAC,oBAAoB,CAAC,MAAoC;QACjF,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,IAAA,eAAQ,EAAC,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,MAAoC;QACrE,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;aACQ,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;CACD;AAjDD,oDAiDC"}

package/dist/cjs/TimersStore/TimersStore.d.ts

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

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

@@ -1 +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"}
+{"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,EAAE,KAAK,SAAS,MAAM;IAC5E,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAErC,SAAS,aACR,SAAS,EAAE,MAAM;IAKL,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;IAWxC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5D,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;aACjE,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,MAAM;aACvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE;CAC5D"}