@windagency/valora 2.0.1

package/dist/ui/tui-adapter.interface.d.ts

@@ -0,0 +1,197 @@
+/**
+ * TUI Adapter Interface
+ *
+ * Library-agnostic terminal UI interface.
+ * Implementations can use Ink, Blessed, React-Blessed, or any other TUI library.
+ *
+ * This separation allows:
+ * - Multiple adapter implementations without coupling
+ * - Easy testing with mock adapters
+ * - Library migration without changing consumer code
+ */
+import type React from 'react';
+/**
+ * Box component props - layout container
+ */
+export interface BoxProps {
+    borderColor?: string;
+    borderStyle?: 'bold' | 'classic' | 'double' | 'doubleSingle' | 'round' | 'single' | 'singleDouble';
+    children?: React.ReactNode;
+    flexDirection?: 'column' | 'column-reverse' | 'row' | 'row-reverse';
+    flexGrow?: number;
+    height?: number | string;
+    marginBottom?: number;
+    marginLeft?: number;
+    marginRight?: number;
+    marginTop?: number;
+    marginX?: number;
+    marginY?: number;
+    padding?: number;
+    paddingBottom?: number;
+    paddingLeft?: number;
+    paddingRight?: number;
+    paddingTop?: number;
+    paddingX?: number;
+    paddingY?: number;
+    width?: number | string;
+}
+/**
+ * Text component props - styled text
+ */
+export interface TextProps {
+    backgroundColor?: string;
+    bold?: boolean;
+    children?: React.ReactNode;
+    color?: string;
+    dimColor?: boolean;
+    italic?: boolean;
+    strikethrough?: boolean;
+    underline?: boolean;
+}
+/**
+ * Newline component props
+ */
+export interface NewlineProps {
+    count?: number;
+}
+/**
+ * Key input from useInput hook
+ */
+export interface Key {
+    backspace?: boolean;
+    ctrl?: boolean;
+    delete?: boolean;
+    downArrow?: boolean;
+    escape?: boolean;
+    leftArrow?: boolean;
+    meta?: boolean;
+    pageDown?: boolean;
+    pageUp?: boolean;
+    return?: boolean;
+    rightArrow?: boolean;
+    shift?: boolean;
+    tab?: boolean;
+    upArrow?: boolean;
+}
+/**
+ * Input handler function type
+ */
+export type InputHandler = (input: string, key: Key) => void;
+/**
+ * App control interface from useApp hook
+ */
+export interface AppControl {
+    exit(error?: Error): void;
+}
+/**
+ * Render result interface
+ */
+export interface RenderResult {
+    clear(): void;
+    rerender(tree: React.ReactElement): void;
+    unmount(): void;
+    waitUntilExit(): Promise<void>;
+}
+/**
+ * TUI Component Adapter
+ *
+ * Provides access to TUI components as React components
+ */
+export interface TUIComponentAdapter {
+    /**
+     * Box component for layout
+     */
+    Box: React.FC<BoxProps>;
+    /**
+     * Text component for styled text
+     */
+    Text: React.FC<TextProps>;
+    /**
+     * Newline component
+     */
+    Newline: React.FC<NewlineProps>;
+}
+/**
+ * TUI Hook Adapter
+ *
+ * Provides access to TUI hooks
+ */
+export interface TUIHookAdapter {
+    /**
+     * Hook for handling keyboard input
+     *
+     * @param handler - Function to handle input
+     * @param options - Optional configuration
+     */
+    useInput(handler: InputHandler, options?: {
+        isActive?: boolean;
+    }): void;
+    /**
+     * Hook for controlling the app
+     *
+     * @returns App control object
+     */
+    useApp(): AppControl;
+}
+/**
+ * TUI Render Adapter
+ *
+ * Provides the render function
+ */
+export interface TUIRenderAdapter {
+    /**
+     * Render a React element to the terminal
+     *
+     * @param element - React element to render
+     * @returns Render result with control functions
+     */
+    render(element: React.ReactElement): RenderResult;
+}
+/**
+ * Complete TUI Adapter Interface
+ *
+ * Combines components, hooks, and render functionality
+ */
+export interface TUIAdapter extends TUIComponentAdapter, TUIHookAdapter, TUIRenderAdapter {
+}
+/**
+ * Get the singleton TUIAdapter instance
+ *
+ * @returns TUIAdapter instance
+ *
+ * @example
+ * import { getTUIAdapter } from './tui-adapter.interface.js';
+ *
+ * const tui = getTUIAdapter();
+ * const { Box, Text } = tui;
+ *
+ * function MyComponent() {
+ *   tui.useInput((input) => {
+ *     if (input === 'q') process.exit(0);
+ *   });
+ *
+ *   return (
+ *     <Box>
+ *       <Text color="cyan">Hello World</Text>
+ *     </Box>
+ *   );
+ * }
+ *
+ * tui.render(<MyComponent />);
+ */
+export declare function getTUIAdapter(): TUIAdapter;
+/**
+ * Set a custom TUIAdapter implementation
+ * Useful for testing or switching to different TUI libraries
+ *
+ * @param adapter - The adapter instance to use
+ *
+ * @example
+ * // In tests
+ * import { setTUIAdapter } from './tui-adapter.interface.js';
+ *
+ * const mockAdapter = new MockTUIAdapter();
+ * setTUIAdapter(mockAdapter);
+ */
+export declare function setTUIAdapter(adapter: TUIAdapter): void;
+//# sourceMappingURL=tui-adapter.interface.d.ts.map

