hazo_files 2.1.1 → 3.0.0

package/CHANGE_LOG.md

@@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 3.0.0 — 2026-05-29
+
+### Breaking changes (Wave 2 standardisation)
+
+- **Required peer dep:** `hazo_core ^1.0.0`. Provides `HazoError` hierarchy, structured logger, and `withContext()` correlation propagation.
+- **Cross-hazo peer-dep major bumps:** `hazo_connect ^3.0.0` (was `^2.7.3`), `hazo_llm_api ^2.0.0` (was `^1.3.0`). Consumers using these alongside `hazo_files` must upgrade them together.
+- **Error API surface:** the 12 `HazoFilesError` subclasses (`FileNotFoundError`, `FileTooLargeError`, etc.) now extend `HazoError` from `hazo_core` and carry `HAZO_FILES_*` codes. Catch sites that used `instanceof HazoFilesError` continue to work; catch sites that matched `error.message` text should switch to `.code`.
+
+### Internal changes
+
+- Default logger resolves to `createLogger('hazo_files')` from `hazo_core` (delegates to `hazo_logs`).
+- Google Drive adapter outbound API calls and `LLMExtractionService` provider calls use `fetchWithRequestId()` so `x-request-id` propagates.
+- `TrackedFileManager` operations run inside `withContext({ correlationId })` per call so DB writes and storage writes share the same correlation ID.
+
+### Migration
+
+1. `npm install hazo_core@^1.0.0`.
+2. Upgrade `hazo_connect` to `^3.0.0` and `hazo_llm_api` to `^2.0.0` if you depend on them.
+3. No public API method signatures changed — `FileManager` and `TrackedFileManager` methods keep their existing call shape.
+
 ## 2.1.1 — 2026-05-24
 
 **Docs + housekeeping** — no API changes.

package/config/hazo_files_config.ini.sample

@@ -42,3 +42,14 @@ root_path =
 ; Comma-separated list of supported date format tokens for naming rules
 ; Available: YYYY, YY, MM, M, DD, D, MMM, MMMM, YYYY-MM-DD, YYYY-MMM-DD, DD-MM-YYYY, MM-DD-YYYY
 date_formats = YYYY,YY,MM,M,DD,D,MMM,MMMM,YYYY-MM-DD,YYYY-MMM-DD,DD-MM-YYYY,MM-DD-YYYY
+
+[log.overrides]
+; Override log levels per namespace. Format: namespace = TRACE|DEBUG|INFO|WARN|ERROR
+; Example:
+; hazo_files.metadata = DEBUG
+; hazo_files.naming = WARN
+
+[env]
+; Set HAZO_ENV to control which overlay config file is loaded
+; e.g. HAZO_ENV=production loads hazo_files_config.production.ini as an overlay
+; hazo_env = production

package/dist/background-upload/index.js

@@ -57,6 +57,7 @@ var TypedEventEmitter = class {
 };
 
 // src/background_upload/core/job.ts
