TimeTide

Master the flow of time with the ultimate solution for precision scheduling, real-time synchronization, and temporal control. Designed for developers who demand flexibility and power, this system blends intuitive time parsing, dynamic countdowns, and persistent task handling into a seamless toolkit. Schedule events using human-readable commands, manage intervals and expiration with clarity, and broadcast real-time updates to dashboards or distributed systems. Whether you build responsive interfaces, backend automation, or temporal workflows, this API equips you to orchestrate time itself—with legendary elegance and unmatched control.

Features

⏱️ Human-readable scheduling (e.g. "in 5 minutes", "next Monday")
🧠 Persistent named tasks across restarts
🔁 Repeating tasks and tick events
🎯 Countdown timers and expiration checks
⚙️ Real-time dashboard synchronization with tick and update events
🔌 Easily configurable with initializeTimers()

Installation

npm install @trap_stevo/timetide

Quick Start

const TimeTide, { parseDate, toMilliseconds } = require("@trap_stevo/timetide");

TimeTide.initializeTimers({
     persistPath: "./.timers.json",
     disablePersistence: false
});

TimeTide.schedule("backupJob", "10s", () => {
     console.log("Backup job executed");
});

TimeTide.then("backupJob", () => {
     console.log("Backup follow-up task");
});

Utility Methods

parseDate("next Monday");  // returns ~ Date object
parseDate("in 3 days");    // returns ~ Date object

parseDuration("2h 30m");   // returns ~ Milliseconds

toMilliseconds("10s");     // returns ~ 10000

toReadable(9123456);       // returns ~ "2h 32m 3s 456ms"

Named Tasks

TimeTide.pause("backupJob");
TimeTide.resume("backupJob");
TimeTide.extend("backupJob", "2m");
TimeTide.reduce("backupJob", "30s");

Tick Events

TimeTide.startTick("1s");

TimeTide.events.on("tick:1s", () => {
     console.log("Tick every second");
});

Get All Active Timers

const timers = TimeTide.getTimers();
console.log(timers);

Configuration

TimeTide.initializeTimers({
     persistPath: "./my-timers.json",
     disablePersistence: false
});

License

See license in LICENSE.md

Package detail

@trap_stevo/timetide

readme