Error Classes

BucketDBError

Base error class for all BucketDB errors.

class BucketDBError extends Error {
  constructor(message: string);
}

DocumentNotFoundError

Document not found error.

class DocumentNotFoundError extends BucketDBError {
  constructor(id: string);
}

Example:

try {
  await users.findById('non-existent');
} catch (error) {
  if (error instanceof DocumentNotFoundError) {
    console.log('Document not found');
  }
}

ConcurrentUpdateError

Concurrent update conflict error (ETag mismatch).

class ConcurrentUpdateError extends BucketDBError {
  constructor(message?: string);
}

Example:

try {
  await users.update('user-123', { age: 26 }, { etag: 'old-etag' });
} catch (error) {
  if (error instanceof ConcurrentUpdateError) {
    console.log('Concurrent update conflict, retry');
  }
}

ValidationError

Validation error.

class ValidationError extends BucketDBError {
  constructor(message: string);
}

StorageError

Storage operation error.

class StorageError extends BucketDBError {
  constructor(message: string, cause?: Error);
  readonly cause?: Error;
}

---