+var import_hazo_core = require("hazo_core");
 var Job = class {
   constructor(init) {
     this.status = "queued";
@@ -64,7 +65,7 @@ var Job = class {
     this.error = null;
     this.confirmation_payload = null;
     this.confirmation_resolve = null;
-    this.job_id = crypto.randomUUID();
+    this.job_id = (0, import_hazo_core.generateRequestId)().slice(4);
     this.batch_id = init.batch_id;
     this.created_at = Date.now();
     this.updated_at = this.created_at;
@@ -183,6 +184,7 @@ var PipelineExecutor = class {
 };
 
 // src/background_upload/core/upload-manager.ts
+var import_hazo_core2 = require("hazo_core");
 var UploadManager = class {
   constructor(config) {
     this.jobs = /* @__PURE__ */ new Map();
@@ -204,7 +206,7 @@ var UploadManager = class {
   }
   submit_batch(options) {
     if (this.destroyed) throw new Error("UploadManager is destroyed");
-    const batch_id = crypto.randomUUID();
+    const batch_id = (0, import_hazo_core2.generateRequestId)().slice(4);
     const job_ids = [];
     const pipeline_steps = options.pipeline_steps ?? this.config.default_pipeline_steps;
     for (const file of options.files) {

package/dist/background-upload/index.mjs

@@ -28,6 +28,7 @@ var TypedEventEmitter = class {
 };
 
 // src/background_upload/core/job.ts
+import { generateRequestId } from "hazo_core";
 var Job = class {
   constructor(init) {
     this.status = "queued";
@@ -35,7 +36,7 @@ var Job = class {
     this.error = null;
     this.confirmation_payload = null;
     this.confirmation_resolve = null;
-    this.job_id = crypto.randomUUID();
+    this.job_id = generateRequestId().slice(4);
     this.batch_id = init.batch_id;
     this.created_at = Date.now();
     this.updated_at = this.created_at;
@@ -154,6 +155,7 @@ var PipelineExecutor = class {
 };
 
 // src/background_upload/core/upload-manager.ts
+import { generateRequestId as generateRequestId2 } from "hazo_core";
 var UploadManager = class {
   constructor(config) {
     this.jobs = /* @__PURE__ */ new Map();
@@ -175,7 +177,7 @@ var UploadManager = class {
   }
   submit_batch(options) {
     if (this.destroyed) throw new Error("UploadManager is destroyed");
-    const batch_id = crypto.randomUUID();
+    const batch_id = generateRequestId2().slice(4);
     const job_ids = [];
     const pipeline_steps = options.pipeline_steps ?? this.config.default_pipeline_steps;
     for (const file of options.files) {

package/dist/background-upload/react/index.js

@@ -41,7 +41,11 @@ module.exports = __toCommonJS(index_exports);
 // src/background_upload/react/provider.tsx
 var import_react3 = require("react");
 
+// src/background_upload/core/upload-manager.ts
+var import_hazo_core2 = require("hazo_core");
+
 // src/background_upload/core/job.ts
+var import_hazo_core = require("hazo_core");
 var Job = class {
   constructor(init) {
     this.status = "queued";
@@ -49,7 +53,7 @@ var Job = class {
     this.error = null;
     this.confirmation_payload = null;
     this.confirmation_resolve = null;
-    this.job_id = crypto.randomUUID();
+    this.job_id = (0, import_hazo_core.generateRequestId)().slice(4);
     this.batch_id = init.batch_id;
     this.created_at = Date.now();
     this.updated_at = this.created_at;
@@ -218,7 +222,7 @@ var UploadManager = class {
   }
   submit_batch(options) {
     if (this.destroyed) throw new Error("UploadManager is destroyed");
-    const batch_id = crypto.randomUUID();
+    const batch_id = (0, import_hazo_core2.generateRequestId)().slice(4);
     const job_ids = [];
     const pipeline_steps = options.pipeline_steps ?? this.config.default_pipeline_steps;
     for (const file of options.files) {

package/dist/background-upload/react/index.mjs

@@ -1,7 +1,11 @@
 // src/background_upload/react/provider.tsx
 import { useRef, useEffect as useEffect2 } from "react";
 
+// src/background_upload/core/upload-manager.ts
+import { generateRequestId as generateRequestId2 } from "hazo_core";
+
 // src/background_upload/core/job.ts
+import { generateRequestId } from "hazo_core";
 var Job = class {
   constructor(init) {
     this.status = "queued";
@@ -9,7 +13,7 @@ var Job = class {
     this.error = null;
     this.confirmation_payload = null;
     this.confirmation_resolve = null;
-    this.job_id = crypto.randomUUID();
+    this.job_id = generateRequestId().slice(4);
     this.batch_id = init.batch_id;
     this.created_at = Date.now();
     this.updated_at = this.created_at;
@@ -178,7 +182,7 @@ var UploadManager = class {
   }
   submit_batch(options) {
     if (this.destroyed) throw new Error("UploadManager is destroyed");
-    const batch_id = crypto.randomUUID();
+    const batch_id = generateRequestId2().slice(4);
     const job_ids = [];
     const pipeline_steps = options.pipeline_steps ?? this.config.default_pipeline_steps;
     for (const file of options.files) {

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import { HazoAuthError, HazoConfigError, HazoConflictError, HazoNotFoundError, HazoValidationError, HazoExternalError } from 'hazo_core';
+export { HazoError as HazoFilesError } from 'hazo_core';
 import { Readable } from 'node:stream';
 import { OAuth2Client } from 'google-auth-library';
 
@@ -2871,46 +2873,43 @@ declare function registerModule(provider: StorageProvider, factory: ModuleFactor
 
 /**
  * Custom error classes for hazo_files
+ * All errors extend the appropriate hazo_core subclass.
  */
-declare class HazoFilesError extends Error {
-    code: string;
-    details?: Record<string, unknown> | undefined;
-    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
-}
-declare class FileNotFoundError extends HazoFilesError {
+
+declare class FileNotFoundError extends HazoNotFoundError {
     constructor(path: string);
 }
-declare class DirectoryNotFoundError extends HazoFilesError {
+declare class DirectoryNotFoundError extends HazoNotFoundError {
     constructor(path: string);
 }
-declare class FileExistsError extends HazoFilesError {
+declare class FileExistsError extends HazoConflictError {
     constructor(path: string);
 }
-declare class DirectoryExistsError extends HazoFilesError {
+declare class DirectoryExistsError extends HazoConflictError {
     constructor(path: string);
 }
-declare class DirectoryNotEmptyError extends HazoFilesError {
+declare class DirectoryNotEmptyError extends HazoConflictError {
     constructor(path: string);
 }
-declare class PermissionDeniedError extends HazoFilesError {
+declare class PermissionDeniedError extends HazoAuthError {
     constructor(path: string, operation: string);
 }
-declare class InvalidPathError extends HazoFilesError {
+declare class InvalidPathError extends HazoValidationError {
     constructor(path: string, reason: string);
 }
-declare class FileTooLargeError extends HazoFilesError {
+declare class FileTooLargeError extends HazoValidationError {
     constructor(path: string, size: number, maxSize: number);
 }
-declare class InvalidExtensionError extends HazoFilesError {
+declare class InvalidExtensionError extends HazoValidationError {
     constructor(path: string, extension: string, allowedExtensions: string[]);
 }
-declare class AuthenticationError extends HazoFilesError {
+declare class AuthenticationError extends HazoAuthError {
     constructor(provider: string, message: string);
 }
-declare class ConfigurationError extends HazoFilesError {
+declare class ConfigurationError extends HazoConfigError {
     constructor(message: string);
 }
-declare class OperationError extends HazoFilesError {
+declare class OperationError extends HazoExternalError {
     constructor(operation: string, message: string, details?: Record<string, unknown>);
 }
 
@@ -3371,4 +3370,4 @@ declare function addRef<T extends FileWithRefs>(file: T, ref: FileRef): T;
 declare function removeRef<T extends FileWithRefs>(file: T, ref_id: string, removed_at: string): T;
 declare function countRefs(file: Pick<FileWithRefs, "file_refs">): number;
 
-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$1 as FileRef, type FileRefVisibility, type FileStatus, type FileSystemItem, FileTooLargeError, type FileWithRefs, 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, NamingTemplate, 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, type WriteWithCollisionOpts, addExtractionToFileData, addRef, backfillV2Defaults, buildFileWithStatus, clearExtractions, clonePattern, computeFileHash, computeFileHashFromStream, computeFileHashSync, computeFileInfo, countRefs, 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, removeRef, removeRefFromArray, removeRefsByCriteriaFromArray, sanitizeFilename, saveConfig, sortItems, stringifyFileData, stringifyFileRefs, successResult, toV2Record, updateExtractionById, validateExtractionData, validateFileDataStructure, validateNamingRuleSchema, validatePath, writeWithCollisionRetry };
+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$1 as FileRef, type FileRefVisibility, type FileStatus, type FileSystemItem, FileTooLargeError, type FileWithRefs, 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, 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, NamingTemplate, 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, type WriteWithCollisionOpts, addExtractionToFileData, addRef, backfillV2Defaults, buildFileWithStatus, clearExtractions, clonePattern, computeFileHash, computeFileHashFromStream, computeFileHashSync, computeFileInfo, countRefs, 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, removeRef, removeRefFromArray, removeRefsByCriteriaFromArray, sanitizeFilename, saveConfig, sortItems, stringifyFileData, stringifyFileRefs, successResult, toV2Record, updateExtractionById, validateExtractionData, validateFileDataStructure, validateNamingRuleSchema, validatePath, writeWithCollisionRetry };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { HazoAuthError, HazoConfigError, HazoConflictError, HazoNotFoundError, HazoValidationError, HazoExternalError } from 'hazo_core';
+export { HazoError as HazoFilesError } from 'hazo_core';
 import { Readable } from 'node:stream';
 import { OAuth2Client } from 'google-auth-library';
 
@@ -2871,46 +2873,43 @@ declare function registerModule(provider: StorageProvider, factory: ModuleFactor
 
 /**
  * Custom error classes for hazo_files
+ * All errors extend the appropriate hazo_core subclass.
  */
-declare class HazoFilesError extends Error {
-    code: string;
-    details?: Record<string, unknown> | undefined;
-    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
-}
-declare class FileNotFoundError extends HazoFilesError {
+
+declare class FileNotFoundError extends HazoNotFoundError {
     constructor(path: string);
 }
-declare class DirectoryNotFoundError extends HazoFilesError {
+declare class DirectoryNotFoundError extends HazoNotFoundError {
     constructor(path: string);
 }
-declare class FileExistsError extends HazoFilesError {
+declare class FileExistsError extends HazoConflictError {
     constructor(path: string);
 }
-declare class DirectoryExistsError extends HazoFilesError {
+declare class DirectoryExistsError extends HazoConflictError {
     constructor(path: string);
 }
-declare class DirectoryNotEmptyError extends HazoFilesError {
+declare class DirectoryNotEmptyError extends HazoConflictError {
     constructor(path: string);
 }
-declare class PermissionDeniedError extends HazoFilesError {
+declare class PermissionDeniedError extends HazoAuthError {
     constructor(path: string, operation: string);
 }
-declare class InvalidPathError extends HazoFilesError {
+declare class InvalidPathError extends HazoValidationError {
     constructor(path: string, reason: string);
 }
-declare class FileTooLargeError extends HazoFilesError {
+declare class FileTooLargeError extends HazoValidationError {
     constructor(path: string, size: number, maxSize: number);
 }
-declare class InvalidExtensionError extends HazoFilesError {
+declare class InvalidExtensionError extends HazoValidationError {
     constructor(path: string, extension: string, allowedExtensions: string[]);
 }
-declare class AuthenticationError extends HazoFilesError {
+declare class AuthenticationError extends HazoAuthError {
     constructor(provider: string, message: string);
 }
-declare class ConfigurationError extends HazoFilesError {
+declare class ConfigurationError extends HazoConfigError {
     constructor(message: string);
 }
-declare class OperationError extends HazoFilesError {
+declare class OperationError extends HazoExternalError {
     constructor(operation: string, message: string, details?: Record<string, unknown>);
 }
 
@@ -3371,4 +3370,4 @@ declare function addRef<T extends FileWithRefs>(file: T, ref: FileRef): T;
 declare function removeRef<T extends FileWithRefs>(file: T, ref_id: string, removed_at: string): T;
 declare function countRefs(file: Pick<FileWithRefs, "file_refs">): number;
 
-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$1 as FileRef, type FileRefVisibility, type FileStatus, type FileSystemItem, FileTooLargeError, type FileWithRefs, 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, NamingTemplate, 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, type WriteWithCollisionOpts, addExtractionToFileData, addRef, backfillV2Defaults, buildFileWithStatus, clearExtractions, clonePattern, computeFileHash, computeFileHashFromStream, computeFileHashSync, computeFileInfo, countRefs, 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, removeRef, removeRefFromArray, removeRefsByCriteriaFromArray, sanitizeFilename, saveConfig, sortItems, stringifyFileData, stringifyFileRefs, successResult, toV2Record, updateExtractionById, validateExtractionData, validateFileDataStructure, validateNamingRuleSchema, validatePath, writeWithCollisionRetry };
+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$1 as FileRef, type FileRefVisibility, type FileStatus, type FileSystemItem, FileTooLargeError, type FileWithRefs, 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, 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, NamingTemplate, 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, type WriteWithCollisionOpts, addExtractionToFileData, addRef, backfillV2Defaults, buildFileWithStatus, clearExtractions, clonePattern, computeFileHash, computeFileHashFromStream, computeFileHashSync, computeFileInfo, countRefs, 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, removeRef, removeRefFromArray, removeRefsByCriteriaFromArray, sanitizeFilename, saveConfig, sortItems, stringifyFileData, stringifyFileRefs, successResult, toV2Record, updateExtractionById, validateExtractionData, validateFileDataStructure, validateNamingRuleSchema, validatePath, writeWithCollisionRetry };