eternal-timer 2.5.1 → 4.0.0

package/README.md

@@ -8,7 +8,7 @@ A simple and persistent timer library for Node.js. Timers are saved to a file an
 
 ## Features
 
-- **Monitor Timers (asynchronous)**: Start monitoring expired timers asynchronously; the function returns immediately and the callback is called when timers expire.
+- **Monitor Timers (event-driven)**: Start monitoring expired timers and react to events like `expired`, `started`, `stopped`, and `updated` through an event system.
 - **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.
 
@@ -24,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';
@@ -34,12 +34,15 @@ 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);
+    // Start monitoring for expired timers
+    const interval = await manager.checkStart();
+
+    // Listen for 'expired' events
+    manager.on('expired', (timer) => {
+        console.log('Timer expired:', timer.id, timer.extra?.title);
     });
 
     // Display all timers
@@ -71,8 +74,11 @@ async function main() {
     const timerId = await manager.createTimer(5000);
     console.log('Timer created:', timerId);
 
-    // Monitor timers
-    const interval = await manager.checkTimers(async (timer) => {
+    // Start monitoring for expired timers
+    const interval = await manager.checkStart();
+
+    // Listen for 'expired' events
+    manager.on('expired', (timer) => {
         console.log('Timer expired:', timer.id);
     });
 
@@ -83,7 +89,7 @@ async function main() {
     // Stop monitoring after a while
     setTimeout(() => {
         clearInterval(interval);
-        console.log('Stopped monitoring timers.');
+        console.log('Stopped monitoring for timers.');
     }, 10000);
 }
 
@@ -99,25 +105,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`
 
@@ -128,30 +166,55 @@ Creates a manager for timers stored in **plain-text** format.
 
 ---
 
-### `createTimer(options: CreateTimerOptions<T>): Promise<string>`
+### `createTimer(options: CreateTimerOptions<T, Extra>): Promise<string>`
 
 Creates a new timer and saves it to the file.
 
 #### Parameters
 
-- **`options`**
+- **`options`** (`CreateTimerOptions<T, Extra>`)
+  - When using `PlainTextTimersManager` (type `PlainText`):
+    - `number` — The timer's duration in milliseconds.
+  - When using `JSONLTimersManager` (type `JSONL`):
+    - `{ length: number; extra?: Extra }`
+      - `length` (number): The timer's duration in milliseconds.
+      - `extra` (optional, `Extra` object): An object containing arbitrary user-defined metadata for the timer.
 
-  When using `"PlainText"` storage:
-  - `number` — Timer duration in milliseconds.
+**Returns** A `Promise<string>` that resolves to the timer's unique ID (UUID).
 
-  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.
+**Throws** An error if: `length` is invalid (e.g., negative) or a file operation fails.
 
-  - `number` — Timer duration in milliseconds.  
-    ⚠ Not recommended. See [Storage Formats](#storage-formats).
+**Examples:**
 
-**Returns** A `Promise<string>` that resolves to the timer's unique ID (UUID).
+```javascript
+// For PlainTextTimersManager with a custom Extra type
+import { PlainTextTimersManager } from 'eternal-timer';
+
+// For PlainTextTimersManager
+const manager = new PlainTextTimersManager();
+const newTimerId = await manager.createTimer(5000); // Create a 5-second timer
+console.log('Created PlainText timer with ID:', newTimerId);
+```
 
-**Throws** An error if: `length` is invalid (e.g., negative) or a file operation fails
+```typescript
+// For JSONLTimersManager with a custom Extra type
+import { JSONLTimersManager } from 'eternal-timer';
+
+interface MyCustomExtra {
+  purpose: string;
+  userId: string;
+}
 
+const jsonlManager = new JSONLTimersManager<MyCustomExtra>();
+const jsonlTimerId = await jsonlManager.createTimer({
+  length: 10000, // 10 seconds
+  extra: {
+    purpose: "Session Timeout",
+    userId: "user-123"
+  }
+});
+console.log('Created JSONL timer with ID:', jsonlTimerId);
+```
 ### `removeTimer(id: string): Promise<void>`
 
 Removes a timer by its ID.
@@ -162,22 +225,61 @@ Removes a timer by its ID.
 
 **Throws:** An error if the timer with the specified ID is not found or if a file operation fails.
 
-### `checkTimers(callback: (timer: Timer) => void | Promise<void>, interval?: number): Promise<NodeJS.Timeout>`
+### `checkStart(interval?: number): Promise<NodeJS.Timeout>`
+
+Starts the timer checking loop. This method should be called once after creating an instance of a `TimersManager` to begin detecting expired timers. Events like `expired`, `errored`, `started`, `stopped`, and `updated` are emitted, which can be listened to using the `on` method.
+
+- **`interval`** (optional, number): Polling interval in milliseconds (default: 200ms)
+
+**Returns:** The interval ID which can be used to stop the loop with `clearInterval()`.
+
+**Throws:** If file operation fails during checking.
+
+### `on<K extends keyof TimerEvents<T, Extra>>(event: K, listener: (payload: TimerEvents<T, Extra>[K]) => void | Promise<void>): void`
+
+Registers an event listener for a specific timer event.
+
+- **`event`**: The name of the event to listen for (e.g., `'expired'`, `'started'`, `'stopped'`, `'updated'`, `'errored'`).
+- **`listener`**: The callback function to execute when the event is emitted. It receives the event payload as an argument.
+
+**Returns:** `void`
+
+**Example:**
+```javascript
+manager.on('expired', (timer) => {
+    console.log(`Timer ${timer.id} expired!`);
+});
+
+manager.on('errored', (error) => {
+    console.error('Timer event error:', error);
+});
+```
+
+### `once<K extends keyof TimerEvents<T, Extra>>(event: K, listener: (payload: TimerEvents<T, Extra>[K]) => void | Promise<void>): void`
+
+Registers a one-time event listener for a specific timer event. The listener will be invoked only once for the specified event, after which it will be automatically removed.
 
-Starts monitoring timers at the specified interval and invokes the provided
-`callback` when a timer expires.
+- **`event`**: The name of the event to listen for.
+- **`listener`**: The callback function to execute when the event is emitted.
 
-For each expired timer, the `callback` is awaited before processing continues.
-Monitoring runs periodically in the background and can be stopped using the
-returned `NodeJS.Timeout`.
+**Returns:** `void`
 
-- **callback**: An async function invoked with the expired `timer`.
-- **interval** *(optional, number)*: Interval in milliseconds for checking timers.
-  Defaults to `200`.
+### `off<K extends keyof TimerEvents<T, Extra>>(event: K, listener: (payload: TimerEvents<T, Extra>[K]) => void | Promise<void>): void`
 
-**Returns:** A `NodeJS.Timeout` that can be passed to `clearInterval()` to stop monitoring.
+Removes a specific event listener for a given event.
 
-**Throws:** An error if a timer storage operation fails.
+- **`event`**: The name of the event from which to remove the listener.
+- **`listener`**: The listener function to remove.
+
+**Returns:** `void`
+
+### `offAll<K extends keyof TimerEvents<T, Extra>>(event: K): void`
+
+Removes all event listeners for a specific event.
+
+- **`event`**: The name of the event for which to remove all listeners.
+
+**Returns:** `void`
 
 ### `showTimers(): Promise<Timer[]>`
 
@@ -198,6 +300,13 @@ Adjusts the remaining time of a specified timer. This can be used to extend or s
 
 **Throws:** An error if: the timer with the specified ID is not found, the resulting remaining time would be negative, or a file operation fails.
 
+**Example:**
+```javascript
+// Assuming 'timerId' is the ID of an existing timer
+await manager.adjustRemainingTime(timerId, 60000); // Add 1 minute to the timer
+await manager.adjustRemainingTime(timerId, -30000); // Subtract 30 seconds from the timer
+```
+
 ## Type Definition
 
 The `StorageType` has the following structure:
@@ -208,15 +317,45 @@ 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 }
-  : {});
+type Timer<T extends StorageType, Extra extends object> =
+    T extends "JSONL"
+        ? {
+              id: string;
+              start: number;
+              stop: number;
+              extra: Extra
+          }
+        : {
+              id: string;
+              start: number;
+              stop: number;
+          };
+```
+`Extra` is a generic type parameter that represents an object containing arbitrary user-defined metadata for JSONL timers. By default, it's `object`. For example, it can be `{ title?: string; description?: string }`.
+
+The `CreateTimerOptions` type is used when creating new timers:
+```typescript
+type CreateTimerOptions<T extends StorageType, Extra extends object> = T extends "JSONL"
+    ? {
+          length: number;
+          extra: Extra
+      }
+    : T extends "PlainText"
+      ? number
+      : never;
 ```
 
+The `TimerEvents` type defines the events emitted by `TimersManager`:
+```typescript
+type TimerEvents<T extends StorageType, Extra extends object> = {
+  expired: Timer<T, Extra>
+  errored: Error
+  interval: void
+  started: Timer<T, Extra>
+  stopped: Timer<T, Extra>
+  updated: { old: Timer<T, Extra>, new: Timer<T, Extra> }
+}
+```
 ## Scripts
 
 - `npm run build`: Compile TypeScript

package/dist/cjs/EventEmitter.d.ts

@@ -0,0 +1,12 @@
+import type { StorageType, TimerEvents } from "./types.js";
+export declare class EventEmitter<T extends StorageType, Extra extends object> {
+    protected listeners: {
+        [K in keyof TimerEvents<T, Extra>]?: ((payload: TimerEvents<T, Extra>[K]) => void | Promise<void>)[];
+    };
+    on<K extends keyof TimerEvents<T, Extra>>(event: K, listener: (payload: TimerEvents<T, Extra>[K]) => void | Promise<void>): void;
+    once<K extends keyof TimerEvents<T, Extra>>(event: K, listener: (payload: TimerEvents<T, Extra>[K]) => void | Promise<void>): void;
+    off<K extends keyof TimerEvents<T, Extra>>(event: K, listener: (payload: TimerEvents<T, Extra>[K]) => void | Promise<void>): void;
+    offAll<K extends keyof TimerEvents<T, Extra>>(event: K): void;
+    protected emit<K extends keyof TimerEvents<T, Extra>>(event: K, payload: TimerEvents<T, Extra>[K]): Promise<void>;
+}
+//# sourceMappingURL=EventEmitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../src/EventEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3D,qBAAa,YAAY,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,SAAS,MAAM;IACpE,SAAS,CAAC,SAAS,EAAE;SACb,CAAC,IAAI,MAAM,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAClC,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAChC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE;KAC/B,CAAM;IAEH,EAAE,CAAC,CAAC,SAAS,MAAM,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,EAC9C,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnE,IAAI;IAOA,IAAI,CAAC,CAAC,SAAS,MAAM,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,EAChD,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnE,IAAI;IAQA,GAAG,CAAC,CAAC,SAAS,MAAM,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,EAC/C,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnE,IAAI;IAUA,MAAM,CAAC,CAAC,SAAS,MAAM,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,EAClD,KAAK,EAAE,CAAC,GACN,IAAI;cAIS,IAAI,CAAC,CAAC,SAAS,MAAM,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,EACzD,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;CAoBhB"}

package/dist/cjs/EventEmitter.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventEmitter = void 0;
+class EventEmitter {
+    listeners = {};
+    on(event, listener) {
+        if (!this.listeners[event]) {
+            this.listeners[event] = [];
+        }
+        this.listeners[event].push(listener);
+    }
+    once(event, listener) {
+        const wrapper = (payload) => {
+            this.off(event, wrapper);
+            return listener(payload);
+        };
+        this.on(event, wrapper);
+    }
+    off(event, listener) {
+        const listeners = this.listeners[event];
+        if (!listeners)
+            return;
+        const index = listeners.indexOf(listener);
+        if (index !== -1) {
+            listeners.splice(index, 1);
+        }
+    }
+    offAll(event) {
+        this.listeners[event] = [];
+    }
+    async emit(event, payload) {
+        const listeners = this.listeners[event];
+        if (!listeners?.length)
+            return;
+        const errors = [];
+        await Promise.all(listeners.map(async (l) => {
+            try {
+                await l(payload);
+            }
+            catch (e) {
+                errors.push(e);
+            }
+        }));
+        if (errors.length > 0) {
+            throw new AggregateError(errors, `Errors in event "${event}"`);
+        }
+    }
+}
+exports.EventEmitter = EventEmitter;
+//# sourceMappingURL=EventEmitter.js.map

package/dist/cjs/EventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.js","sourceRoot":"","sources":["../../src/EventEmitter.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAY;IACd,SAAS,GAIZ,EAAE,CAAC;IAEH,EAAE,CACR,KAAQ,EACR,QAAqE;QAErE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC5B,CAAC;QACK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAEM,IAAI,CACV,KAAQ,EACR,QAAqE;QAErE,MAAM,OAAO,GAAG,CAAC,OAAiC,EAAE,EAAE;YACrD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACzB,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC,CAAC;QACF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACzB,CAAC;IAEM,GAAG,CACT,KAAQ,EACR,QAAqE;QAErE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YAClB,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5B,CAAC;IACF,CAAC;IAEM,MAAM,CACZ,KAAQ;QAER,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC5B,CAAC;IAES,KAAK,CAAC,IAAI,CACnB,KAAQ,EACR,OAAiC;QAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS,EAAE,MAAM;YAAE,OAAO;QAE/B,MAAM,MAAM,GAAc,EAAE,CAAC;QAE7B,MAAM,OAAO,CAAC,GAAG,CAChB,SAAS,CAAC,GAAG,CAAC,KAAK,EAAC,CAAC,EAAC,EAAE;YACvB,IAAI,CAAC;gBACJ,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,CAAC;QACF,CAAC,CAAC,CACF,CAAC;QAEF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,cAAc,CAAC,MAAM,EAAE,oBAAoB,KAAK,GAAG,CAAC,CAAC;QAChE,CAAC;IACF,CAAC;CACD;AAtED,oCAsEC"}

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;CAqBhB"}

package/dist/cjs/TimersManager/JSONLTimersManager.js

@@ -20,37 +20,35 @@ 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 {
                 const timers = await this.TimersStore.loadTimers();
                 const index = timers?.findIndex(t => t.id === id);
-                if (index === -1) {
+                if (index === -1 || timers[index] === undefined) {
                     throw new Error(`Timer with id ${id} not found`);
                 }
-                timers[index].title = newTitle;
+                const old = { ...timers[index] };
+                timers[index].extra = newExtra;
                 await this.TimersStore.saveTimers(timers);
+                await this.emit("updated", { old, new: timers[index] });
             }
             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

@@ -1 +1 @@
-{"version":3,"file":"JSONLTimersManager.js","sourceRoot":"","sources":["../../../src/TimersManager/JSONLTimersManager.ts"],"names":[],"mappings":";;;AAAA,yDAAmD;AACnD,4EAAsE;AAEtE;;;;;;;;GAQG;AACH,MAAa,kBAAmB,SAAQ,gCAAsB;IAC1C,WAAW,GAA4B,IAAI,CAAC;IAE5C,kBAAkB;QACpC,OAAO,eAAe,CAAC;IACxB,CAAC;IAEkB,KAAK,CAAC,iBAAiB;QACzC,OAAO,IAAI,sCAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,EAAU,EAAE,QAAgB;QACpD,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;IAEM,KAAK,CAAC,iBAAiB,CAAC,EAAU,EAAE,cAAsB;QAChE,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,WAAW,GAAG,cAAc,CAAC;gBAC5C,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAClE,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;CACD;AAhDD,gDAgDC"}
+{"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,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;oBACjD,MAAM,IAAI,KAAK,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;gBAClD,CAAC;gBAED,MAAM,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAEjC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC;gBAC/B,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC1C,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzD,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;AAjDD,gDAiDC"}

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.js

@@ -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.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"}