Error Classes

import {
  VectoriaError,
  VectoriaNotInitializedError,
  DocumentValidationError,
  DocumentNotFoundError,
  DocumentExistsError,
  DuplicateDocumentError,
  QueryValidationError,
  EmbeddingError,
  StorageError,
  ConfigurationError,
} from 'vectoriadb';

class VectoriaError extends Error {
  readonly code: string;

  constructor(message: string, code: string);
}

class VectoriaNotInitializedError extends VectoriaError {
  constructor(operation: string);
}

try {
  await db.add('id', 'text', metadata);
} catch (error) {
  if (error instanceof VectoriaNotInitializedError) {
    await db.initialize();
    await db.add('id', 'text', metadata);
  }
}

class DocumentValidationError extends VectoriaError {
  readonly documentId?: string;

  constructor(message: string, documentId?: string);
}

class DocumentNotFoundError extends VectoriaError {
  readonly documentId: string;

  constructor(documentId: string);
}

class DocumentExistsError extends VectoriaError {
  readonly documentId: string;

  constructor(documentId: string);
}

class DuplicateDocumentError extends VectoriaError {
  readonly documentId: string;
  readonly context: 'batch' | 'existing';

  constructor(documentId: string, context: 'batch' | 'existing');
}

class QueryValidationError extends VectoriaError {
  constructor(message: string);
}

class EmbeddingError extends VectoriaError {
  readonly details?: any;

  constructor(message: string, details?: any);
}

class StorageError extends VectoriaError {
  readonly originalError?: Error;

  constructor(message: string, originalError?: Error);
}

class ConfigurationError extends VectoriaError {
  constructor(message: string);
}

try {
  await db.addMany(documents);
} catch (error) {
  if (error instanceof VectoriaNotInitializedError) {
    await db.initialize();
    return; // Retry
  }

  if (error instanceof DocumentValidationError) {
    console.warn(`Invalid document: ${error.documentId}`);
    return;
  }

  if (error instanceof VectoriaError) {
    console.error(`VectoriaDB error [${error.code}]:`, error.message);
    return;
  }

  throw error; // Re-throw unexpected errors
}