@seontechnologies/playwright-utils 3.10.0

package/dist/types/auth-session/internal/cache-manager.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Advanced cache manager for auth session tokens
+ * Provides LRU eviction, memory pressure monitoring, and performance metrics
+ */
+/** Cache configuration options */
+export interface CacheConfig {
+    /** Maximum number of entries in cache (default: 50) */
+    maxSize?: number;
+    /** Default cache duration in milliseconds (default: 15 minutes) */
+    defaultTtlMs?: number;
+    /** Enable automatic cleanup on memory pressure (default: true) */
+    enableMemoryPressureCleanup?: boolean;
+    /** Cleanup interval in milliseconds (default: 5 minutes) */
+    cleanupIntervalMs?: number;
+    /** Enable performance metrics collection (default: false) */
+    enableMetrics?: boolean;
+}
+/** Cache performance metrics */
+export interface CacheMetrics {
+    hits: number;
+    misses: number;
+    evictions: number;
+    cleanups: number;
+    totalEntries: number;
+    hitRate: number;
+}
+/**
+ * Advanced token cache manager with LRU eviction and memory management
+ */
+export declare class TokenCacheManager {
+    private readonly config;
+    private readonly cache;
+    private readonly metrics;
+    private cleanupTimer?;
+    constructor(config?: CacheConfig);
+    /**
+     * Get a token from cache if it exists and is not expired
+     * @param key Cache key (typically file path)
+     * @returns Token string or null if not found/expired
+     */
+    get(key: string): string | null;
+    /**
+     * Store a token in cache with optional TTL
+     * @param key Cache key (typically file path)
+     * @param token Token string to cache
+     * @param ttlMs Optional time-to-live in milliseconds
+     */
+    set(key: string, token: string, ttlMs?: number): void;
+    /**
+     * Remove a specific entry from cache
+     * @param key Cache key to remove
+     * @returns Whether the key was found and removed
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all entries from cache
+     */
+    clear(): void;
+    /**
+     * Get current cache metrics
+     * @returns Cache performance metrics
+     */
+    getMetrics(): CacheMetrics;
+    /**
+     * Get cache status information
+     */
+    getStatus(): {
+        size: number;
+        maxSize: number;
+        utilizationPercent: number;
+        oldestEntryAge: number;
+        averageAccessCount: number;
+    };
+    /**
+     * Manually trigger cache cleanup
+     * Removes expired entries and optionally enforces size limits
+     * @param forceEviction Whether to force LRU eviction even if under size limit
+     * @returns Number of entries removed
+     */
+    cleanup(forceEviction?: boolean): number;
+    /**
+     * Destroy cache manager and cleanup resources
+     */
+    destroy(): void;
+    /**
+     * Evict the least recently used entry
+     * @returns Whether an entry was evicted
+     */
+    private evictLeastRecentlyUsed;
+    /**
+     * Start periodic cleanup timer
+     */
+    private startPeriodicCleanup;
+    /**
+     * Record a cache hit and update metrics
+     */
+    private recordHit;
+    /**
+     * Record a cache miss and update metrics
+     */
+    private recordMiss;
+    /**
+     * Update cache metrics
+     */
+    private updateMetrics;
+    /**
+     * Calculate and update hit rate
+     */
+    private updateHitRate;
+    /**
+     * Reset all metrics to zero
+     */
+    private resetMetrics;
+}
+export declare const globalTokenCache: TokenCacheManager;
+//# sourceMappingURL=cache-manager.d.ts.map

package/dist/types/auth-session/internal/cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../../../src/auth-session/internal/cache-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kEAAkE;IAClE,2BAA2B,CAAC,EAAE,OAAO,CAAA;IACrC,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,6DAA6D;IAC7D,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB;AAWD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,YAAY,CAAC,CAAgB;gBAEzB,MAAM,GAAE,WAAgB;IAiBpC;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAwB/B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAyBrD;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,UAAU,IAAI,YAAY;IAI1B;;OAEG;IACH,SAAS,IAAI;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,kBAAkB,EAAE,MAAM,CAAA;QAC1B,cAAc,EAAE,MAAM,CAAA;QACtB,kBAAkB,EAAE,MAAM,CAAA;KAC3B;IAuBD;;;;;OAKG;IACH,OAAO,CAAC,aAAa,GAAE,OAAe,GAAG,MAAM;IA4B/C;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAuB9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,YAAY;CAQrB;AAGD,eAAO,MAAM,gBAAgB,mBAM3B,CAAA"}

