File Storage Adapter

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

const documents = collectToolDocuments();

const toolIndex = new VectoriaDB<ToolDocument>({
  storageAdapter: new FileStorageAdapter({
    cacheDir: './.cache/vectoriadb',
    namespace: 'tool-index',
  }),
  toolsHash: SerializationUtils.createToolsHash(documents),
  version: process.env.npm_package_version,
});

await toolIndex.initialize();

if (toolIndex.size() === 0) {
  await toolIndex.addMany(documents);
  await toolIndex.saveToStorage(); // Persist to disk
}

import * as fs from 'fs/promises';

// Create cache directory if it doesn't exist
await fs.mkdir('./.cache/vectoriadb', { recursive: true });

const db = new VectoriaDB({
  storageAdapter: new FileStorageAdapter({
    cacheDir: './.cache/vectoriadb',
  }),
});

import { StorageError } from 'vectoriadb';

try {
  await db.saveToStorage();
} catch (error) {
  if (error instanceof StorageError) {
    console.error('Failed to save:', error.message);

    // Common issues:
    // - Permission denied
    // - Disk full
    // - Path doesn't exist
  }
}

// These are sanitized automatically:
const adapter = new FileStorageAdapter({
  namespace: '../../../etc/passwd', // Sanitized to safe string
});

services:
  app:
    volumes:
      - vectoria-cache:/app/.cache/vectoriadb

volumes:
  vectoria-cache: