hazo_files 1.4.2 → 1.4.4

package/dist/index.d.ts

@@ -185,6 +185,8 @@ interface FileMetadataInput {
     uploaded_by?: string;
     /** Original filename at upload time (V2) */
     original_filename?: string;
+    /** Content tag classifying the document type (V3) */
+    content_tag?: string;
 }
 /**
  * Input for updating an existing metadata record
@@ -258,6 +260,23 @@ interface RemoveExtractionOptions {
     /** Merge strategy to use when recalculating (default: 'shallow') */
     mergeStrategy?: 'shallow' | 'deep';
 }
+/**
+ * Configuration for LLM-based content tagging.
+ * When enabled, calls the LLM with a specific prompt and writes
+ * the extracted field value to the content_tag column.
+ */
+interface ContentTagConfig {
+    /** Whether to enable LLM-based content tagging */
+    content_tag_set_by_llm: boolean;
+    /** Prompt area for hazo_llm_api lookup */
+    content_tag_prompt_area: string;
+    /** Prompt key within the area */
+    content_tag_prompt_key: string;
+    /** Optional variables to substitute in the prompt template */
+    content_tag_prompt_variables?: Record<string, string>;
+    /** Field name to extract from the LLM response as the content tag */
+    content_tag_prompt_return_fieldname: string;
+}
 
 /**
  * Naming convention types for hazo_files
@@ -412,6 +431,8 @@ interface FileMetadataRecordV2 extends FileMetadataRecord {
     storage_verified_at?: string | null;
     /** ISO timestamp when file was soft-deleted */
     deleted_at?: string | null;
+    /** Content tag classifying the document type (V3) */
+    content_tag?: string | null;
 }
 /**
  * Options for adding a reference to a file
@@ -493,7 +514,7 @@ interface UploadWithRefOptions {
  * Core types for the hazo_files package
  */
 /** Supported storage provider types */
