Storage Methods

async saveToStorage(): Promise<void>

await db.addMany(documents);
await db.saveToStorage();

async clearStorage(): Promise<void>

// Force re-index on next startup
await db.clearStorage();

async close(): Promise<void>

// Graceful shutdown
await db.saveToStorage();
await db.close();

isInitialized(): boolean

if (!db.isInitialized()) {
  await db.initialize();
}

import { VectoriaDB, FileStorageAdapter, SerializationUtils } from 'vectoriadb';

async function setupDB(documents: Document[]) {
  const db = new VectoriaDB({
    storageAdapter: new FileStorageAdapter({
      cacheDir: './.cache/vectoriadb',
    }),
    toolsHash: SerializationUtils.createToolsHash(documents),
    version: '1.0.0',
  });

  await db.initialize();

  // Check if cache was loaded
  if (db.size() === 0) {
    await db.addMany(documents);
    await db.saveToStorage();
  }

  return db;
}

// Graceful shutdown
process.on('SIGTERM', async () => {
  await db.saveToStorage();
  await db.close();
  process.exit(0);
});

import { StorageError } from 'vectoriadb';

try {
  await db.saveToStorage();
} catch (error) {
  if (error instanceof StorageError) {
    console.warn('Storage failed, continuing in-memory:', error.message);
  }
}