import type { UsageAmount, UsageStatus } from "../usage.js";
/** Milliseconds in one hour. */
export declare const HOUR_MS: number;
/** Milliseconds in one day. */
export declare const DAY_MS: number;
/** Milliseconds in one seven-day week. */
export declare const WEEK_MS: number;
/** Parses a finite positive epoch timestamp, tolerating seconds or milliseconds. */
export declare function parsePositiveTimestamp(value: unknown): number | undefined;
/** Parses an ISO timestamp into epoch milliseconds. */
export declare function parseIsoTimestamp(value: unknown): number | undefined;
/** Maps a used fraction to the standard quota status thresholds. */
export declare function usageStatus(usedFraction: number | undefined): UsageStatus;
/**
 * Builds an amount from absolute counters. Without an authoritative
 * `usedFraction`, it derives one from `used / limit` (capped at 1).
 * Undefined fields are omitted rather than emitted as `undefined` keys.
 */
export declare function buildUsageAmount(args: {
    used: number | undefined;
    limit: number | undefined;
    remaining: number | undefined;
    usedFraction?: number;
    unit: UsageAmount["unit"];
}): UsageAmount;