hazo_files 1.4.2 → 1.4.4

package/README.md

@@ -7,7 +7,7 @@ A powerful, modular file management package for Node.js and React applications w
 
 ## Features
 
-- **Multiple Storage Providers**: Local filesystem and Google Drive support out of the box
+- **Multiple Storage Providers**: Local filesystem, Google Drive, and Dropbox support out of the box
 - **Modular Architecture**: Easily add custom storage providers
 - **Unified API**: Single consistent interface across all storage providers
 - **React UI Components**: Drop-in FileBrowser component with folder tree, file list, and preview
@@ -18,9 +18,11 @@ A powerful, modular file management package for Node.js and React applications w
 - **Upload + Extract Workflow**: Combined service for uploading files with automatic LLM extraction and naming
 - **File Reference Tracking**: Multi-entity file references with orphan detection, soft delete, and lifecycle management
 - **File Change Detection**: xxHash-based content hashing for efficient change detection
-- **Schema Migrations**: Built-in V2 migration utilities for adding reference tracking to existing databases
+- **Content Tagging**: Optional LLM-based content classification at upload time or on-demand via `content_tag` field
+- **Schema Migrations**: Built-in V2/V3 migration utilities for adding reference tracking and content tagging to existing databases
 - **TypeScript**: Full type safety and IntelliSense support
-- **OAuth Integration**: Built-in Google Drive OAuth authentication
+- **OAuth Integration**: Built-in Google Drive and Dropbox OAuth authentication
+- **Prompt Cache Invalidation**: Passthrough for hazo_llm_api prompt cache management via server instance
 - **Progress Tracking**: Upload/download progress callbacks
 - **File Validation**: Extension filtering and file size limits
 - **Error Handling**: Comprehensive error types and handling
@@ -1108,11 +1110,17 @@ const extractionService = new LLMExtractionService((provider, options) => {
   return createLLM({ provider, ...options });
 }, 'gemini');
 
-// Create upload + extract service
+// Create upload + extract service (with optional content tag config)
 const uploadExtract = new UploadExtractService(
   trackedFileManager,
   namingService,
-  extractionService
+  extractionService,
+  {
+    content_tag_set_by_llm: true,
+    content_tag_prompt_area: 'classification',
+    content_tag_prompt_key: 'classify_document',
+    content_tag_prompt_return_fieldname: 'document_type',
+  }
 );
 
 // Upload with extraction and naming convention
@@ -1140,6 +1148,8 @@ if (result.success) {
   console.log('Uploaded to:', result.generatedPath);
   // e.g., '/documents/2024/ACME/ACME_Q4_2024-12-09_001.pdf'
   console.log('Extracted data:', result.extraction?.data);
+  console.log('Content tag:', result.contentTag);
+  // e.g., 'invoice', 'report', 'contract'
 }
 
 // Generate path preview without uploading
@@ -1164,7 +1174,10 @@ const folderResult = await uploadExtract.createFolderFromConvention(
 ```typescript
 import { LLMExtractionService } from 'hazo_files';
 
-const extractionService = new LLMExtractionService(llmFactory, 'gemini');
+const extractionService = new LLMExtractionService({
+  create: llmFactory,
+  invalidateCache: (area, key) => invalidate_prompt_cache(area, key), // optional
+}, 'gemini');
 
 // Extract from document
 const result = await extractionService.extractFromDocument(
@@ -1194,6 +1207,74 @@ const autoResult = await extractionService.extract(
 );
 ```
 
+## Content Tagging
+
+Automatically classify uploaded files using LLM-based content analysis. The `content_tag` field stores a classification string (e.g., "invoice", "report", "contract") determined by an LLM prompt.
+
+### Configuration
+
+```typescript
+import type { ContentTagConfig } from 'hazo_files';
+
+const contentTagConfig: ContentTagConfig = {
+  content_tag_set_by_llm: true,
+  content_tag_prompt_area: 'classification',
+  content_tag_prompt_key: 'classify_document',
+  content_tag_prompt_return_fieldname: 'document_type',
+  content_tag_prompt_variables: { language: 'en' }, // optional
+};
+```
+
+### Automatic Tagging at Upload
+
+Pass `contentTagConfig` to `UploadExtractService` constructor (default for all uploads) or per-upload via options:
+
+```typescript
+// Per-upload override
+const result = await uploadExtract.uploadWithExtract(buffer, 'file.pdf', {
+  basePath: '/docs',
+  contentTagConfig: {
+    content_tag_set_by_llm: true,
+    content_tag_prompt_area: 'classification',
+    content_tag_prompt_key: 'classify_document',
+    content_tag_prompt_return_fieldname: 'document_type',
+  },
+});
+console.log(result.contentTag); // e.g., 'invoice'
+```
+
+### Manual Tagging
+
+Tag existing files by their database record ID:
+
+```typescript
+const tagResult = await uploadExtract.tagFileContent('file-record-id');
+if (tagResult.success) {
+  console.log('Tagged as:', tagResult.data);
+}
+```
+
+### V3 Database Migration
+
+If you have an existing `hazo_files` table, run the V3 migration to add the `content_tag` column:
+
+```typescript
+import { migrateToV3, HAZO_FILES_MIGRATION_V3 } from 'hazo_files';
+
+// Using the migration helper
+await migrateToV3(
+  { run: (sql) => db.run(sql) },
+  'sqlite'
+);
+
+// Or run statements manually
+for (const stmt of HAZO_FILES_MIGRATION_V3.sqlite.alterStatements) {
+  try { await db.run(stmt); } catch { /* column exists */ }
+}
+```
+
+New tables created with `HAZO_FILES_TABLE_SCHEMA` already include the `content_tag` column.
+
 ## File Reference Tracking
 
 Track which entities (form fields, chat messages, etc.) reference each file. Multiple entities can reference the same file, enabling shared files without duplication.
@@ -1274,7 +1355,7 @@ for (const idx of HAZO_FILES_MIGRATION_V2.sqlite.indexes) {
 }
 ```
 
-New tables created with `HAZO_FILES_TABLE_SCHEMA` already include V2 columns.
+New tables created with `HAZO_FILES_TABLE_SCHEMA` already include V2 columns. For V3 content tagging migration, see [Content Tagging](#content-tagging) above.
 
 ### Reference Tracking Types
 
@@ -1332,11 +1413,24 @@ const hazoFiles = await createHazoFilesServer({
     local: { basePath: './storage' },
   },
   enableTracking: true,
-  llmFactory: (provider) => createLLM({ provider }),
+  llmFactory: {
+    create: (provider) => createLLM({ provider }),
+    invalidateCache: (area, key) => invalidate_prompt_cache(area, key), // optional
+  },
+  // Optional: enable automatic content tagging for all uploads
+  defaultContentTagConfig: {
+    content_tag_set_by_llm: true,
+    content_tag_prompt_area: 'classification',
+    content_tag_prompt_key: 'classify_document',
+    content_tag_prompt_return_fieldname: 'document_type',
+  },
 });
 
 // Access all services
-const { fileManager, metadataService, namingService, extractionService, uploadExtractService } = hazoFiles;
+const { fileManager, metadataService, namingService, extractionService, uploadExtractService, invalidatePromptCache } = hazoFiles;
+
+// Invalidate prompt cache without importing hazo_llm_api directly
+invalidatePromptCache?.('classification', 'classify_document');
 ```
 
 ## API Reference

package/dist/index.d.mts

@@ -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 };