@bereasoftware/time-guard 2.5.3 → 2.6.0

package/dist/types/plugins/duration/index.d.ts

@@ -0,0 +1,107 @@
+import { ITimeGuardPlugin } from '../../types';
+import { TimeGuard } from '../../index';
+import { DurationInput, DurationObject, DurationUnit, IDuration } from './types';
+/**
+ * Duration class - represents time span following ISO 8601 standard
+ */
+export declare class Duration implements IDuration {
+    private years;
+    private months;
+    private weeks;
+    private days;
+    private hours;
+    private minutes;
+    private seconds;
+    private milliseconds;
+    constructor(input: DurationInput);
+    /**
+     * Create Duration from ISO 8601 string
+     * @example Duration.fromISO("P3Y6M4DT12H30M5S")
+     */
+    static fromISO(iso: string): Duration;
+    /**
+     * Create a Duration between this date and another
+     */
+    static between(from: TimeGuard, to: TimeGuard): Duration;
+    /**
+     * Create Duration from milliseconds
+     */
+    static fromMilliseconds(ms: number): Duration;
+    /**
+     * Get duration in specific unit
+     */
+    as(unit: DurationUnit): number;
+    /**
+     * Get duration as milliseconds
+     */
+    asMilliseconds(): number;
+    /**
+     * Get duration as seconds
+     */
+    asSeconds(): number;
+    /**
+     * Get duration as minutes
+     */
+    asMinutes(): number;
+    /**
+     * Get duration as hours
+     */
+    asHours(): number;
+    /**
+     * Get duration as days
+     */
+    asDays(): number;
+    /**
+     * Get duration as weeks
+     */
+    asWeeks(): number;
+    /**
+     * Get duration as months
+     */
+    asMonths(): number;
+    /**
+     * Get duration as years
+     */
+    asYears(): number;
+    /**
+     * Get all components
+     */
+    toObject(): DurationObject;
+    /**
+     * Get ISO 8601 string representation
+     * @example "P3Y6M4DT12H30M5S"
+     */
+    toISO(): string;
+    /**
+     * Get human-readable string
+     */
+    humanize(): string;
+    /**
+     * Check if duration is negative
+     */
+    isNegative(): boolean;
+    /**
+     * Get absolute duration
+     */
+    abs(): Duration;
+    /**
+     * String representation
+     */
+    toString(): string;
+}
+/**
+ * Duration Plugin
+ */
+export declare class DurationPlugin implements ITimeGuardPlugin {
+    name: string;
+    version: string;
+    /**
+     * Install plugin into TimeGuard
+     */
+    install(TimeGuardClass: typeof TimeGuard): void;
+}
+/**
+ * Create and export default instance
+ */
+export declare const durationPlugin: DurationPlugin;
+export default durationPlugin;

package/dist/types/plugins/duration/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Duration Plugin Types
+ */
+export type DurationUnit = 'years' | 'months' | 'weeks' | 'days' | 'hours' | 'minutes' | 'seconds' | 'milliseconds';
+export interface DurationInput {
+    years?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    milliseconds?: number;
+}
+export interface DurationObject {
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}
+/**
+ * Duration class for ISO 8601 durations
+ */
+export interface IDuration {
+    /**
+     * Get duration in specific unit
+     */
+    as(unit: DurationUnit): number;
+    /**
+     * Get duration as milliseconds
+     */
+    asMilliseconds(): number;
+    /**
+     * Get duration as seconds
+     */
+    asSeconds(): number;
+    /**
+     * Get duration as minutes
+     */
+    asMinutes(): number;
+    /**
+     * Get duration as hours
+     */
+    asHours(): number;
+    /**
+     * Get duration as days
+     */
+    asDays(): number;
+    /**
+     * Get duration as weeks
+     */
+    asWeeks(): number;
+    /**
+     * Get duration as months
+     */
+    asMonths(): number;
+    /**
+     * Get duration as years
+     */
+    asYears(): number;
+    /**
+     * Get all components
+     */
+    toObject(): DurationObject;
+    /**
+     * Get ISO 8601 string representation
+     */
+    toISO(): string;
+    /**
+     * Get human-readable string
+     */
+    humanize(): string;
+    /**
+     * Check if duration is negative
+     */
+    isNegative(): boolean;
+    /**
+     * Get absolute duration
+     */
+    abs(): IDuration;
+}

package/dist/types/plugins/duration.d.ts

@@ -1 +1,6 @@
+export * from './duration/index'
+export {}
+import BereasoftTimeGuard from './duration/index'
+export default BereasoftTimeGuard
+export * from './duration/index'
 export {}

package/dist/types/plugins/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * TimeGuard Plugins
+ * Central export point for all plugins
+ */
+export { PluginManager } from './manager';
+export { RelativeTimePlugin, default as relativeTimePlugin } from './relative-time';
+export { DurationPlugin, Duration, default as durationPlugin } from './duration';
+export { AdvancedFormatPlugin, default as advancedFormatPlugin } from './advanced-format';
+export type { RelativeTimeConfig, RelativeTimeFormats, RelativeTimeThreshold } from './relative-time/types';
+export type { IDuration, DurationInput, DurationObject, DurationUnit } from './duration/types';

package/dist/types/plugins/manager.d.ts

@@ -0,0 +1,58 @@
+import { ITimeGuardPlugin } from '../types';
+import { TimeGuard } from '../index';
+/**
+ * Plugin Manager - handles plugin registration and initialization
+ * Uses Singleton pattern to ensure single instance across application
+ */
+export declare class PluginManager {
+    private static instance;
+    private plugins;
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): PluginManager;
+    /**
+     * Register a plugin
+     * @param plugin - The plugin to register
+     * @param timeGuardClass - Reference to TimeGuard class
+     * @param config - Optional plugin configuration
+     */
+    static use(plugin: ITimeGuardPlugin, timeGuardClass: typeof TimeGuard, config?: unknown): void;
+    /**
+     * Register multiple plugins at once
+     * @param plugins - Array of plugins to register
+     * @param timeGuardClass - Reference to TimeGuard class
+     * @param config - Optional plugin configuration
+     */
+    static useMultiple(plugins: ITimeGuardPlugin[], timeGuardClass: typeof TimeGuard, config?: unknown): void;
+    /**
+     * Get registered plugin by name
+     * @param name - Plugin name
+     * @returns Plugin instance or undefined
+     */
+    static getPlugin(name: string): ITimeGuardPlugin | undefined;
+    /**
+     * Check if plugin is registered
+     * @param name - Plugin name
+     * @returns True if plugin is registered
+     */
+    static hasPlugin(name: string): boolean;
+    /**
+     * Get all registered plugins
+     * @returns Array of registered plugin names
+     */
+    static listPlugins(): string[];
+    /**
+     * Unregister a plugin
+     * @param name - Plugin name
+     */
+    static unuse(name: string): boolean;
+    /**
+     * Clear all plugins
+     */
+    static clear(): void;
+    /**
+     * Internal register method
+     */
+    private register;
+}

package/dist/types/plugins/relative-time/index.d.ts

@@ -0,0 +1,39 @@
+import { ITimeGuardPlugin } from '../../types';
+import { TimeGuard } from '../../index';
+import { RelativeTimeConfig, RelativeTimeFormats } from './types';
+export declare class RelativeTimePlugin implements ITimeGuardPlugin {
+    name: string;
+    version: string;
+    private config;
+    private formats;
+    constructor(config?: RelativeTimeConfig);
+    /**
+     * Install plugin into TimeGuard
+     */
+    install(TimeGuardClass: typeof TimeGuard): void;
+    /**
+     * Format relative time
+     */
+    private formatRelativeTime;
+    /**
+     * Get relative time string based on milliseconds
+     */
+    private getRelativeTimeString;
+    /**
+     * Get milliseconds per unit
+     */
+    private getUnitMilliseconds;
+    /**
+     * Set format strings
+     */
+    setFormats(formats: Partial<RelativeTimeFormats>): void;
+    /**
+     * Get current formats
+     */
+    getFormats(): RelativeTimeFormats;
+}
+/**
+ * Create and export default instance
+ */
+declare const _default: RelativeTimePlugin;
+export default _default;

package/dist/types/plugins/relative-time/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * RelativeTime Plugin Types
+ */
+export interface RelativeTimeConfig {
+    thresholds?: RelativeTimeThreshold[];
+    rounding?: (value: number) => number;
+}
+export interface RelativeTimeThreshold {
+    l: string;
+    r?: number;
+    d?: string;
+}
+export interface RelativeTimeFormats {
+    future: string;
+    past: string;
+    s: string;
+    m: string;
+    mm: string;
+    h: string;
+    hh: string;
+    d: string;
+    dd: string;
+    M: string;
+    MM: string;
+    y: string;
+    yy: string;
+}

package/dist/types/plugins/relative-time.d.ts

@@ -1 +1,6 @@
+export * from './relative-time/index'
+export {}
+import BereasoftTimeGuard from './relative-time/index'
+export default BereasoftTimeGuard
+export * from './relative-time/index'
 export {}