package/dist/ui/tui-adapter.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-adapter.interface.d.ts","sourceRoot":"","sources":["../../src/ui/tui-adapter.interface.ts"],"names":[],"mappings":"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"}

package/dist/ui/tui-adapter.interface.js

@@ -0,0 +1,62 @@
+/**
+ * TUI Adapter Interface
+ *
+ * Library-agnostic terminal UI interface.
+ * Implementations can use Ink, Blessed, React-Blessed, or any other TUI library.
+ *
+ * This separation allows:
+ * - Multiple adapter implementations without coupling
+ * - Easy testing with mock adapters
+ * - Library migration without changing consumer code
+ */
+import { createDefaultTUIAdapter } from './tui-adapter.js';
+/**
+ * Singleton instance
+ */
+let adapterInstance = null;
+/**
+ * Get the singleton TUIAdapter instance
+ *
+ * @returns TUIAdapter instance
+ *
+ * @example
+ * import { getTUIAdapter } from './tui-adapter.interface.js';
+ *
+ * const tui = getTUIAdapter();
+ * const { Box, Text } = tui;
+ *
+ * function MyComponent() {
+ *   tui.useInput((input) => {
+ *     if (input === 'q') process.exit(0);
+ *   });
+ *
+ *   return (
+ *     <Box>
+ *       <Text color="cyan">Hello World</Text>
+ *     </Box>
+ *   );
+ * }
+ *
+ * tui.render(<MyComponent />);
+ */
+export function getTUIAdapter() {
+    adapterInstance ??= createDefaultTUIAdapter();
+    return adapterInstance;
+}
+/**
+ * Set a custom TUIAdapter implementation
+ * Useful for testing or switching to different TUI libraries
+ *
+ * @param adapter - The adapter instance to use
+ *
+ * @example
+ * // In tests
+ * import { setTUIAdapter } from './tui-adapter.interface.js';
+ *
+ * const mockAdapter = new MockTUIAdapter();
+ * setTUIAdapter(mockAdapter);
+ */
+export function setTUIAdapter(adapter) {
+    adapterInstance = adapter;
+}
+//# sourceMappingURL=tui-adapter.interface.js.map

package/dist/ui/tui-adapter.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-adapter.interface.js","sourceRoot":"","sources":["../../src/ui/tui-adapter.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AA6JxD;;GAEG;AACH,IAAI,eAAe,GAAsB,IAAI,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,aAAa;IAC5B,eAAe,KAAK,uBAAuB,EAAE,CAAC;IAC9C,OAAO,eAAgB,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,OAAmB;IAChD,eAAe,GAAG,OAAO,CAAC;AAC3B,CAAC"}

package/dist/ui/tui-adapter.js