-type StorageProvider = 'local' | 'google_drive';
+type StorageProvider = 'local' | 'google_drive' | 'dropbox';
 /** File item representing a file in storage */
 interface FileItem {
     id: string;
@@ -521,11 +542,21 @@ interface FolderItem {
 }
 /** Union type for file system items */
 type FileSystemItem = FileItem | FolderItem;
+/** Dropbox specific configuration */
+interface DropboxConfig {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    refreshToken?: string;
+    accessToken?: string;
+    rootPath?: string;
+}
 /** Configuration for the file manager */
 interface HazoFilesConfig {
     provider: StorageProvider;
     local?: LocalStorageConfig;
     google_drive?: GoogleDriveConfig;
+    dropbox?: DropboxConfig;
 }
 /** Local storage specific configuration */
 interface LocalStorageConfig {
@@ -1004,7 +1035,7 @@ declare class FileMetadataService {
     /**
      * Update specific V2 fields on a record
      */
-    updateFields(fileId: string, fields: Partial<Pick<FileMetadataRecordV2, 'scope_id' | 'uploaded_by' | 'original_filename' | 'storage_verified_at' | 'status'>>): Promise<boolean>;
+    updateFields(fileId: string, fields: Partial<Pick<FileMetadataRecordV2, 'scope_id' | 'uploaded_by' | 'original_filename' | 'storage_verified_at' | 'status' | 'content_tag'>>): Promise<boolean>;
     /**
      * Find orphaned files (zero references)
      */
@@ -1408,6 +1439,13 @@ interface HazoLLMInstance {
  * Factory function type for creating LLM instances
  */
 type LLMFactory = (provider: LLMProvider, options?: Record<string, unknown>) => HazoLLMInstance | Promise<HazoLLMInstance>;
+/**
+ * Extended LLM factory configuration with optional cache management
+ */
+interface LLMFactoryConfig {
+    create: LLMFactory;
+    invalidateCache?: (area?: string, key?: string) => void;
+}
 /**
  * LLM Extraction Service
  *
@@ -1449,7 +1487,13 @@ type LLMFactory = (provider: LLMProvider, options?: Record<string, unknown>) =>
 declare class LLMExtractionService {
     private llmFactory;
     private defaultProvider;
-    constructor(llmFactory: LLMFactory, defaultProvider?: LLMProvider);
+    private cacheInvalidator?;
+    constructor(factoryConfig: LLMFactoryConfig, defaultProvider?: LLMProvider);
+    /**
+     * Invalidate the LLM prompt cache
+     * Passthrough to hazo_llm_api's invalidate_prompt_cache when configured
+     */
+    invalidatePromptCache(area?: string, key?: string): void;
     /**
      * Extract data from a document
      *
@@ -1481,10 +1525,10 @@ declare class LLMExtractionService {
 /**
  * Create an LLMExtractionService instance
  *
- * @param llmFactory - Factory function for creating LLM instances
+ * @param factoryConfig - LLM factory configuration with create function and optional cache invalidation
  * @param defaultProvider - Default LLM provider (default: 'gemini')
  */
-declare function createLLMExtractionService(llmFactory: LLMFactory, defaultProvider?: LLMProvider): LLMExtractionService;
+declare function createLLMExtractionService(factoryConfig: LLMFactoryConfig, defaultProvider?: LLMProvider): LLMExtractionService;
 
 /**
  * Upload + Extract Service
@@ -1532,6 +1576,11 @@ interface UploadExtractOptions extends TrackedUploadOptions {
      * Whether to create the folder path if it doesn't exist
      */
     createFolders?: boolean;
+    /**
+     * Content tag configuration for this upload.
+     * Overrides the default config set on the service.
+     */
+    contentTagConfig?: ContentTagConfig;
 }
 /**
  * Result of upload with extraction
@@ -1551,6 +1600,8 @@ interface UploadExtractResult {
     generatedFolderPath?: string;
     /** Original file name before renaming */
     originalFileName?: string;
+    /** Content tag assigned by LLM (if content tagging was performed) */
+    contentTag?: string;
 }
 /**
  * Options for creating folders from naming convention
@@ -1608,7 +1659,8 @@ declare class UploadExtractService {
     private fileManager;
     private namingService?;
     private extractionService?;
-    constructor(fileManager: TrackedFileManager, namingService?: NamingConventionService, extractionService?: LLMExtractionService);
+    private defaultContentTagConfig?;
+    constructor(fileManager: TrackedFileManager, namingService?: NamingConventionService, extractionService?: LLMExtractionService, defaultContentTagConfig?: ContentTagConfig);
     /**
      * Upload a file with optional extraction and naming convention
      */
@@ -1633,6 +1685,21 @@ declare class UploadExtractService {
         fullPath?: string;
         folderPath?: string;
     }>;
+    /**
+     * Perform content tagging via LLM extraction.
+     * Calls the LLM with the configured prompt, extracts the specified field,
+     * and writes it to the content_tag column.
+     */
+    private performContentTagging;
+    /**
+     * Manually tag a file's content via LLM.
+     * Works with existing DB records, resolving the file path internally.
+     *
+     * @param fileId - Database record ID of the file
+     * @param config - Content tag config (falls back to default if not provided)
+     * @returns OperationResult with the tag value
+     */
+    tagFileContent(fileId: string, config?: ContentTagConfig): Promise<OperationResult<string>>;
     /**
      * Get the file manager
      */
@@ -1649,7 +1716,7 @@ declare class UploadExtractService {
 /**
  * Create an UploadExtractService instance
  */
-declare function createUploadExtractService(fileManager: TrackedFileManager, namingService?: NamingConventionService, extractionService?: LLMExtractionService): UploadExtractService;
+declare function createUploadExtractService(fileManager: TrackedFileManager, namingService?: NamingConventionService, extractionService?: LLMExtractionService, defaultContentTagConfig?: ContentTagConfig): UploadExtractService;
 
 /**
  * Configuration loader for hazo_files
@@ -1743,6 +1810,8 @@ interface HazoFilesColumnDefinitions {
     deleted_at: 'TEXT' | 'TIMESTAMP';
     /** Original filename at upload time (V2) */
     original_filename: 'TEXT';
+    /** Content tag classifying the document type (V3) */
+    content_tag: 'TEXT';
 }
 /**
  * Schema definition for a specific database type
@@ -1925,6 +1994,46 @@ declare const HAZO_FILES_NAMING_TABLE_SCHEMA: HazoFilesNamingTableSchema;
  * Get DDL for a custom naming table name
  */
 declare function getNamingSchemaForTable(tableName: string, dbType: 'sqlite' | 'postgres'): DatabaseSchemaDefinition;
+/**
+ * Migration schema for adding V3 content tagging column to existing tables.
+ * Idempotent — safe to run multiple times.
+ *
+ * @example
+ * ```typescript
+ * import { HAZO_FILES_MIGRATION_V3 } from 'hazo_files';
+ *
+ * // SQLite
+ * for (const stmt of HAZO_FILES_MIGRATION_V3.sqlite.alterStatements) {
+ *   try { await db.run(stmt); } catch { /* column already exists *\/ }
+ * }
+ * for (const idx of HAZO_FILES_MIGRATION_V3.sqlite.indexes) {
+ *   await db.run(idx);
+ * }
+ *
+ * // PostgreSQL
+ * for (const stmt of HAZO_FILES_MIGRATION_V3.postgres.alterStatements) {
+ *   await client.query(stmt);
+ * }
+ * for (const idx of HAZO_FILES_MIGRATION_V3.postgres.indexes) {
+ *   await client.query(idx);
+ * }
+ * ```
+ */
+interface HazoFilesMigrationV3 {
+    /** Default table name */
+    tableName: string;
+    /** SQLite migration statements */
+    sqlite: MigrationSchemaDefinition;
+    /** PostgreSQL migration statements */
+    postgres: MigrationSchemaDefinition;
+    /** New column names added in V3 */
+    newColumns: readonly string[];
+}
+declare const HAZO_FILES_MIGRATION_V3: HazoFilesMigrationV3;
+/**
+ * Get V3 migration statements for a custom table name
+ */
+declare function getMigrationV3ForTable(tableName: string, dbType: 'sqlite' | 'postgres'): MigrationSchemaDefinition;
 
 /**
  * Migration: Add Reference Tracking (V2)
@@ -1967,6 +2076,33 @@ declare function migrateToV2(executor: MigrationExecutor, dbType: 'sqlite' | 'po
  */
 declare function backfillV2Defaults(executor: MigrationExecutor, dbType: 'sqlite' | 'postgres', tableName?: string): Promise<void>;
 
+/**
+ * Migration: Add Content Tag (V3)
+ *
+ * Adds content_tag column to an existing hazo_files table.
+ * Idempotent — safe to run multiple times.
+ */
+
+/**
+ * Run the V3 migration: add content_tag column and index.
+ *
+ * @param executor - Object with a `run(sql)` method
+ * @param dbType - Database type ('sqlite' | 'postgres')
+ * @param tableName - Custom table name (defaults to 'hazo_files')
+ *
+ * @example
+ * ```typescript
+ * import { migrateToV3 } from 'hazo_files';
+ *
+ * // SQLite with better-sqlite3
+ * await migrateToV3({ run: (sql) => db.exec(sql) }, 'sqlite');
+ *
+ * // PostgreSQL with pg
+ * await migrateToV3({ run: (sql) => client.query(sql) }, 'postgres');
+ * ```
+ */
+declare function migrateToV3(executor: MigrationExecutor, dbType: 'sqlite' | 'postgres', tableName?: string): Promise<void>;
+
 /**
  * Common utility functions
  */
@@ -2336,6 +2472,150 @@ declare class GoogleDriveModule extends BaseStorageModule {
  */
 declare function createGoogleDriveModule(): GoogleDriveModule;
 
+/**
+ * Dropbox OAuth Authentication Handler
+ * Manages OAuth flow, token storage, and token refresh
+ */
+interface DropboxAuthConfig {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+}
+interface DropboxTokenData {
+    accessToken: string;
+    refreshToken: string;
+    expiryDate?: number;
+}
+interface DropboxAuthCallbacks {
+    onTokensUpdated?: (tokens: DropboxTokenData) => Promise<void>;
+    getStoredTokens?: () => Promise<DropboxTokenData | null>;
+}
+/**
+ * Dropbox Authentication Manager
+ */
+declare class DropboxAuth {
+    private config;
+    private callbacks;
+    private tokens;
+    constructor(config: DropboxAuthConfig, callbacks?: DropboxAuthCallbacks);
+    /**
+     * Generate the authorization URL for OAuth consent
+     */
+    getAuthUrl(state?: string): string;
+    /**
+     * Exchange authorization code for tokens
+     */
+    exchangeCodeForTokens(code: string): Promise<DropboxTokenData>;
+    /**
+     * Set tokens directly (e.g., from stored tokens)
+     */
+    setTokens(tokens: DropboxTokenData): Promise<void>;
+    /**
+     * Load tokens from storage using callback
+     */
+    loadStoredTokens(): Promise<boolean>;
+    /**
+     * Check if authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get current tokens
+     */
+    getTokens(): DropboxTokenData | null;
+    /**
+     * Get current access token
+     */
+    getAccessToken(): string | null;
+    /**
+     * Refresh the access token
+     */
+    refreshAccessToken(): Promise<DropboxTokenData>;
+    /**
+     * Revoke access (disconnect)
+     */
+    revokeAccess(): Promise<void>;
+    /**
+     * Check if token is expired or will expire soon
+     */
+    isTokenExpired(bufferSeconds?: number): boolean;
+    /**
+     * Ensure valid access token (refresh if needed)
+     */
+    ensureValidToken(): Promise<void>;
+}
+/**
+ * Create a new DropboxAuth instance
+ */
+declare function createDropboxAuth(config: DropboxAuthConfig, callbacks?: DropboxAuthCallbacks): DropboxAuth;
+
+/**
+ * Dropbox Storage Module
+ * Implements file operations using Dropbox API via the official SDK
+ */
+
+declare class DropboxModule extends BaseStorageModule {
+    readonly provider: StorageProvider;
+    private auth;
+    private dbx;
+    private rootPath;
+    private authCallbacks;
+    /**
+     * Set authentication callbacks for token persistence
+     */
+    setAuthCallbacks(callbacks: DropboxAuthCallbacks): void;
+    initialize(config: HazoFilesConfig): Promise<void>;
+    /**
+     * Create/recreate the Dropbox SDK client with the current access token
+     */
+    private createDropboxClient;
+    /**
+     * Get the auth instance for OAuth flow
+     */
+    getAuth(): DropboxAuth;
+    /**
+     * Check if user is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Authenticate with provided tokens
+     */
+    authenticate(tokens: DropboxTokenData): Promise<void>;
+    /**
+     * Ensure authenticated before operations
+     */
+    private ensureAuthenticated;
+    /**
+     * Convert virtual path to Dropbox path
+     * Virtual: /folder/file.txt -> Dropbox: /folder/file.txt (or /rootPath/folder/file.txt)
+     * Dropbox root is empty string "", not "/"
+     */
+    private toDropboxPath;
+    /**
+     * Convert Dropbox metadata to FileSystemItem
+     */
+    private metadataToItem;
+    /**
+     * Convert a Dropbox path_display to virtual path
+     */
+    private toVirtualPath;
+    createDirectory(virtualPath: string): Promise<OperationResult<FolderItem>>;
+    removeDirectory(virtualPath: string, recursive?: boolean): Promise<OperationResult>;
+    uploadFile(source: string | Buffer | ReadableStream, remotePath: string, options?: UploadOptions): Promise<OperationResult<FileItem>>;
+    downloadFile(remotePath: string, localPath?: string, options?: DownloadOptions): Promise<OperationResult<Buffer | string>>;
+    moveItem(sourcePath: string, destinationPath: string, _options?: MoveOptions): Promise<OperationResult<FileSystemItem>>;
+    deleteFile(virtualPath: string): Promise<OperationResult>;
+    renameFile(virtualPath: string, newName: string, _options?: RenameOptions): Promise<OperationResult<FileItem>>;
+    renameFolder(virtualPath: string, newName: string, _options?: RenameOptions): Promise<OperationResult<FolderItem>>;
+    listDirectory(virtualPath: string, options?: ListOptions): Promise<OperationResult<FileSystemItem[]>>;
+    getItem(virtualPath: string): Promise<OperationResult<FileSystemItem>>;
+    exists(virtualPath: string): Promise<boolean>;
+    getFolderTree(path?: string, depth?: number): Promise<OperationResult<TreeNode[]>>;
+}
+/**
+ * Factory function to create a DropboxModule instance
+ */
+declare function createDropboxModule(): DropboxModule;
+
 /**
  * Module Registry
  * Central registry for all storage modules
@@ -2782,4 +3062,4 @@ declare function toV2Record(record: FileMetadataRecord): FileMetadataRecordV2;
  */
 declare function buildFileWithStatus(record: FileMetadataRecord): FileWithStatus;
 
-export { ALL_SYSTEM_VARIABLES, type AddExtractionOptions, type AddRefOptions, type AuthCallbacks, AuthenticationError, type CleanupOrphanedOptions, ConfigurationError, type CreateFolderOptions, type CrudServiceLike, DEFAULT_DATE_FORMATS, type DatabaseSchemaDefinition, type DatabaseTrackingConfig, DirectoryExistsError, DirectoryNotEmptyError, DirectoryNotFoundError, type DownloadOptions, type ExtractionData, type ExtractionOptions, type ExtractionResult, type FileBrowserState, type FileDataStructure, FileExistsError, type FileInfo, type FileItem, FileManager, type FileManagerOptions, type FileMetadataInput, type FileMetadataRecord, type FileMetadataRecordV2, FileMetadataService, type FileMetadataServiceOptions, type FileMetadataUpdate, FileNotFoundError, type FileRef, type FileRefVisibility, type FileStatus, type FileSystemItem, FileTooLargeError, type FileWithStatus, type FindOrphanedOptions, type FolderItem, type GeneratedNameResult, type GoogleAuthConfig, GoogleDriveAuth, type GoogleDriveConfig, GoogleDriveModule, HAZO_FILES_DEFAULT_TABLE_NAME, HAZO_FILES_MIGRATION_V2, HAZO_FILES_NAMING_DEFAULT_TABLE_NAME, HAZO_FILES_NAMING_TABLE_SCHEMA, HAZO_FILES_TABLE_SCHEMA, type HazoFilesColumnDefinitions, type HazoFilesConfig, HazoFilesError, type HazoFilesMigrationV2, type HazoFilesNamingColumnDefinitions, type HazoFilesNamingTableSchema, type HazoFilesTableSchema, type HazoLLMInstance, InvalidExtensionError, InvalidPathError, LLMExtractionService, type LLMFactory, type LLMProvider, type ListNamingConventionsOptions, type ListOptions, type LocalStorageConfig, LocalStorageModule, type MetadataLogger, type MigrationExecutor, type MigrationSchemaDefinition, type MoveOptions, type NameGenerationOptions, type NamingConventionInput, type NamingConventionRecord, NamingConventionService, type NamingConventionServiceOptions, type NamingConventionType, type NamingConventionUpdate, type NamingRuleConfiguratorProps, type NamingRuleHistoryEntry, type NamingRuleSchema, type NamingVariable, OperationError, type OperationResult, type ParsedNamingConvention, type PatternSegment, PermissionDeniedError, type ProgressCallback, type RemoveExtractionOptions, type RemoveRefsCriteria, type RenameOptions, SYSTEM_COUNTER_VARIABLES, SYSTEM_DATE_VARIABLES, SYSTEM_FILE_VARIABLES, type StorageModule, type StorageProvider, type TokenData, TrackedFileManager, type TrackedFileManagerFullOptions, type TrackedFileManagerOptions, type TrackedUploadOptions, type TreeNode, type UploadExtractOptions, type UploadExtractResult, UploadExtractService, type UploadOptions, type UploadWithRefOptions, type UseNamingRuleActions, type UseNamingRuleReturn, type UseNamingRuleState, type VariableCategory, addExtractionToFileData, backfillV2Defaults, buildFileWithStatus, clearExtractions, clonePattern, computeFileHash, computeFileHashFromStream, computeFileHashSync, computeFileInfo, createAndInitializeModule, createEmptyFileDataStructure, createEmptyNamingRuleSchema, createFileItem, createFileManager, createFileMetadataService, createFileRef, createFolderItem, createGoogleDriveAuth, createGoogleDriveModule, createInitializedFileManager, createInitializedTrackedFileManager, createLLMExtractionService, createLiteralSegment, createLocalModule, createModule, createNamingConventionService, createTrackedFileManager, createUploadExtractService, createVariableSegment, deepMerge, errorResult, filterItems, formatBytes, formatCounter, formatDateToken, generateExtractionId, generateId, generatePreviewName, generateRefId, generateSampleConfig, generateSegmentId, getBaseName, getBreadcrumbs, getDirName, getExtension, getExtensionFromMime, getExtractionById, getExtractionCount, getExtractions, getFileCategory, getFileMetadataValues, getMergedData, getMigrationForTable, getMimeType, getNameWithoutExtension, getNamingSchemaForTable, getParentPath, getPathSegments, getRegisteredProviders, getRelativePath, getSchemaForTable, getSystemVariablePreviewValues, hasExtension, hasExtractionStructure, hasFileContentChanged, hashesEqual, hazo_files_generate_file_name, hazo_files_generate_folder_name, isAudio, isChildPath, isCounterVariable, isDateVariable, isDocument, isFile, isFileMetadataVariable, isFolder, isImage, isPreviewable, isProviderRegistered, isText, isVideo, joinPath, loadConfig, loadConfigAsync, migrateToV2, normalizePath, parseConfig, parseFileData, parseFileRefs, parsePatternString, patternToString, recalculateMergedData, registerModule, removeExtractionById, removeExtractionByIndex, removeRefFromArray, removeRefsByCriteriaFromArray, sanitizeFilename, saveConfig, sortItems, stringifyFileData, stringifyFileRefs, successResult, toV2Record, updateExtractionById, validateExtractionData, validateFileDataStructure, validateNamingRuleSchema, validatePath };
+export { ALL_SYSTEM_VARIABLES, type AddExtractionOptions, type AddRefOptions, type AuthCallbacks, AuthenticationError, type CleanupOrphanedOptions, ConfigurationError, type ContentTagConfig, type CreateFolderOptions, type CrudServiceLike, DEFAULT_DATE_FORMATS, type DatabaseSchemaDefinition, type DatabaseTrackingConfig, DirectoryExistsError, DirectoryNotEmptyError, DirectoryNotFoundError, type DownloadOptions, DropboxAuth, type DropboxAuthCallbacks, type DropboxAuthConfig, type DropboxConfig, DropboxModule, type DropboxTokenData, type ExtractionData, type ExtractionOptions, type ExtractionResult, type FileBrowserState, type FileDataStructure, FileExistsError, type FileInfo, type FileItem, FileManager, type FileManagerOptions, type FileMetadataInput, type FileMetadataRecord, type FileMetadataRecordV2, FileMetadataService, type FileMetadataServiceOptions, type FileMetadataUpdate, FileNotFoundError, type FileRef, type FileRefVisibility, type FileStatus, type FileSystemItem, FileTooLargeError, type FileWithStatus, type FindOrphanedOptions, type FolderItem, type GeneratedNameResult, type GoogleAuthConfig, GoogleDriveAuth, type GoogleDriveConfig, GoogleDriveModule, HAZO_FILES_DEFAULT_TABLE_NAME, HAZO_FILES_MIGRATION_V2, HAZO_FILES_MIGRATION_V3, HAZO_FILES_NAMING_DEFAULT_TABLE_NAME, HAZO_FILES_NAMING_TABLE_SCHEMA, HAZO_FILES_TABLE_SCHEMA, type HazoFilesColumnDefinitions, type HazoFilesConfig, HazoFilesError, type HazoFilesMigrationV2, type HazoFilesMigrationV3, type HazoFilesNamingColumnDefinitions, type HazoFilesNamingTableSchema, type HazoFilesTableSchema, type HazoLLMInstance, InvalidExtensionError, InvalidPathError, LLMExtractionService, type LLMFactory, type LLMFactoryConfig, type LLMProvider, type ListNamingConventionsOptions, type ListOptions, type LocalStorageConfig, LocalStorageModule, type MetadataLogger, type MigrationExecutor, type MigrationSchemaDefinition, type MoveOptions, type NameGenerationOptions, type NamingConventionInput, type NamingConventionRecord, NamingConventionService, type NamingConventionServiceOptions, type NamingConventionType, type NamingConventionUpdate, type NamingRuleConfiguratorProps, type NamingRuleHistoryEntry, type NamingRuleSchema, type NamingVariable, OperationError, type OperationResult, type ParsedNamingConvention, type PatternSegment, PermissionDeniedError, type ProgressCallback, type RemoveExtractionOptions, type RemoveRefsCriteria, type RenameOptions, SYSTEM_COUNTER_VARIABLES, SYSTEM_DATE_VARIABLES, SYSTEM_FILE_VARIABLES, type StorageModule, type StorageProvider, type TokenData, TrackedFileManager, type TrackedFileManagerFullOptions, type TrackedFileManagerOptions, type TrackedUploadOptions, type TreeNode, type UploadExtractOptions, type UploadExtractResult, UploadExtractService, type UploadOptions, type UploadWithRefOptions, type UseNamingRuleActions, type UseNamingRuleReturn, type UseNamingRuleState, type VariableCategory, addExtractionToFileData, backfillV2Defaults, buildFileWithStatus, clearExtractions, clonePattern, computeFileHash, computeFileHashFromStream, computeFileHashSync, computeFileInfo, createAndInitializeModule, createDropboxAuth, createDropboxModule, createEmptyFileDataStructure, createEmptyNamingRuleSchema, createFileItem, createFileManager, createFileMetadataService, createFileRef, createFolderItem, createGoogleDriveAuth, createGoogleDriveModule, createInitializedFileManager, createInitializedTrackedFileManager, createLLMExtractionService, createLiteralSegment, createLocalModule, createModule, createNamingConventionService, createTrackedFileManager, createUploadExtractService, createVariableSegment, deepMerge, errorResult, filterItems, formatBytes, formatCounter, formatDateToken, generateExtractionId, generateId, generatePreviewName, generateRefId, generateSampleConfig, generateSegmentId, getBaseName, getBreadcrumbs, getDirName, getExtension, getExtensionFromMime, getExtractionById, getExtractionCount, getExtractions, getFileCategory, getFileMetadataValues, getMergedData, getMigrationForTable, getMigrationV3ForTable, getMimeType, getNameWithoutExtension, getNamingSchemaForTable, getParentPath, getPathSegments, getRegisteredProviders, getRelativePath, getSchemaForTable, getSystemVariablePreviewValues, hasExtension, hasExtractionStructure, hasFileContentChanged, hashesEqual, hazo_files_generate_file_name, hazo_files_generate_folder_name, isAudio, isChildPath, isCounterVariable, isDateVariable, isDocument, isFile, isFileMetadataVariable, isFolder, isImage, isPreviewable, isProviderRegistered, isText, isVideo, joinPath, loadConfig, loadConfigAsync, migrateToV2, migrateToV3, normalizePath, parseConfig, parseFileData, parseFileRefs, parsePatternString, patternToString, recalculateMergedData, registerModule, removeExtractionById, removeExtractionByIndex, removeRefFromArray, removeRefsByCriteriaFromArray, sanitizeFilename, saveConfig, sortItems, stringifyFileData, stringifyFileRefs, successResult, toV2Record, updateExtractionById, validateExtractionData, validateFileDataStructure, validateNamingRuleSchema, validatePath };