track 0.0.7

track: ^0.0.7 copied to clipboard

• Added RolloverCounter - a persistent counter designed to automatically reset after a specified duration from the last update. This is particularly useful for tracking rolling activity windows, such as "submissions per hour" or "attempts every 10 minutes".

• Added PeriodicCounter - A persistent counter that automatically resets at the start of each aligned time period designed to track integer counters that reset periodically based on a specified TrackerPeriod.

• Added ActivityCounter - A utility class for tracking user activity over time across various spans such as hour, day, month, and year. It provides persistent storage and retrieval of activity data, making it suitable for usage statistics, trend analysis, and generating long-term activity reports.
• Added .historyTracker extension for building a persisted history tracker from any adapter

    final history = adapter.historyTracker(
     'my_history',
     maxLength: 100,
     deduplicate: true,
   );

• Added HistoryTracker - A persisted, FIFO history tracker

• Added tests for all core components to ensure reliability and correctness.

• Imported BaseCounterTracker - An abstract class for tracking integer counters with expiration logic. It extends the BaseTracker to specifically handle integer counters. It provides methods to increment the counter, check if the counter is non-zero, and reset the counter value while maintaining the last update timestamp.

• Added TrackerPeriod - Represents different time periods for tracking purposes.
• Added BaseTracker - An abstract base class for tracking values with expiration logic.
• Added testing tools and utilities

Notes: Originally was part of the prf package. Extracted into a standalone package for modularity, lighter dependencies, and focused use. Ideal for apps needing easy-to-integrate time-based limits without extra logic.