@@ -0,0 +1,58 @@
+/**
+ * Ink TUI Adapter - Ink implementation of the TUI adapter
+ *
+ * This is a concrete implementation of TUIAdapter using the Ink library.
+ * The interfaces are defined separately to allow for other implementations (blessed, react-blessed, etc.)
+ *
+ * Benefits:
+ * - Implements library-agnostic TUIAdapter interface
+ * - Can be swapped with other implementations without changing consumers
+ * - Provides the familiar Ink API through the adapter
+ */
+// eslint-disable-next-line import/no-unresolved -- ink is an optional peer dependency for TUI functionality
+import { Box as InkBox, Newline as InkNewline, render as inkRender, Text as InkText, useApp, useInput } from 'ink';
+/**
+ * Ink Adapter Implementation
+ *
+ * Concrete implementation of TUIAdapter using the Ink library.
+ */
+export class InkAdapter {
+    /**
+     * Box component for layout
+     */
+    Box = InkBox;
+    /**
+     * Text component for styled text
+     */
+    Text = InkText;
+    /**
+     * Newline component
+     */
+    Newline = InkNewline;
+    /**
+     * Hook for handling keyboard input
+     */
+    useInput(handler, options) {
+        return useInput(handler, options);
+    }
+    /**
+     * Hook for controlling the app
+     */
+    useApp() {
+        return useApp();
+    }
+    /**
+     * Render a React element to the terminal
+     */
+    render(element) {
+        return inkRender(element);
+    }
+}
+/**
+ * Default adapter instance factory
+ * This is used by the getTUIAdapter function in the interface
+ */
+export function createDefaultTUIAdapter() {
+    return new InkAdapter();
+}
+//# sourceMappingURL=tui-adapter.js.map

package/dist/ui/tui-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-adapter.js","sourceRoot":"","sources":["../../src/ui/tui-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,4GAA4G;AAC5G,OAAO,EAAE,GAAG,IAAI,MAAM,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,IAAI,SAAS,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAYnH;;;;GAIG;AACH,MAAM,OAAO,UAAU;IACtB;;OAEG;IACH,GAAG,GAAuB,MAA4B,CAAC;IAEvD;;OAEG;IACH,IAAI,GAAwB,OAA8B,CAAC;IAE3D;;OAEG;IACH,OAAO,GAA2B,UAAoC,CAAC;IAEvE;;OAEG;IACH,QAAQ,CAAC,OAAqB,EAAE,OAAgC;QAC/D,OAAO,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,MAAM;QACL,OAAO,MAAM,EAAE,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAA2B;QACjC,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACtC,OAAO,IAAI,UAAU,EAAE,CAAC;AACzB,CAAC"}

package/dist/utils/base-cleanup-scheduler.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Base Cleanup Scheduler
+ *
+ * Abstract base class for cleanup schedulers that provides common
+ * lifecycle management (start/stop, schedule updates, timer handling).
+ * Subclasses implement the specific cleanup logic.
+ */
+import { type Logger } from '../output/logger.js';
+/**
+ * Base schedule configuration
+ */
+export interface BaseCleanupSchedule {
+    enabled: boolean;
+    intervalHours: number;
+    startDelayMinutes?: number;
+}
+/**
+ * Abstract base class for cleanup schedulers
+ */
+export declare abstract class BaseCleanupScheduler<TSchedule extends BaseCleanupSchedule, TResult> {
+    protected intervalId?: NodeJS.Timeout;
+    protected isRunning: boolean;
+    protected logger: Logger;
+    protected schedule: TSchedule;
+    protected readonly schedulerName: string;
+    constructor(schedule: TSchedule, schedulerName: string);
+    /**
+     * Start the cleanup scheduler
+     */
+    start(): void;
+    /**
+     * Stop the cleanup scheduler
+     */
+    stop(): void;
+    /**
+     * Update cleanup schedule
+     */
+    updateSchedule(schedule: Partial<TSchedule>): void;
+    /**
+     * Get current cleanup schedule
+     */
+    getSchedule(): TSchedule;
+    /**
+     * Check if scheduler is currently running
+     */
+    isSchedulerRunning(): boolean;
+    /**
+     * Get next scheduled run time
+     */
+    getNextRunTime(): Date | null;
+    /**
+     * Run cleanup - implemented by subclasses for their specific cleanup logic
+     */
+    protected abstract runCleanup(): Promise<void>;
+    /**
+     * Run cleanup immediately (manual trigger)
+     */
+    abstract runNow(): Promise<TResult>;
+}
+//# sourceMappingURL=base-cleanup-scheduler.d.ts.map

package/dist/utils/base-cleanup-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-cleanup-scheduler.d.ts","sourceRoot":"","sources":["../../src/utils/base-cleanup-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,8BAAsB,oBAAoB,CAAC,SAAS,SAAS,mBAAmB,EAAE,OAAO;IACxF,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACtC,SAAS,CAAC,SAAS,UAAS;IAC5B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC9B,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAE7B,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM;IAMtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAoCb;;OAEG;IACH,IAAI,IAAI,IAAI;IAeZ;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;IAiBlD;;OAEG;IACH,WAAW,IAAI,SAAS;IAIxB;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,cAAc,IAAI,IAAI,GAAG,IAAI;IAW7B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE9C;;OAEG;IACH,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;CACnC"}

