@zeitar/throttle 1.0.0

package/dist/storage/InMemoryStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryStorage.d.ts","sourceRoot":"","sources":["../../src/storage/InMemoryStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAO3D;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD;;;;OAIG;IACG,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAgB9D;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;CAGf"}

package/dist/storage/InMemoryStorage.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryStorage = void 0;
+/**
+ * In-memory storage implementation for rate limiter state.
+ *
+ * This storage is non-persistent and will be lost when the process restarts.
+ * Suitable for single-instance applications or testing.
+ */
+class InMemoryStorage {
+    constructor() {
+        this.storage = new Map();
+    }
+    /**
+     * Save a state object to memory.
+     */
+    async save(state) {
+        const expirationTime = state.getExpirationTime();
+        const expiresAt = expirationTime ? expirationTime * 1000 : null; // Convert to ms
+        this.storage.set(state.getId(), {
+            expiresAt,
+            state,
+        });
+    }
+    /**
+     * Fetch a state object from memory.
+     *
+     * Automatically cleans up expired entries.
+     */
+    async fetch(id) {
+        const entry = this.storage.get(id);
+        if (!entry) {
+            return null;
+        }
+        // Check expiration
+        if (entry.expiresAt !== null && Date.now() >= entry.expiresAt) {
+            this.storage.delete(id);
+            return null;
+        }
+        return entry.state;
+    }
+    /**
+     * Delete a state object from memory.
+     */
+    async delete(id) {
+        this.storage.delete(id);
+    }
+    /**
+     * Clear all stored state (useful for testing).
+     */
+    clear() {
+        this.storage.clear();
+    }
+    /**
+     * Get the number of stored entries (useful for testing).
+     */
+    size() {
+        return this.storage.size;
+    }
+}
+exports.InMemoryStorage = InMemoryStorage;
+//# sourceMappingURL=InMemoryStorage.js.map

package/dist/storage/InMemoryStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryStorage.js","sourceRoot":"","sources":["../../src/storage/InMemoryStorage.ts"],"names":[],"mappings":";;;AAQA;;;;;GAKG;AACH,MAAa,eAAe;IAA5B;QACmB,YAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAwD7D,CAAC;IAtDC;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,KAA4B;QACrC,MAAM,cAAc,GAAG,KAAK,CAAC,iBAAiB,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,gBAAgB;QAEjF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE;YAC9B,SAAS;YACT,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,EAAU;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,mBAAmB;QACnB,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAC9D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF;AAzDD,0CAyDC"}