package/dist/types/auth-session/internal/types.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Authentication storage configuration options for flexibility across different project structures
+ */
+export type AuthStorageConfig = {
+    /** Root directory for auth session storage (fixed at process.cwd()/.auth) */
+    storageDir?: string;
+    /** Debug mode to enable additional logging */
+    debug?: boolean;
+};
+/** Function type for customizing how token data is formatted before storage
+ * This allows for complete customization of the token storage format with type safety
+ *
+ * Token data can be any format that the auth provider supports:
+ * - Simple Bearer tokens (string)
+ * - Playwright storage state (object with cookies and origins)
+ * - Custom token formats from auth providers
+ *
+ * NOTE: For UI testing with Playwright's built-in storage state, this formatter is often
+ * unnecessary and can be omitted entirely. The default implementation simply passes
+ * the token through without modification.
+ *
+ * @template TInput The type of the input token data
+ * @template TOutput The type of the formatted output data
+ * @param token The raw token data
+ * @param options Optional auth session options to customize formatting
+ * @returns Formatted token data ready for storage
+ */
+export type TokenDataFormatter<TInput = unknown, TOutput = unknown> = (token: TInput, options?: Partial<AuthSessionOptions>) => TOutput;
+/**
+ * Standard Playwright storage state format for type safety
+ * This represents the expected structure for browser context storage state
+ */
+export type PlaywrightStorageState = {
+    cookies: Array<{
+        name: string;
+        value: string;
+        domain?: string;
+        path?: string;
+        expires?: number;
+        httpOnly?: boolean;
+        secure?: boolean;
+        sameSite?: 'Strict' | 'Lax' | 'None';
+    }>;
+    origins: Array<{
+        origin: string;
+        localStorage: Array<{
+            name: string;
+            value: string;
+        }>;
+    }>;
+};
+/** Default token data formatter type that converts unknown input to Playwright storage state */
+export type DefaultTokenDataFormatter = TokenDataFormatter<unknown, PlaywrightStorageState>;
+/** Retry configuration for error recovery */
+export type RetryConfig = {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Initial delay between retries in milliseconds (default: 100ms) */
+    initialDelayMs?: number;
+    /** Exponential backoff multiplier (default: 2) */
+    backoffMultiplier?: number;
+    /** Maximum delay between retries in milliseconds (default: 5000ms) */
+    maxDelayMs?: number;
+    /** Whether to add random jitter to delays (default: true) */
+    enableJitter?: boolean;
+};
+/** Options for the auth session */
+export type AuthSessionOptions = AuthIdentifiers & {
+    /** Root directory for auth session storage (default: process.cwd()/.auth)
+     * Note: The environment and user identifier will be appended to this path by the provider */
+    storageDir?: string;
+    /** Token filename (default: storage-state.json) */
+    tokenFileName?: string;
+    /** Cookie name to use for authentication (default: auth-token) */
+    cookieName?: string;
+    /** Custom token data formatter to control how tokens are saved */
+    tokenDataFormatter?: TokenDataFormatter<unknown, PlaywrightStorageState>;
+    /** Debug mode (default: false) */
+    debug?: boolean;
+    /** Retry configuration for error recovery (default: { maxRetries: 3, initialDelayMs: 100 }) */
+    retryConfig?: RetryConfig;
+};
+/**
+ * Full auth configuration that extends the base identifiers
+ * Includes URLs and additional configuration beyond just identifiers
+ */
+export type AuthOptions = AuthIdentifiers & {
+    /** Base URL to use for the browser context (the application URL)
+     * If not provided, will be determined based on environment
+     * @default process.env.BASE_URL || environment-specific URL */
+    baseUrl?: string;
+    /** Base URL to use for authentication requests (the auth service URL)
+     * This is often different from the application baseUrl
+     * @default process.env.AUTH_BASE_URL || environment-specific auth URL */
+    authBaseUrl?: string;
+};
+/** For usage in test fixtures */
+export type AuthFixtures = {
+    /** Configuration options for authentication */
+    authOptions: AuthOptions;
+    /** Authentication token for API requests */
+    authToken: string;
+    /** Toggle to enable/disable authentication session
+     * When false, auth token acquisition and applying to browser context is skipped
+     * Set to false to completely disable auth for specific tests
+     * @default true */
+    authSessionEnabled: boolean;
+};
+/**
+ * Base identification options used across the auth system
+ * These identifiers determine which environment and user identifier to use
+ */
+export type AuthIdentifiers = {
+    /** Environment to use for authentication
+     * @default process.env.TEST_ENV || 'local' */
+    environment?: string;
+    /** User identifier; email or username */
+    userIdentifier?: string;
+    /** User password */
+    userPassword?: string;
+};
+/**
+ * Result of storage path resolution
+ * Contains the actual filesystem paths for auth storage
+ */
+export type AuthSessionConfig = {
+    /** Resolved directory for auth storage files */
+    storageDir: string;
+    /** Full path to the Playwright storage state file */
+    storageStatePath: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/auth-session/internal/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/auth-session/internal/types.ts"],"names":[],"mappings":"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"}

package/dist/types/burn-in/core/analyzer.d.ts

@@ -0,0 +1,36 @@
+import type { BurnInConfig, BurnInOptions } from './types';
+type ChangedFiles = {
+    testFiles: string[];
+    skipBurnInFiles: string[];
+    otherFiles: string[];
+    all: string[];
+};
+type TestRunPlan = {
+    /** Tests to run, or null to use --only-changed */
+    tests: string[] | null;
+    /** Special flags like --shard */
+    flags?: string[];
+    /** Reason for the test selection */
+    reason: string;
+};
+export declare class BurnInAnalyzer {
+    private config;
+    private options;
+    private debugMode;
+    constructor(config: BurnInConfig, options: BurnInOptions);
+    getChangedFiles(baseBranch: string): ChangedFiles;
+    private isTestFile;
+    private isSkipBurnInFile;
+    private matchesPattern;
+    analyzeTestableDependencies(changedFiles: ChangedFiles): Promise<TestRunPlan>;
+    private createCustomTestPlan;
+    private findAffectedTests;
+    private findTsConfig;
+    private findTestFiles;
+    private testDependsOnChangedFiles;
+    private pathsMatch;
+    private isBasenameMatch;
+    buildCommand(plan: TestRunPlan): string[] | null;
+}
+export {};
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/types/burn-in/core/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../../../src/burn-in/core/analyzer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAG1D,KAAK,YAAY,GAAG;IAClB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,GAAG,EAAE,MAAM,EAAE,CAAA;CACd,CAAA;AAED,KAAK,WAAW,GAAG;IACjB,kDAAkD;IAClD,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACtB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,qBAAa,cAAc;IAIvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IAJjB,OAAO,CAAC,SAAS,CAAS;gBAGhB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,aAAa;IAMhC,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAqEjD,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,cAAc;IAYhB,2BAA2B,CAC/B,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,WAAW,CAAC;YA+BT,oBAAoB;YA+DpB,iBAAiB;IA0D/B,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,aAAa;IAwCrB,OAAO,CAAC,yBAAyB;IAgDjC,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,eAAe;IAIvB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,GAAG,IAAI;CA8BjD"}

package/dist/types/burn-in/core/config.d.ts

@@ -0,0 +1,4 @@
+import type { BurnInConfig } from './types';
+export declare const DEFAULT_CONFIG: BurnInConfig;
+export declare function loadConfig(configPath?: string): BurnInConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/types/burn-in/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/burn-in/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAI3C,eAAO,MAAM,cAAc,EAAE,YAoB5B,CAAA;AAED,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CA0D5D"}

package/dist/types/burn-in/core/types.d.ts

@@ -0,0 +1,24 @@
+export type BurnInConfig = {
+    /** Patterns for files that should skip burn-in entirely */
+    skipBurnInPatterns?: string[];
+    /** Patterns to identify test files */
+    testPatterns?: string[];
+    /** Burn-in test execution settings */
+    burnIn?: {
+        /** Number of times to repeat each test */
+        repeatEach?: number;
+        /** Number of retries for failed tests */
+        retries?: number;
+    };
+    /** Percentage of tests to run AFTER skip patterns filter (e.g., 0.1 for 10%) */
+    burnInTestPercentage?: number;
+    /** Enable verbose debug output for pattern matching (can also use BURN_IN_DEBUG env var) */
+    debug?: boolean;
+};
+export type BurnInOptions = {
+    /** Base branch to compare against */
+    baseBranch?: string;
+    /** Path to configuration file */
+    configPath?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/burn-in/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/burn-in/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;IAE7B,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IAEvB,sCAAsC;IACtC,MAAM,CAAC,EAAE;QACP,0CAA0C;QAC1C,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,yCAAyC;QACzC,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IAED,gFAAgF;IAChF,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAE7B,4FAA4F;IAC5F,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA"}

package/dist/types/burn-in/index.d.ts

@@ -0,0 +1,3 @@
+export { runBurnIn } from './runner';
+export type { BurnInConfig, BurnInOptions } from './core/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/burn-in/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/burn-in/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/types/burn-in/runner.d.ts

@@ -0,0 +1,13 @@
+import type { BurnInOptions, BurnInConfig } from './core/types';
+type InternalBurnInOptions = BurnInOptions & {
+    config?: BurnInConfig;
+};
+export declare class BurnInRunner {
+    private options;
+    private analyzer;
+    constructor(options?: InternalBurnInOptions);
+    run(): Promise<void>;
+}
+export declare function runBurnIn(options?: BurnInOptions): Promise<void>;
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/types/burn-in/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/burn-in/runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG/D,KAAK,qBAAqB,GAAG,aAAa,GAAG;IAC3C,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,qBAAa,YAAY;IAGX,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,QAAQ,CAAgB;gBAEZ,OAAO,GAAE,qBAA0B;IAKjD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoD3B;AAED,wBAAsB,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}

package/dist/types/file-utils/core/csv-reader.d.ts

@@ -0,0 +1,35 @@
+import type { CSVReadOptions, CSVReadResult } from './types';
+/**
+ * Reads CSV data and parses it into an array of objects.
+ *
+ * @param options - Options for CSV reading
+ *   - filePath: Path to the CSV file (mutually exclusive with content)
+ *   - content: Direct CSV content as string or Buffer (mutually exclusive with filePath)
+ *   - delimiter: Character used to separate values (default: ',')
+ *   - encoding: File encoding (default: 'utf8')
+ *   - parseHeaders: Whether to use the first row as headers (default: true)
+ *   - trim: Whether to trim whitespace from values (default: true)
+ * @returns A promise resolving to a CSVReadResult with typed content.
+ *
+ * @example
+ * ```ts
+ * // Read from file
+ * const result = await readCSV({ filePath: 'path/to/data.csv' });
+ *
+ * // Read from buffer (e.g., extracted from ZIP)
+ * const result = await readCSV({ content: buffer });
+ *
+ * // Read from string content
+ * const csvString = 'name,age\nJohn,25\nJane,30';
+ * const result = await readCSV({ content: csvString });
+ *
+ * // Read with strong types
+ * interface User {
+ *   id: number;
+ *   name: string;
+ * }
+ * const result = await readCSV<User>({ filePath: 'path/to/users.csv' });
+ * ```
+ */
+export declare function readCSV<T = Record<string, unknown>>(options: CSVReadOptions): Promise<CSVReadResult<T>>;
+//# sourceMappingURL=csv-reader.d.ts.map

package/dist/types/file-utils/core/csv-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-reader.d.ts","sourceRoot":"","sources":["../../../../src/file-utils/core/csv-reader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAU5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CA0E3B"}

package/dist/types/file-utils/core/file-downloader.d.ts

@@ -0,0 +1,19 @@
+import type { Page } from '@playwright/test';
+export type DownloadOptions = {
+    page: Page;
+    downloadDir: string;
+    /** A function that triggers the download action. */
+    trigger: () => Promise<void>;
+    /** Optional: A specific filename to save the file as. If not provided, a unique name is generated. */
+    fileName?: string;
+    /** Optional: Timeout for waiting for the download event. Defaults to 30 seconds. */
+    timeout?: number;
+};
+/**
+ * Handles a file download in Playwright by wrapping the common boilerplate.
+ * It waits for the download event, triggers the download, and saves the file.
+ *
+ * @returns The full path to the downloaded file.
+ */
+export declare function handleDownload(options: DownloadOptions): Promise<string>;
+//# sourceMappingURL=file-downloader.d.ts.map

package/dist/types/file-utils/core/file-downloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-downloader.d.ts","sourceRoot":"","sources":["../../../../src/file-utils/core/file-downloader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAK5C,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,IAAI,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,sGAAsG;IACtG,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/types/file-utils/core/pdf-reader.d.ts

@@ -0,0 +1,42 @@
+import type { PDFReadOptions, PDFReadResult } from './types';
+/**
+ * Reads and extracts text from a PDF file, with optional page merging and debug control.
+ *
+ * @remarks
+ * - Fallbacks between merged and unmerged extraction.
+ * - Vector-based PDFs (e.g., jsPDF) may fail check `info.isVectorBased` and `info.extractionNotes`.
+ *
+ * @param options.filePath                   Path to the PDF file.
+ * @param options.maxPages                   Max pages to read (default: all).
+ * @param options.debug                      Enable debug logging (default: false).
+ * @param options.maxPages                   Max pages to read (default: all).
+ *
+ * @returns A `PDFReadResult` containing:
+ *   - `content`: extracted text
+ *   - `pagesCount`: total number of pages
+ *   - `info`: metadata & extraction details
+ *   - `metadata`: raw PDF metadata
+ *
+ * @example
+ * ```typescript
+ * // Simple usage - extract all text as single string
+ * const result = await readPDF({
+ *   filePath: '/path/to/document.pdf'
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Advanced usage with all options
+ * const result = await readPDF({
+ *   filePath: '/path/to/document.pdf',
+ *   mergePages: false,  // Keep pages separate (joined with \n)
+ *   debug: true,        // Enable debug logging
+ *   maxPages: 10        // Limit processing to first 10 pages
+ * })
+ * ```
+ */
+export declare function readPDF(options: PDFReadOptions & {
+    filePath: string;
+}): Promise<PDFReadResult>;
+//# sourceMappingURL=pdf-reader.d.ts.map

package/dist/types/file-utils/core/pdf-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-reader.d.ts","sourceRoot":"","sources":["../../../../src/file-utils/core/pdf-reader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAa5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,aAAa,CAAC,CAgDxB"}

package/dist/types/file-utils/core/types.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Type definitions for file reading and validation operations
+ *
+ * This file contains shared type definitions used by the specialized readers:
+ * - csv-reader.ts
+ * - xlsx-reader.ts
+ * - pdf-reader.ts
+ * - zip-reader.ts
+ */
+/**
+ * Supported file types for reading
+ */
+export type SupportedFileType = 'csv' | 'xlsx' | 'pdf' | 'zip';
+/**
+ * Base result type for file reading operations
+ */
+export type FileReadResult<T> = {
+    filePath: string;
+    fileName: string;
+    extension: SupportedFileType;
+    content: T;
+};
+/**
+ * Result type for CSV files
+ */
+export type CSVReadResult<T = Record<string, unknown>> = FileReadResult<{
+    data: Array<T>;
+    headers: string[];
+}>;
+/**
+ * Result type for XLSX files
+ */
+export type XLSXReadResult<T = Record<string, unknown>> = FileReadResult<{
+    worksheets: Array<{
+        name: string;
+        data: T[];
+    }>;
+    activeSheet: {
+        name: string;
+        data: T[];
+    };
+}>;
+/**
+ * Result type for PDF files
+ */
+export type PDFReadResult = FileReadResult<string> & {
+    pagesCount: number;
+    info: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+};
+/**
+ * Result type for ZIP files
+ */
+export type ZIPReadResult = FileReadResult<{
+    entries: string[];
+    extractedFiles?: Record<string, Buffer>;
+}>;
+/**
+ * Options for reading CSV files
+ */
+export type CSVReadOptions = {
+    filePath?: string;
+    content?: string | Buffer;
+    encoding?: BufferEncoding;
+    parseHeaders?: boolean;
+    /**
+     * Character used to separate values
+     * - Specific character like ',', ';', '\t', '|'
+     * - 'auto' to auto-detect the delimiter (default)
+     */
+    delimiter?: string | 'auto';
+    trim?: boolean;
+};
+/**
+ * Options for reading XLSX files
+ */
+export type XLSXReadOptions = {
+    sheetName?: string;
+    parseHeaders?: boolean;
+    includeFormulas?: boolean;
+};
+/**
+ * Options for reading PDF files
+ */
+export type PDFReadOptions = {
+    maxPages?: number;
+    extractText?: boolean;
+    /**
+     * Enable debug logging for PDF extraction
+     */
+    debug?: boolean;
+    /**
+     * Whether to merge text from all pages into a single string
+     * @default true
+     */
+    mergePages?: boolean;
+    /**
+     * Range of pages to extract text from (future feature)
+     */
+    pages?: [number, number];
+};
+/**
+ * Custom error for CSV parsing and reading operations
+ */
+export declare class CSVError extends Error {
+    readonly row?: number | undefined;
+    readonly field?: string | undefined;
+    constructor(message: string, row?: number | undefined, field?: string | undefined);
+}
+/**
+ * Custom error for XLSX file operations
+ */
+export declare class XLSXError extends Error {
+    readonly worksheet?: string | undefined;
+    constructor(message: string, worksheet?: string | undefined);
+}
+/**
+ * Custom error for PDF reading operations
+ */
+export declare class PDFError extends Error {
+    readonly page?: number | undefined;
+    constructor(message: string, page?: number | undefined);
+}
+/**
+ * Custom error for ZIP-related operations to allow for specific try/catch blocks.
+ */
+export declare class ZipError extends Error {
+    constructor(message: string);
+}
+/**
+ * General file validation error for input validation issues
+ */
+export declare class FileValidationError extends Error {
+    readonly filePath?: string | undefined;
+    readonly validationType?: "missing" | "invalid" | "conflict" | "access" | undefined;
+    constructor(message: string, filePath?: string | undefined, validationType?: "missing" | "invalid" | "conflict" | "access" | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/file-utils/core/types.d.ts.map

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

package/dist/types/file-utils/core/xlsx-reader.d.ts

@@ -0,0 +1,31 @@
+import type { XLSXReadOptions, XLSXReadResult } from './types';
+/**
+ * Reads an Excel file and parses it into a structured format
+ *
+ * @param options - Options for Excel parsing
+ *   - filePath: Path to the Excel file
+ *   - sheetName: Name of sheet to set as active (defaults to first sheet)
+ *   - Other reading options
+ * @returns Promise resolving to an XLSXReadResult
+ *
+ * @example
+ * ```ts
+ * // Read Excel with default options (first sheet active)
+ * const result = await readXLSX({ filePath: '/path/to/file.xlsx' });
+ * console.log(result.content.activeSheet); // Data from active sheet
+ *
+ * // Read Excel with custom sheet name and strong types
+ * interface User {
+ *   ID: number;
+ *   Name: string;
+ * }
+ * const result = await readXLSX<User>({
+ *   filePath: '/path/to/file.xlsx',
+ *   sheetName: 'Users'
+ * });
+ * ```
+ */
+export declare function readXLSX<T = Record<string, unknown>>(options: {
+    filePath: string;
+} & Partial<XLSXReadOptions>): Promise<XLSXReadResult<T>>;
+//# sourceMappingURL=xlsx-reader.d.ts.map

package/dist/types/file-utils/core/xlsx-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xlsx-reader.d.ts","sourceRoot":"","sources":["../../../../src/file-utils/core/xlsx-reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAS9D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxD,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,eAAe,CAAC,GACvD,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CA2B5B"}