package/dist/utils/base-cleanup-scheduler.js

@@ -0,0 +1,110 @@
+/**
+ * Base Cleanup Scheduler
+ *
+ * Abstract base class for cleanup schedulers that provides common
+ * lifecycle management (start/stop, schedule updates, timer handling).
+ * Subclasses implement the specific cleanup logic.
+ */
+import { MS_PER_HOUR, MS_PER_MINUTE } from '../config/constants.js';
+import { getLogger } from '../output/logger.js';
+/**
+ * Abstract base class for cleanup schedulers
+ */
+export class BaseCleanupScheduler {
+    intervalId;
+    isRunning = false;
+    logger;
+    schedule;
+    schedulerName;
+    constructor(schedule, schedulerName) {
+        this.schedule = schedule;
+        this.schedulerName = schedulerName;
+        this.logger = getLogger();
+    }
+    /**
+     * Start the cleanup scheduler
+     */
+    start() {
+        if (!this.schedule.enabled) {
+            this.logger.info(`${this.schedulerName} disabled`);
+            return;
+        }
+        if (this.isRunning) {
+            this.logger.warn(`${this.schedulerName} already running`);
+            return;
+        }
+        this.isRunning = true;
+        const intervalMs = this.schedule.intervalHours * MS_PER_HOUR;
+        const startDelayMs = (this.schedule.startDelayMinutes ?? 0) * MS_PER_MINUTE;
+        this.logger.debug(`Starting ${this.schedulerName}`, {
+            intervalHours: this.schedule.intervalHours,
+            startDelayMinutes: this.schedule.startDelayMinutes
+        });
+        // Schedule first run with delay
+        // Use unref() to allow process to exit if this is the only thing keeping it alive
+        setTimeout(() => {
+            void this.runCleanup();
+            // Then schedule recurring runs
+            this.intervalId = setInterval(() => {
+                void this.runCleanup();
+            }, intervalMs);
+            // Allow process to exit if timer is the only thing keeping it alive
+            if (this.intervalId) {
+                this.intervalId.unref();
+            }
+        }, startDelayMs).unref();
+    }
+    /**
+     * Stop the cleanup scheduler
+     */
+    stop() {
+        if (!this.isRunning) {
+            return;
+        }
+        this.isRunning = false;
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = undefined;
+        }
+        this.logger.debug(`${this.schedulerName} stopped`);
+    }
+    /**
+     * Update cleanup schedule
+     */
+    updateSchedule(schedule) {
+        const wasRunning = this.isRunning;
+        if (wasRunning) {
+            this.stop();
+        }
+        this.schedule = { ...this.schedule, ...schedule };
+        if (wasRunning && this.schedule.enabled) {
+            this.start();
+        }
+        this.logger.info(`Updated ${this.schedulerName} schedule`);
+        this.logger.debug('New cleanup schedule', { schedule: this.schedule });
+    }
+    /**
+     * Get current cleanup schedule
+     */
+    getSchedule() {
+        return { ...this.schedule };
+    }
+    /**
+     * Check if scheduler is currently running
+     */
+    isSchedulerRunning() {
+        return this.isRunning;
+    }
+    /**
+     * Get next scheduled run time
+     */
+    getNextRunTime() {
+        if (!this.isRunning || !this.intervalId) {
+            return null;
+        }
+        const now = new Date();
+        const intervalMs = this.schedule.intervalHours * MS_PER_HOUR;
+        return new Date(now.getTime() + intervalMs);
+    }
+}
+//# sourceMappingURL=base-cleanup-scheduler.js.map

package/dist/utils/base-cleanup-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-cleanup-scheduler.js","sourceRoot":"","sources":["../../src/utils/base-cleanup-scheduler.ts"],"names":[],"mappings":"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"}

