feat(utils): enhance storage error handling and logging

- Add comprehensive error class hierarchy for storage operations
- Implement structured error conversion for IndexedDB operations
- Add input validation to prevent invalid data operations
- Enhance error logging with detailed context and metadata
- Improve error boundary integration in main application

Classes added:
- StorageError (abstract base)
- IndexedDBError, QuotaExceededError, NotFoundError
- ValidationError, ConnectionError, OperationAbortedError

Utility functions:
- isStorageError() type guard
- convertIndexedDBError() for structured error handling

Author: Mearman

packages/utils/src/storage/dexie-storage-provider.ts

@@ -15,12 +15,7 @@ import type { CatalogueEntity,CatalogueList } from './catalogue-db.js';
 import { CatalogueService } from './catalogue-db.js';
 import type { AddBookmarkParams, AddEntityParams, AddToHistoryParams, BatchAddResult, CatalogueStorageProvider, CreateListParams, ListStats, ShareAccessResult } from './catalogue-storage-provider.js';
 import {
-	ConnectionError,
 	convertIndexedDBError,
-	IndexedDBError,
-	NotFoundError,
-	OperationAbortedError,
-	QuotaExceededError,
 	ValidationError,
 } from './errors.js';
 

packages/utils/src/storage/errors.ts

@@ -103,18 +103,20 @@ export class OperationAbortedError extends StorageError {
 
 /**
  * Utility function to determine if an error is a storage error
+ * @param error - The error to check
  */
-export function isStorageError(error: unknown): error is StorageError {
-  return error instanceof StorageError;
-}
+export const isStorageError = (error: unknown): error is StorageError =>
+  error instanceof StorageError;
 
 /**
  * Utility function to convert IndexedDB errors to structured storage errors
+ * @param operation - The operation that failed
+ * @param error - The original error
  */
-export function convertIndexedDBError(
+export const convertIndexedDBError = (
   operation: string,
   error: unknown
-): StorageError {
+): StorageError => {
   if (isStorageError(error)) {
     return error;
   }
@@ -148,4 +150,4 @@ export function convertIndexedDBError(
   }
 
   return new IndexedDBError(operation, new Error(String(error)));
-}
+};