package/dist/storage/LockInterface.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Interface for distributed locking mechanism.
+ *
+ * Used to ensure atomic operations on rate limiter state in distributed environments.
+ */
+export interface LockInterface {
+    /**
+     * Acquire a lock for the given resource.
+     *
+     * @param key - The resource identifier to lock
+     * @param ttl - Time-to-live for the lock in seconds (optional)
+     * @returns True if lock was acquired, false otherwise
+     */
+    acquire(key: string, ttl?: number): Promise<boolean>;
+    /**
+     * Release a lock for the given resource.
+     *
+     * @param key - The resource identifier to unlock
+     */
+    release(key: string): Promise<void>;
+    /**
+     * Execute a callback while holding a lock.
+     *
+     * Automatically acquires and releases the lock.
+     *
+     * @param key - The resource identifier to lock
+     * @param callback - Function to execute while holding the lock
+     * @param ttl - Time-to-live for the lock in seconds (optional)
+     * @returns The result of the callback
+     */
+    withLock<T>(key: string, callback: () => Promise<T>, ttl?: number): Promise<T>;
+}
+/**
+ * Simple no-op lock implementation for single-instance applications.
+ */
+export declare class NoLock implements LockInterface {
+    acquire(): Promise<boolean>;
+    release(): Promise<void>;
+    withLock<T>(_key: string, callback: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=LockInterface.d.ts.map

package/dist/storage/LockInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LockInterface.d.ts","sourceRoot":"","sources":["../../src/storage/LockInterface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;;;;;;;OASG;IACH,QAAQ,CAAC,CAAC,EACR,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC1B,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,MAAO,YAAW,aAAa;IACpC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,QAAQ,CAAC,CAAC,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,CAAC;CAGd"}

package/dist/storage/LockInterface.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoLock = void 0;
+/**
+ * Simple no-op lock implementation for single-instance applications.
+ */
+class NoLock {
+    async acquire() {
+        return true;
+    }
+    async release() {
+        // No-op
+    }
+    async withLock(_key, callback) {
+        return callback();
+    }
+}
+exports.NoLock = NoLock;
+//# sourceMappingURL=LockInterface.js.map

package/dist/storage/LockInterface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LockInterface.js","sourceRoot":"","sources":["../../src/storage/LockInterface.ts"],"names":[],"mappings":";;;AAuCA;;GAEG;AACH,MAAa,MAAM;IACjB,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO;QACX,QAAQ;IACV,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,QAA0B;QAE1B,OAAO,QAAQ,EAAE,CAAC;IACpB,CAAC;CACF;AAfD,wBAeC"}

package/dist/storage/StorageInterface.d.ts

@@ -0,0 +1,29 @@
+import type { LimiterStateInterface } from '../LimiterStateInterface';
+/**
+ * Interface for persisting rate limiter state.
+ *
+ * Implementations can use in-memory storage, Redis, file system, or any other
+ * persistence mechanism.
+ */
+export interface StorageInterface {
+    /**
+     * Save a state object.
+     *
+     * @param state - The state object to save
+     */
+    save(state: LimiterStateInterface): Promise<void>;
+    /**
+     * Fetch a state object by ID.
+     *
+     * @param id - The unique identifier for the state
+     * @returns The state object, or null if not found or expired
+     */
+    fetch(id: string): Promise<LimiterStateInterface | null>;
+    /**
+     * Delete a state object by ID.
+     *
+     * @param id - The unique identifier for the state
+     */
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=StorageInterface.d.ts.map

package/dist/storage/StorageInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageInterface.d.ts","sourceRoot":"","sources":["../../src/storage/StorageInterface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;;;;OAKG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IAEzD;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}

package/dist/storage/StorageInterface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=StorageInterface.js.map

package/dist/storage/StorageInterface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageInterface.js","sourceRoot":"","sources":["../../src/storage/StorageInterface.ts"],"names":[],"mappings":""}

package/dist/storage/__tests__/InMemoryStorage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=InMemoryStorage.test.d.ts.map

package/dist/storage/__tests__/InMemoryStorage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryStorage.test.d.ts","sourceRoot":"","sources":["../../../src/storage/__tests__/InMemoryStorage.test.ts"],"names":[],"mappings":""}

package/dist/storage/__tests__/InMemoryStorage.test.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const InMemoryStorage_1 = require("../InMemoryStorage");
+const TokenBucket_1 = require("../../policy/TokenBucket");
+const Rate_1 = require("../../policy/Rate");
+describe('InMemoryStorage', () => {
+    let storage;
+    let bucket;
+    beforeEach(() => {
+        storage = new InMemoryStorage_1.InMemoryStorage();
+        bucket = new TokenBucket_1.TokenBucket('test-bucket', 10, Rate_1.Rate.perSecond(1));
+    });
+    describe('save and fetch', () => {
+        it('should save and fetch a state object', async () => {
+            await storage.save(bucket);
+            const fetched = await storage.fetch('test-bucket');
+            expect(fetched).toBe(bucket);
+            expect(fetched?.getId()).toBe('test-bucket');
+        });
+        it('should return null for non-existent id', async () => {
+            const fetched = await storage.fetch('non-existent');
+            expect(fetched).toBeNull();
+        });
+        it('should overwrite existing state with same id', async () => {
+            const bucket1 = new TokenBucket_1.TokenBucket('test-id', 10, Rate_1.Rate.perSecond(1), 5);
+            const bucket2 = new TokenBucket_1.TokenBucket('test-id', 20, Rate_1.Rate.perSecond(2), 10);
+            await storage.save(bucket1);
+            await storage.save(bucket2);
+            const fetched = await storage.fetch('test-id');
+            expect(fetched).toBe(bucket2);
+            expect(fetched.getBurstSize()).toBe(20);
+        });
+        it('should handle multiple different states', async () => {
+            const bucket1 = new TokenBucket_1.TokenBucket('bucket-1', 10, Rate_1.Rate.perSecond(1));
+            const bucket2 = new TokenBucket_1.TokenBucket('bucket-2', 20, Rate_1.Rate.perSecond(2));
+            const bucket3 = new TokenBucket_1.TokenBucket('bucket-3', 30, Rate_1.Rate.perSecond(3));
+            await storage.save(bucket1);
+            await storage.save(bucket2);
+            await storage.save(bucket3);
+            expect(await storage.fetch('bucket-1')).toBe(bucket1);
+            expect(await storage.fetch('bucket-2')).toBe(bucket2);
+            expect(await storage.fetch('bucket-3')).toBe(bucket3);
+        });
+    });
+    describe('delete', () => {
+        it('should delete a state object', async () => {
+            await storage.save(bucket);
+            await storage.delete('test-bucket');
+            const fetched = await storage.fetch('test-bucket');
+            expect(fetched).toBeNull();
+        });
+        it('should not throw when deleting non-existent id', async () => {
+            await expect(storage.delete('non-existent')).resolves.not.toThrow();
+        });
+        it('should only delete the specified id', async () => {
+            const bucket1 = new TokenBucket_1.TokenBucket('bucket-1', 10, Rate_1.Rate.perSecond(1));
+            const bucket2 = new TokenBucket_1.TokenBucket('bucket-2', 20, Rate_1.Rate.perSecond(2));
+            await storage.save(bucket1);
+            await storage.save(bucket2);
+            await storage.delete('bucket-1');
+            expect(await storage.fetch('bucket-1')).toBeNull();
+            expect(await storage.fetch('bucket-2')).toBe(bucket2);
+        });
+    });
+    describe('expiration', () => {
+        it('should return null for expired entries', async () => {
+            jest.useFakeTimers();
+            const now = Date.now();
+            jest.setSystemTime(now);
+            // Create a bucket that will expire in 10 seconds
+            const expirableBucket = new TokenBucket_1.TokenBucket('expirable', 10, Rate_1.Rate.perSecond(1), 0, now / 1000);
+            await storage.save(expirableBucket);
+            // Should exist before expiration
+            expect(await storage.fetch('expirable')).toBe(expirableBucket);
+            // Advance time past expiration (bucket expires after it can fully refill)
+            const expirationMs = expirableBucket.getExpirationTime() * 1000;
+            jest.setSystemTime(expirationMs + 1000);
+            // Should return null after expiration
+            expect(await storage.fetch('expirable')).toBeNull();
+            jest.useRealTimers();
+        });
+        it('should automatically clean up expired entries on fetch', async () => {
+            jest.useFakeTimers();
+            const now = Date.now();
+            jest.setSystemTime(now);
+            const expirableBucket = new TokenBucket_1.TokenBucket('expirable', 10, Rate_1.Rate.perSecond(1), 0, now / 1000);
+            await storage.save(expirableBucket);
+            expect(storage.size()).toBe(1);
+            // Advance time past expiration
+            const expirationMs = expirableBucket.getExpirationTime() * 1000;
+            jest.setSystemTime(expirationMs + 1000);
+            // Fetch should clean up the expired entry
+            await storage.fetch('expirable');
+            expect(storage.size()).toBe(0);
+            jest.useRealTimers();
+        });
+        it('should handle entries with no expiration (null)', async () => {
+            // Create a mock state with no expiration
+            const noExpirationState = {
+                getId: () => 'no-expiration',
+                getExpirationTime: () => null,
+            };
+            await storage.save(noExpirationState);
+            // Should always be fetchable
+            expect(await storage.fetch('no-expiration')).toBe(noExpirationState);
+        });
+    });
+    describe('clear', () => {
+        it('should clear all stored states', async () => {
+            const bucket1 = new TokenBucket_1.TokenBucket('bucket-1', 10, Rate_1.Rate.perSecond(1));
+            const bucket2 = new TokenBucket_1.TokenBucket('bucket-2', 20, Rate_1.Rate.perSecond(2));
+            await storage.save(bucket1);
+            await storage.save(bucket2);
+            storage.clear();
+            expect(await storage.fetch('bucket-1')).toBeNull();
+            expect(await storage.fetch('bucket-2')).toBeNull();
+            expect(storage.size()).toBe(0);
+        });
+        it('should handle clearing empty storage', () => {
+            expect(() => storage.clear()).not.toThrow();
+            expect(storage.size()).toBe(0);
+        });
+    });
+    describe('size', () => {
+        it('should return 0 for empty storage', () => {
+            expect(storage.size()).toBe(0);
+        });
+        it('should return correct size after adding entries', async () => {
+            expect(storage.size()).toBe(0);
+            await storage.save(new TokenBucket_1.TokenBucket('bucket-1', 10, Rate_1.Rate.perSecond(1)));
+            expect(storage.size()).toBe(1);
+            await storage.save(new TokenBucket_1.TokenBucket('bucket-2', 20, Rate_1.Rate.perSecond(2)));
+            expect(storage.size()).toBe(2);
+            await storage.save(new TokenBucket_1.TokenBucket('bucket-3', 30, Rate_1.Rate.perSecond(3)));
+            expect(storage.size()).toBe(3);
+        });
+        it('should return correct size after deleting entries', async () => {
+            await storage.save(new TokenBucket_1.TokenBucket('bucket-1', 10, Rate_1.Rate.perSecond(1)));
+            await storage.save(new TokenBucket_1.TokenBucket('bucket-2', 20, Rate_1.Rate.perSecond(2)));
+            expect(storage.size()).toBe(2);
+            await storage.delete('bucket-1');
+            expect(storage.size()).toBe(1);
+            await storage.delete('bucket-2');
+            expect(storage.size()).toBe(0);
+        });
+        it('should not change size when saving same id', async () => {
+            await storage.save(new TokenBucket_1.TokenBucket('bucket-1', 10, Rate_1.Rate.perSecond(1)));
+            expect(storage.size()).toBe(1);
+            await storage.save(new TokenBucket_1.TokenBucket('bucket-1', 20, Rate_1.Rate.perSecond(2)));
+            expect(storage.size()).toBe(1);
+        });
+    });
+});
+//# sourceMappingURL=InMemoryStorage.test.js.map

package/dist/storage/__tests__/InMemoryStorage.test.js.map

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

package/dist/util/TimeUtil.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Utility functions for time calculations.
+ */
+export declare class TimeUtil {
+    /**
+     * Convert a duration string to seconds.
+     *
+     * Supports formats like:
+     * - "1 second", "2 seconds", "1s"
+     * - "1 minute", "2 minutes", "1m"
+     * - "1 hour", "2 hours", "1h"
+     * - "1 day", "2 days", "1d"
+     * - "1 week", "2 weeks", "1w"
+     * - "1 month", "2 months" (assumes 30 days)
+     * - "1 year", "2 years" (assumes 365 days)
+     *
+     * @param duration - Duration string to parse
+     * @returns Duration in seconds
+     * @throws {Error} If the duration format is invalid
+     */
+    static durationToSeconds(duration: string): number;
+    /**
+     * Get the current time in seconds (with millisecond precision).
+     */
+    static now(): number;
+    /**
+     * Convert milliseconds to seconds.
+     */
+    static msToSeconds(ms: number): number;
+    /**
+     * Convert seconds to milliseconds.
+     */
+    static secondsToMs(seconds: number): number;
+}
+//# sourceMappingURL=TimeUtil.d.ts.map

package/dist/util/TimeUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeUtil.d.ts","sourceRoot":"","sources":["../../src/util/TimeUtil.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAQ;IACnB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAkDlD;;OAEG;IACH,MAAM,CAAC,GAAG,IAAI,MAAM;IAIpB;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAItC;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAG5C"}

package/dist/util/TimeUtil.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeUtil = void 0;
+/**
+ * Utility functions for time calculations.
+ */
+class TimeUtil {
+    /**
+     * Convert a duration string to seconds.
+     *
+     * Supports formats like:
+     * - "1 second", "2 seconds", "1s"
+     * - "1 minute", "2 minutes", "1m"
+     * - "1 hour", "2 hours", "1h"
+     * - "1 day", "2 days", "1d"
+     * - "1 week", "2 weeks", "1w"
+     * - "1 month", "2 months" (assumes 30 days)
+     * - "1 year", "2 years" (assumes 365 days)
+     *
+     * @param duration - Duration string to parse
+     * @returns Duration in seconds
+     * @throws {Error} If the duration format is invalid
+     */
+    static durationToSeconds(duration) {
+        const trimmed = duration.trim().toLowerCase();
+        const match = trimmed.match(/^(\d+)\s*(.+)$/);
+        if (!match) {
+            throw new Error(`Invalid duration format: ${duration}`);
+        }
+        const [, amountStr, unit] = match;
+        const amount = parseInt(amountStr, 10);
+        if (isNaN(amount) || amount < 0) {
+            throw new Error(`Invalid amount in duration: ${duration}`);
+        }
+        // Map unit to seconds
+        const unitMap = {
+            s: 1,
+            sec: 1,
+            second: 1,
+            seconds: 1,
+            m: 60,
+            min: 60,
+            minute: 60,
+            minutes: 60,
+            h: 3600,
+            hr: 3600,
+            hour: 3600,
+            hours: 3600,
+            d: 86400,
+            day: 86400,
+            days: 86400,
+            w: 604800,
+            week: 604800,
+            weeks: 604800,
+            month: 2592000, // 30 days
+            months: 2592000,
+            y: 31536000, // 365 days
+            year: 31536000,
+            years: 31536000,
+        };
+        const multiplier = unitMap[unit];
+        if (multiplier === undefined) {
+            throw new Error(`Unknown time unit: ${unit}`);
+        }
+        return amount * multiplier;
+    }
+    /**
+     * Get the current time in seconds (with millisecond precision).
+     */
+    static now() {
+        return Date.now() / 1000;
+    }
+    /**
+     * Convert milliseconds to seconds.
+     */
+    static msToSeconds(ms) {
+        return ms / 1000;
+    }
+    /**
+     * Convert seconds to milliseconds.
+     */
+    static secondsToMs(seconds) {
+        return seconds * 1000;
+    }
+}
+exports.TimeUtil = TimeUtil;
+//# sourceMappingURL=TimeUtil.js.map

package/dist/util/TimeUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeUtil.js","sourceRoot":"","sources":["../../src/util/TimeUtil.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,QAAQ;IACnB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAgB;QACvC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAE9C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;QAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAEvC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,sBAAsB;QACtB,MAAM,OAAO,GAA2B;YACtC,CAAC,EAAE,CAAC;YACJ,GAAG,EAAE,CAAC;YACN,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;YACV,CAAC,EAAE,EAAE;YACL,GAAG,EAAE,EAAE;YACP,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;YACX,CAAC,EAAE,IAAI;YACP,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,IAAI;YACX,CAAC,EAAE,KAAK;YACR,GAAG,EAAE,KAAK;YACV,IAAI,EAAE,KAAK;YACX,CAAC,EAAE,MAAM;YACT,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,OAAO,EAAE,UAAU;YAC1B,MAAM,EAAE,OAAO;YACf,CAAC,EAAE,QAAQ,EAAE,WAAW;YACxB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,QAAQ;SAChB,CAAC;QAEF,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,MAAM,GAAG,UAAU,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG;QACR,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,EAAU;QAC3B,OAAO,EAAE,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAe;QAChC,OAAO,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;CACF;AAvFD,4BAuFC"}

package/dist/util/__tests__/TimeUtil.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TimeUtil.test.d.ts.map

package/dist/util/__tests__/TimeUtil.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeUtil.test.d.ts","sourceRoot":"","sources":["../../../src/util/__tests__/TimeUtil.test.ts"],"names":[],"mappings":""}

package/dist/util/__tests__/TimeUtil.test.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const TimeUtil_1 = require("../TimeUtil");
+describe('TimeUtil', () => {
+    describe('durationToSeconds', () => {
+        it('should convert seconds correctly', () => {
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('1 second')).toBe(1);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('2 seconds')).toBe(2);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('5 s')).toBe(5);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('10s')).toBe(10);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('3 sec')).toBe(3);
+        });
+        it('should convert minutes correctly', () => {
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('1 minute')).toBe(60);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('2 minutes')).toBe(120);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('5 m')).toBe(300);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('10m')).toBe(600);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('3 min')).toBe(180);
+        });
+        it('should convert hours correctly', () => {
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('1 hour')).toBe(3600);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('2 hours')).toBe(7200);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('5 h')).toBe(18000);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('10h')).toBe(36000);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('3 hr')).toBe(10800);
+        });
+        it('should convert days correctly', () => {
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('1 day')).toBe(86400);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('2 days')).toBe(172800);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('7 d')).toBe(604800);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('10d')).toBe(864000);
+        });
+        it('should convert weeks correctly', () => {
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('1 week')).toBe(604800);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('2 weeks')).toBe(1209600);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('3 w')).toBe(1814400);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('4w')).toBe(2419200);
+        });
+        it('should convert months correctly (30 days)', () => {
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('1 month')).toBe(2592000);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('2 months')).toBe(5184000);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('3 month')).toBe(7776000);
+        });
+        it('should convert years correctly (365 days)', () => {
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('1 year')).toBe(31536000);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('2 years')).toBe(63072000);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('1 y')).toBe(31536000);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('3y')).toBe(94608000);
+        });
+        it('should handle whitespace variations', () => {
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('  5   seconds  ')).toBe(5);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('10m')).toBe(600);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('1    hour')).toBe(3600);
+        });
+        it('should be case insensitive', () => {
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('5 SECONDS')).toBe(5);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('10 Minutes')).toBe(600);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('1 HOUR')).toBe(3600);
+        });
+        it('should throw error for invalid format', () => {
+            expect(() => TimeUtil_1.TimeUtil.durationToSeconds('invalid')).toThrow('Invalid duration format');
+            expect(() => TimeUtil_1.TimeUtil.durationToSeconds('abc seconds')).toThrow();
+            expect(() => TimeUtil_1.TimeUtil.durationToSeconds('')).toThrow();
+        });
+        it('should throw error for negative amounts', () => {
+            expect(() => TimeUtil_1.TimeUtil.durationToSeconds('-5 seconds')).toThrow('Invalid duration format');
+        });
+        it('should throw error for unknown units', () => {
+            expect(() => TimeUtil_1.TimeUtil.durationToSeconds('5 fortnights')).toThrow('Unknown time unit');
+            expect(() => TimeUtil_1.TimeUtil.durationToSeconds('10 xyz')).toThrow('Unknown time unit');
+        });
+        it('should handle zero values', () => {
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('0 seconds')).toBe(0);
+            expect(TimeUtil_1.TimeUtil.durationToSeconds('0 minutes')).toBe(0);
+        });
+    });
+    describe('now', () => {
+        it('should return current time in seconds', () => {
+            const before = Date.now() / 1000;
+            const now = TimeUtil_1.TimeUtil.now();
+            const after = Date.now() / 1000;
+            expect(now).toBeGreaterThanOrEqual(before);
+            expect(now).toBeLessThanOrEqual(after);
+        });
+        it('should return a number', () => {
+            expect(typeof TimeUtil_1.TimeUtil.now()).toBe('number');
+        });
+        it('should have decimal precision (milliseconds)', () => {
+            const now = TimeUtil_1.TimeUtil.now();
+            expect(now % 1).not.toBe(0);
+        });
+    });
+    describe('msToSeconds', () => {
+        it('should convert milliseconds to seconds', () => {
+            expect(TimeUtil_1.TimeUtil.msToSeconds(1000)).toBe(1);
+            expect(TimeUtil_1.TimeUtil.msToSeconds(5000)).toBe(5);
+            expect(TimeUtil_1.TimeUtil.msToSeconds(60000)).toBe(60);
+        });
+        it('should handle fractional seconds', () => {
+            expect(TimeUtil_1.TimeUtil.msToSeconds(500)).toBe(0.5);
+            expect(TimeUtil_1.TimeUtil.msToSeconds(1500)).toBe(1.5);
+            expect(TimeUtil_1.TimeUtil.msToSeconds(100)).toBe(0.1);
+        });
+        it('should handle zero', () => {
+            expect(TimeUtil_1.TimeUtil.msToSeconds(0)).toBe(0);
+        });
+    });
+    describe('secondsToMs', () => {
+        it('should convert seconds to milliseconds', () => {
+            expect(TimeUtil_1.TimeUtil.secondsToMs(1)).toBe(1000);
+            expect(TimeUtil_1.TimeUtil.secondsToMs(5)).toBe(5000);
+            expect(TimeUtil_1.TimeUtil.secondsToMs(60)).toBe(60000);
+        });
+        it('should handle fractional seconds', () => {
+            expect(TimeUtil_1.TimeUtil.secondsToMs(0.5)).toBe(500);
+            expect(TimeUtil_1.TimeUtil.secondsToMs(1.5)).toBe(1500);
+            expect(TimeUtil_1.TimeUtil.secondsToMs(0.1)).toBe(100);
+        });
+        it('should handle zero', () => {
+            expect(TimeUtil_1.TimeUtil.secondsToMs(0)).toBe(0);
+        });
+    });
+    describe('round-trip conversions', () => {
+        it('should convert back and forth without loss', () => {
+            const ms = 5432;
+            expect(TimeUtil_1.TimeUtil.secondsToMs(TimeUtil_1.TimeUtil.msToSeconds(ms))).toBe(ms);
+            const seconds = 10.5;
+            expect(TimeUtil_1.TimeUtil.msToSeconds(TimeUtil_1.TimeUtil.secondsToMs(seconds))).toBe(seconds);
+        });
+    });
+});
+//# sourceMappingURL=TimeUtil.test.js.map