package/dist/utils/base-retention-manager.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Base Retention Manager
+ *
+ * Abstract base class for retention managers that provides shared logic for:
+ * - Age-based cleanup
+ * - Size-based cleanup
+ * - Count-based cleanup
+ * - File compression
+ * - Policy management
+ *
+ * Concrete implementations extend this for specific file types (logs, sessions, etc.)
+ */
+/**
+ * Base interface for retention policies
+ */
+export interface BaseRetentionPolicy {
+    compressAfterDays?: number;
+    maxAgeDays?: number;
+    maxCount?: number;
+    maxSizeMB?: number;
+}
+/**
+ * Base interface for cleanup results
+ */
+export interface BaseCleanupResult {
+    compressedItems: string[];
+    deletedItems: string[];
+    errors: string[];
+    totalSizeAfter: number;
+    totalSizeBefore: number;
+}
+/**
+ * Base interface for file info
+ */
+export interface BaseFileInfo {
+    filePath: string;
+    isCompressed: boolean;
+    modifiedTime: Date;
+    size: number;
+}
+/**
+ * Logger interface for retention operations
+ */
+export interface RetentionLogger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    error(message: string, error?: Error, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+}
+/**
+ * Abstract base class for retention managers
+ */
+export declare abstract class BaseRetentionManager<TPolicy extends BaseRetentionPolicy, TResult extends BaseCleanupResult, TFileInfo extends BaseFileInfo> {
+    protected dryRun: boolean;
+    protected abstract readonly logger: RetentionLogger;
+    protected policy: TPolicy;
+    constructor(policy: TPolicy, dryRun?: boolean);
+    /**
+     * Get the age of a file item in days.
+     * Subclasses can override this to use custom date fields (e.g., session.updated_at).
+     */
+    protected abstract getItemAgeDays(item: TFileInfo): number;
+    /**
+     * Get a display identifier for the file item (for logging).
+     */
+    protected abstract getItemDisplayId(item: TFileInfo): string;
+    /**
+     * Delete a file item and any associated files (e.g., snapshots).
+     */
+    protected abstract deleteItem(item: TFileInfo): Promise<void>;
+    /**
+     * Record a deletion in the result.
+     */
+    protected abstract recordDeletion(item: TFileInfo, result: TResult): void;
+    /**
+     * Record a compression in the result.
+     */
+    protected abstract recordCompression(item: TFileInfo, result: TResult): void;
+    /**
+     * Compress a file using gzip
+     * Shared implementation for both log and session files
+     */
+    protected compressFile(filePath: string): Promise<void>;
+    /**
+     * Compress a file with optional size logging
+     */
+    protected compressFileWithStats(filePath: string): Promise<{
+        compressionRatio: number;
+        savedBytes: number;
+    }>;
+    /**
+     * Apply age-based cleanup: delete items older than maxAgeDays
+     */
+    protected applyAgePolicy(items: TFileInfo[], result: TResult, getCutoffDate: () => Date): Promise<TFileInfo[]>;
+    /**
+     * Apply size-based cleanup: keep total size under maxSizeMB
+     */
+    protected applySizePolicy(items: TFileInfo[], result: TResult): Promise<TFileInfo[]>;
+    /**
+     * Apply count-based cleanup: keep maximum maxCount items
+     */
+    protected applyCountPolicy(items: TFileInfo[], result: TResult): Promise<TFileInfo[]>;
+    /**
+     * Apply compression policy: compress items older than compressAfterDays
+     */
+    protected applyCompressionPolicy(items: TFileInfo[], result: TResult, getCutoffDate: () => Date): Promise<TFileInfo[]>;
+    /**
+     * Delete items with error handling
+     */
+    protected deleteItemsWithErrorHandling(items: TFileInfo[], result: TResult, reason: string): Promise<void>;
+    /**
+     * Update retention policy
+     */
+    updatePolicy(policy: Partial<TPolicy>): void;
+    /**
+     * Get current retention policy
+     */
+    getPolicy(): TPolicy;
+    /**
+     * Set dry run mode
+     */
+    setDryRun(dryRun: boolean): void;
+    /**
+     * Check if running in dry run mode
+     */
+    isDryRun(): boolean;
+    /**
+     * Calculate cutoff date from days offset
+     */
+    protected calculateCutoffDate(days: number): Date;
+    /**
+     * Calculate total size of items
+     */
+    protected calculateTotalSize(items: TFileInfo[]): number;
+}
+//# sourceMappingURL=base-retention-manager.d.ts.map

package/dist/utils/base-retention-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-retention-manager.d.ts","sourceRoot":"","sources":["../../src/utils/base-retention-manager.ts"],"names":[],"mappings":"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"}