hazo_files 1.4.2 → 1.4.3

package/dist/index.js

@@ -46,6 +46,7 @@ __export(index_exports, {
   GoogleDriveModule: () => GoogleDriveModule,
   HAZO_FILES_DEFAULT_TABLE_NAME: () => HAZO_FILES_DEFAULT_TABLE_NAME,
   HAZO_FILES_MIGRATION_V2: () => HAZO_FILES_MIGRATION_V2,
+  HAZO_FILES_MIGRATION_V3: () => HAZO_FILES_MIGRATION_V3,
   HAZO_FILES_NAMING_DEFAULT_TABLE_NAME: () => HAZO_FILES_NAMING_DEFAULT_TABLE_NAME,
   HAZO_FILES_NAMING_TABLE_SCHEMA: () => HAZO_FILES_NAMING_TABLE_SCHEMA,
   HAZO_FILES_TABLE_SCHEMA: () => HAZO_FILES_TABLE_SCHEMA,
@@ -115,6 +116,7 @@ __export(index_exports, {
   getFileMetadataValues: () => getFileMetadataValues,
   getMergedData: () => getMergedData,
   getMigrationForTable: () => getMigrationForTable,
+  getMigrationV3ForTable: () => getMigrationV3ForTable,
   getMimeType: () => getMimeType,
   getNameWithoutExtension: () => getNameWithoutExtension,
   getNamingSchemaForTable: () => getNamingSchemaForTable,
@@ -147,6 +149,7 @@ __export(index_exports, {
   loadConfig: () => loadConfig,
   loadConfigAsync: () => loadConfigAsync,
   migrateToV2: () => migrateToV2,
+  migrateToV3: () => migrateToV3,
   normalizePath: () => normalizePath,
   parseConfig: () => parseConfig,
   parseFileData: () => parseFileData,
@@ -2395,6 +2398,7 @@ var FileMetadataService = class {
       if (input.scope_id !== void 0) record.scope_id = input.scope_id;
       if (input.uploaded_by !== void 0) record.uploaded_by = input.uploaded_by;
       if (input.original_filename !== void 0) record.original_filename = input.original_filename;
+      if (input.content_tag !== void 0) record.content_tag = input.content_tag;
       const results = await this.crud.insert(record);
       this.logger?.debug?.("Recorded file upload", { path: input.file_path });
       return results[0] || null;
@@ -4229,10 +4233,11 @@ function generatePreviewName(pattern, userVariables, options = {}) {
 
 // src/services/upload-extract-service.ts
 var UploadExtractService = class {
-  constructor(fileManager, namingService, extractionService) {
+  constructor(fileManager, namingService, extractionService, defaultContentTagConfig) {
     this.fileManager = fileManager;
     this.namingService = namingService;
     this.extractionService = extractionService;
+    this.defaultContentTagConfig = defaultContentTagConfig;
   }
   /**
    * Upload a file with optional extraction and naming convention
@@ -4309,11 +4314,12 @@ var UploadExtractService = class {
         metadata.extraction_id = extractionData.id;
         metadata.extraction_source = extractionData.source;
       }
+      const effectiveContentTagConfig = options.contentTagConfig ?? this.defaultContentTagConfig;
+      const needsContentTagging = effectiveContentTagConfig?.content_tag_set_by_llm && this.extractionService && this.fileManager.isTrackingActive();
       const uploadResult = await this.fileManager.uploadFile(source, fullPath, {
         ...options,
         metadata,
-        awaitRecording: !!extractionData
-        // Await recording when extraction needs to be added
+        awaitRecording: !!extractionData || !!needsContentTagging
       });
       if (!uploadResult.success) {
         return {
@@ -4337,13 +4343,23 @@ var UploadExtractService = class {
           );
         }
       }
+      let contentTag;
+      if (needsContentTagging && effectiveContentTagConfig) {
+        contentTag = await this.performContentTagging(
+          source,
+          mimeType,
+          effectiveContentTagConfig,
+          fullPath
+        );
+      }
       return {
         success: true,
         file: uploadResult.data,
         extraction: extractionData,
         generatedPath: fullPath,
         generatedFolderPath: generatedFolderPath || void 0,
-        originalFileName
+        originalFileName,
+        contentTag
       };
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
@@ -4441,6 +4457,76 @@ var UploadExtractService = class {
       folderPath: folderPath || void 0
     };
   }
+  /**
+   * 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.
+   */
+  async performContentTagging(buffer, mimeType, config, filePath) {
+    try {
+      if (!this.extractionService) return void 0;
+      const result = await this.extractionService.extract(buffer, mimeType, {
+        promptArea: config.content_tag_prompt_area,
+        promptKey: config.content_tag_prompt_key,
+        promptVariables: config.content_tag_prompt_variables
+      });
+      if (!result.success || !result.data) return void 0;
+      const tagValue = result.data[config.content_tag_prompt_return_fieldname];
+      if (typeof tagValue !== "string" || !tagValue) return void 0;
+      const metadataService = this.fileManager.getMetadataService();
+      if (metadataService) {
+        const storageType = this.fileManager.getProvider() || "local";
+        const record = await metadataService.findByPath(filePath, storageType);
+        if (record) {
+          await metadataService.updateFields(record.id, { content_tag: tagValue });
+        }
+      }
+      return tagValue;
+    } catch {
+      return void 0;
+    }
+  }
+  /**
+   * 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
+   */
+  async tagFileContent(fileId, config) {
+    const effectiveConfig = config ?? this.defaultContentTagConfig;
+    if (!effectiveConfig || !effectiveConfig.content_tag_set_by_llm) {
+      return { success: false, error: "Content tagging is not configured or disabled" };
+    }
+    if (!this.extractionService) {
+      return { success: false, error: "Extraction service not available" };
+    }
+    const metadataService = this.fileManager.getMetadataService();
+    if (!metadataService) {
+      return { success: false, error: "Metadata service not available (tracking not enabled)" };
+    }
+    const record = await metadataService.findById(fileId);
+    if (!record) {
+      return { success: false, error: `File record not found: ${fileId}` };
+    }
+    const downloadResult = await this.fileManager.downloadFile(record.file_path);
+    if (!downloadResult.success || !downloadResult.data) {
+      return { success: false, error: `Failed to download file: ${downloadResult.error}` };
+    }
+    const buffer = Buffer.isBuffer(downloadResult.data) ? downloadResult.data : Buffer.from(downloadResult.data);
+    const mimeType = getMimeType(record.filename);
+    const tagValue = await this.performContentTagging(
+      buffer,
+      mimeType,
+      effectiveConfig,
+      record.file_path
+    );
+    if (!tagValue) {
+      return { success: false, error: "Content tagging did not produce a result" };
+    }
+    return { success: true, data: tagValue };
+  }
   /**
    * Get the file manager
    */
@@ -4460,8 +4546,8 @@ var UploadExtractService = class {
     return this.extractionService;
   }
 };
-function createUploadExtractService(fileManager, namingService, extractionService) {
-  return new UploadExtractService(fileManager, namingService, extractionService);
+function createUploadExtractService(fileManager, namingService, extractionService, defaultContentTagConfig) {
+  return new UploadExtractService(fileManager, namingService, extractionService, defaultContentTagConfig);
 }
 
 // src/schema/index.ts
@@ -4488,7 +4574,8 @@ var HAZO_FILES_TABLE_SCHEMA = {
   uploaded_by TEXT,
   storage_verified_at TEXT,
   deleted_at TEXT,
-  original_filename TEXT
+  original_filename TEXT,
+  content_tag TEXT
 )`,
     indexes: [
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_path ON hazo_files (file_path)",
@@ -4498,7 +4585,8 @@ var HAZO_FILES_TABLE_SCHEMA = {
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_status ON hazo_files (status)",
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_scope ON hazo_files (scope_id)",
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_ref_count ON hazo_files (ref_count)",
-      "CREATE INDEX IF NOT EXISTS idx_hazo_files_deleted ON hazo_files (deleted_at)"
+      "CREATE INDEX IF NOT EXISTS idx_hazo_files_deleted ON hazo_files (deleted_at)",
+      "CREATE INDEX IF NOT EXISTS idx_hazo_files_content_tag ON hazo_files (content_tag)"
     ]
   },
   postgres: {
@@ -4521,7 +4609,8 @@ var HAZO_FILES_TABLE_SCHEMA = {
   uploaded_by UUID,
   storage_verified_at TIMESTAMP WITH TIME ZONE,
   deleted_at TIMESTAMP WITH TIME ZONE,
-  original_filename TEXT
+  original_filename TEXT,
+  content_tag TEXT
 )`,
     indexes: [
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_path ON hazo_files (file_path)",
@@ -4531,7 +4620,8 @@ var HAZO_FILES_TABLE_SCHEMA = {
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_status ON hazo_files (status)",
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_scope ON hazo_files (scope_id)",
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_ref_count ON hazo_files (ref_count)",
-      "CREATE INDEX IF NOT EXISTS idx_hazo_files_deleted ON hazo_files (deleted_at)"
+      "CREATE INDEX IF NOT EXISTS idx_hazo_files_deleted ON hazo_files (deleted_at)",
+      "CREATE INDEX IF NOT EXISTS idx_hazo_files_content_tag ON hazo_files (content_tag)"
     ]
   },
   columns: [
@@ -4553,7 +4643,8 @@ var HAZO_FILES_TABLE_SCHEMA = {
     "uploaded_by",
     "storage_verified_at",
     "deleted_at",
-    "original_filename"
+    "original_filename",
+    "content_tag"
   ]
 };
 function getSchemaForTable(tableName, dbType) {
@@ -4694,6 +4785,45 @@ function getNamingSchemaForTable(tableName, dbType) {
     )
   };
 }
+var HAZO_FILES_MIGRATION_V3 = {
+  tableName: HAZO_FILES_DEFAULT_TABLE_NAME,
+  sqlite: {
+    alterStatements: [
+      "ALTER TABLE hazo_files ADD COLUMN content_tag TEXT"
+    ],
+    indexes: [
+      "CREATE INDEX IF NOT EXISTS idx_hazo_files_content_tag ON hazo_files (content_tag)"
+    ],
+    backfill: ""
+    // No backfill needed — column is nullable, defaults to NULL
+  },
+  postgres: {
+    alterStatements: [
+      "ALTER TABLE hazo_files ADD COLUMN IF NOT EXISTS content_tag TEXT"
+    ],
+    indexes: [
+      "CREATE INDEX IF NOT EXISTS idx_hazo_files_content_tag ON hazo_files (content_tag)"
+    ],
+    backfill: ""
+    // No backfill needed — column is nullable, defaults to NULL
+  },
+  newColumns: [
+    "content_tag"
+  ]
+};
+function getMigrationV3ForTable(tableName, dbType) {
+  const migration = HAZO_FILES_MIGRATION_V3[dbType];
+  const defaultName = HAZO_FILES_MIGRATION_V3.tableName;
+  return {
+    alterStatements: migration.alterStatements.map(
+      (stmt) => stmt.replace(new RegExp(defaultName, "g"), tableName)
+    ),
+    indexes: migration.indexes.map(
+      (idx) => idx.replace(new RegExp(defaultName, "g"), tableName)
+    ),
+    backfill: migration.backfill
+  };
+}
 
 // src/migrations/add-reference-tracking.ts
 async function migrateToV2(executor, dbType, tableName) {
@@ -4712,6 +4842,20 @@ async function backfillV2Defaults(executor, dbType, tableName) {
   const migration = tableName ? getMigrationForTable(tableName, dbType) : HAZO_FILES_MIGRATION_V2[dbType];
   await executor.run(migration.backfill);
 }
+
+// src/migrations/add-content-tag.ts
+async function migrateToV3(executor, dbType, tableName) {
+  const migration = tableName ? getMigrationV3ForTable(tableName, dbType) : HAZO_FILES_MIGRATION_V3[dbType];
+  for (const stmt of migration.alterStatements) {
+    try {
+      await executor.run(stmt);
+    } catch {
+    }
+  }
+  for (const idx of migration.indexes) {
+    await executor.run(idx);
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ALL_SYSTEM_VARIABLES,
@@ -4730,6 +4874,7 @@ async function backfillV2Defaults(executor, dbType, tableName) {
   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,
@@ -4799,6 +4944,7 @@ async function backfillV2Defaults(executor, dbType, tableName) {
   getFileMetadataValues,
   getMergedData,
   getMigrationForTable,
+  getMigrationV3ForTable,
   getMimeType,
   getNameWithoutExtension,
   getNamingSchemaForTable,
@@ -4831,6 +4977,7 @@ async function backfillV2Defaults(executor, dbType, tableName) {
   loadConfig,
   loadConfigAsync,
   migrateToV2,
+  migrateToV3,
   normalizePath,
   parseConfig,
   parseFileData,

package/dist/index.mjs

@@ -2219,6 +2219,7 @@ var FileMetadataService = class {
       if (input.scope_id !== void 0) record.scope_id = input.scope_id;
       if (input.uploaded_by !== void 0) record.uploaded_by = input.uploaded_by;
       if (input.original_filename !== void 0) record.original_filename = input.original_filename;
+      if (input.content_tag !== void 0) record.content_tag = input.content_tag;
       const results = await this.crud.insert(record);
       this.logger?.debug?.("Recorded file upload", { path: input.file_path });
       return results[0] || null;
@@ -4053,10 +4054,11 @@ function generatePreviewName(pattern, userVariables, options = {}) {
 
 // src/services/upload-extract-service.ts
 var UploadExtractService = class {
-  constructor(fileManager, namingService, extractionService) {
+  constructor(fileManager, namingService, extractionService, defaultContentTagConfig) {
     this.fileManager = fileManager;
     this.namingService = namingService;
     this.extractionService = extractionService;
+    this.defaultContentTagConfig = defaultContentTagConfig;
   }
   /**
    * Upload a file with optional extraction and naming convention
@@ -4133,11 +4135,12 @@ var UploadExtractService = class {
         metadata.extraction_id = extractionData.id;
         metadata.extraction_source = extractionData.source;
       }
+      const effectiveContentTagConfig = options.contentTagConfig ?? this.defaultContentTagConfig;
+      const needsContentTagging = effectiveContentTagConfig?.content_tag_set_by_llm && this.extractionService && this.fileManager.isTrackingActive();
       const uploadResult = await this.fileManager.uploadFile(source, fullPath, {
         ...options,
         metadata,
-        awaitRecording: !!extractionData
-        // Await recording when extraction needs to be added
+        awaitRecording: !!extractionData || !!needsContentTagging
       });
       if (!uploadResult.success) {
         return {
@@ -4161,13 +4164,23 @@ var UploadExtractService = class {
           );
         }
       }
+      let contentTag;
+      if (needsContentTagging && effectiveContentTagConfig) {
+        contentTag = await this.performContentTagging(
+          source,
+          mimeType,
+          effectiveContentTagConfig,
+          fullPath
+        );
+      }
       return {
         success: true,
         file: uploadResult.data,
         extraction: extractionData,
         generatedPath: fullPath,
         generatedFolderPath: generatedFolderPath || void 0,
-        originalFileName
+        originalFileName,
+        contentTag
       };
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
@@ -4265,6 +4278,76 @@ var UploadExtractService = class {
       folderPath: folderPath || void 0
     };
   }
+  /**
+   * 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.
+   */
+  async performContentTagging(buffer, mimeType, config, filePath) {
+    try {
+      if (!this.extractionService) return void 0;
+      const result = await this.extractionService.extract(buffer, mimeType, {
+        promptArea: config.content_tag_prompt_area,
+        promptKey: config.content_tag_prompt_key,
+        promptVariables: config.content_tag_prompt_variables
+      });
+      if (!result.success || !result.data) return void 0;
+      const tagValue = result.data[config.content_tag_prompt_return_fieldname];
+      if (typeof tagValue !== "string" || !tagValue) return void 0;
+      const metadataService = this.fileManager.getMetadataService();
+      if (metadataService) {
+        const storageType = this.fileManager.getProvider() || "local";
+        const record = await metadataService.findByPath(filePath, storageType);
+        if (record) {
+          await metadataService.updateFields(record.id, { content_tag: tagValue });
+        }
+      }
+      return tagValue;
+    } catch {
+      return void 0;
+    }
+  }
+  /**
+   * 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
+   */
+  async tagFileContent(fileId, config) {
+    const effectiveConfig = config ?? this.defaultContentTagConfig;
+    if (!effectiveConfig || !effectiveConfig.content_tag_set_by_llm) {
+      return { success: false, error: "Content tagging is not configured or disabled" };
+    }
+    if (!this.extractionService) {
+      return { success: false, error: "Extraction service not available" };
+    }
+    const metadataService = this.fileManager.getMetadataService();
+    if (!metadataService) {
+      return { success: false, error: "Metadata service not available (tracking not enabled)" };
+    }
+    const record = await metadataService.findById(fileId);
+    if (!record) {
+      return { success: false, error: `File record not found: ${fileId}` };
+    }
+    const downloadResult = await this.fileManager.downloadFile(record.file_path);
+    if (!downloadResult.success || !downloadResult.data) {
+      return { success: false, error: `Failed to download file: ${downloadResult.error}` };
+    }
+    const buffer = Buffer.isBuffer(downloadResult.data) ? downloadResult.data : Buffer.from(downloadResult.data);
+    const mimeType = getMimeType(record.filename);
+    const tagValue = await this.performContentTagging(
+      buffer,
+      mimeType,
+      effectiveConfig,
+      record.file_path
+    );
+    if (!tagValue) {
+      return { success: false, error: "Content tagging did not produce a result" };
+    }
+    return { success: true, data: tagValue };
+  }
   /**
    * Get the file manager
    */
@@ -4284,8 +4367,8 @@ var UploadExtractService = class {
     return this.extractionService;
   }
 };
-function createUploadExtractService(fileManager, namingService, extractionService) {
-  return new UploadExtractService(fileManager, namingService, extractionService);
+function createUploadExtractService(fileManager, namingService, extractionService, defaultContentTagConfig) {
+  return new UploadExtractService(fileManager, namingService, extractionService, defaultContentTagConfig);
 }
 
 // src/schema/index.ts
@@ -4312,7 +4395,8 @@ var HAZO_FILES_TABLE_SCHEMA = {
   uploaded_by TEXT,
   storage_verified_at TEXT,
   deleted_at TEXT,
-  original_filename TEXT
+  original_filename TEXT,
+  content_tag TEXT
 )`,
     indexes: [
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_path ON hazo_files (file_path)",
@@ -4322,7 +4406,8 @@ var HAZO_FILES_TABLE_SCHEMA = {
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_status ON hazo_files (status)",
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_scope ON hazo_files (scope_id)",
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_ref_count ON hazo_files (ref_count)",
-      "CREATE INDEX IF NOT EXISTS idx_hazo_files_deleted ON hazo_files (deleted_at)"
+      "CREATE INDEX IF NOT EXISTS idx_hazo_files_deleted ON hazo_files (deleted_at)",
+      "CREATE INDEX IF NOT EXISTS idx_hazo_files_content_tag ON hazo_files (content_tag)"
     ]
   },
   postgres: {
@@ -4345,7 +4430,8 @@ var HAZO_FILES_TABLE_SCHEMA = {
   uploaded_by UUID,
   storage_verified_at TIMESTAMP WITH TIME ZONE,
   deleted_at TIMESTAMP WITH TIME ZONE,
-  original_filename TEXT
+  original_filename TEXT,
+  content_tag TEXT
 )`,
     indexes: [
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_path ON hazo_files (file_path)",
@@ -4355,7 +4441,8 @@ var HAZO_FILES_TABLE_SCHEMA = {
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_status ON hazo_files (status)",
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_scope ON hazo_files (scope_id)",
       "CREATE INDEX IF NOT EXISTS idx_hazo_files_ref_count ON hazo_files (ref_count)",
-      "CREATE INDEX IF NOT EXISTS idx_hazo_files_deleted ON hazo_files (deleted_at)"
+      "CREATE INDEX IF NOT EXISTS idx_hazo_files_deleted ON hazo_files (deleted_at)",
+      "CREATE INDEX IF NOT EXISTS idx_hazo_files_content_tag ON hazo_files (content_tag)"
     ]
   },
   columns: [
@@ -4377,7 +4464,8 @@ var HAZO_FILES_TABLE_SCHEMA = {
     "uploaded_by",
     "storage_verified_at",
     "deleted_at",
-    "original_filename"
+    "original_filename",
+    "content_tag"
   ]
 };
 function getSchemaForTable(tableName, dbType) {
@@ -4518,6 +4606,45 @@ function getNamingSchemaForTable(tableName, dbType) {
     )
   };
 }
+var HAZO_FILES_MIGRATION_V3 = {
+  tableName: HAZO_FILES_DEFAULT_TABLE_NAME,
+  sqlite: {
+    alterStatements: [
+      "ALTER TABLE hazo_files ADD COLUMN content_tag TEXT"
+    ],
+    indexes: [
+      "CREATE INDEX IF NOT EXISTS idx_hazo_files_content_tag ON hazo_files (content_tag)"
+    ],
+    backfill: ""
+    // No backfill needed — column is nullable, defaults to NULL
+  },
+  postgres: {
+    alterStatements: [
+      "ALTER TABLE hazo_files ADD COLUMN IF NOT EXISTS content_tag TEXT"
+    ],
+    indexes: [
+      "CREATE INDEX IF NOT EXISTS idx_hazo_files_content_tag ON hazo_files (content_tag)"
+    ],
+    backfill: ""
+    // No backfill needed — column is nullable, defaults to NULL
+  },
+  newColumns: [
+    "content_tag"
+  ]
+};
+function getMigrationV3ForTable(tableName, dbType) {
+  const migration = HAZO_FILES_MIGRATION_V3[dbType];
+  const defaultName = HAZO_FILES_MIGRATION_V3.tableName;
+  return {
+    alterStatements: migration.alterStatements.map(
+      (stmt) => stmt.replace(new RegExp(defaultName, "g"), tableName)
+    ),
+    indexes: migration.indexes.map(
+      (idx) => idx.replace(new RegExp(defaultName, "g"), tableName)
+    ),
+    backfill: migration.backfill
+  };
+}
 
 // src/migrations/add-reference-tracking.ts
 async function migrateToV2(executor, dbType, tableName) {
@@ -4536,6 +4663,20 @@ async function backfillV2Defaults(executor, dbType, tableName) {
   const migration = tableName ? getMigrationForTable(tableName, dbType) : HAZO_FILES_MIGRATION_V2[dbType];
   await executor.run(migration.backfill);
 }
+
+// src/migrations/add-content-tag.ts
+async function migrateToV3(executor, dbType, tableName) {
+  const migration = tableName ? getMigrationV3ForTable(tableName, dbType) : HAZO_FILES_MIGRATION_V3[dbType];
+  for (const stmt of migration.alterStatements) {
+    try {
+      await executor.run(stmt);
+    } catch {
+    }
+  }
+  for (const idx of migration.indexes) {
+    await executor.run(idx);
+  }
+}
 export {
   ALL_SYSTEM_VARIABLES,
   AuthenticationError,
@@ -4553,6 +4694,7 @@ export {
   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,
@@ -4622,6 +4764,7 @@ export {
   getFileMetadataValues,
   getMergedData,
   getMigrationForTable,
+  getMigrationV3ForTable,
   getMimeType,
   getNameWithoutExtension,
   getNamingSchemaForTable,
@@ -4654,6 +4797,7 @@ export {
   loadConfig,
   loadConfigAsync,
   migrateToV2,
+  migrateToV3,
   normalizePath,
   parseConfig,
   parseFileData,