universal_storage_interface 0.1.0-dev.10

Interfaces and core models for universal storage providers (file, VCS, cloud). Shared contracts and exceptions.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.1.0-dev.10 - 2026-02-08

• chore: update sdk to 3.10.0 from_json_to_json: ^0.4.0

0.1.0-dev.9 - 2025-10-27

• feat: file extension
• refactor: StorageService from universal_storage_sync package to universal_storage_interface package

0.1.0-dev.8 - 2025-10-25

• feat: add FileSystemConfig.filePathConfig property
• feat: add StorageProvider.dispose method

0.1.0-dev.7 - 2025-10-25

• feat: add FileSystemConfig.fromFilePathConfig constructor
• feat: isEmpty, isNotEmpty, empty for FilePathConfig and MacOSBookmark

0.1.0-dev.6 - 2025-10-18

• chore: from_json_to_json ^0.3.0

0.1.0-dev.5 - 2025-08-09

Changed

• moved macos_bookmark.dart and file_path_config.dart to models.dart

0.1.0-dev.4 - 2025-08-09

Changed

• alignment update, same as 0.1.0-dev.3

0.1.0-dev.3 - 2025-08-09

Added

• Initial Release: Core interfaces and models for universal storage providers
• StorageProvider abstract class defining the contract for all storage implementations
• StorageService main service class providing unified API
• Comprehensive exception hierarchy:
  • StorageException (base)
  • AuthenticationException
  • FileNotFoundException
  • NetworkException
  • GitConflictException
  • SyncConflictException
  • UnsupportedOperationException
• Structured configuration classes:
  • StorageConfig (base)
  • FileSystemConfig
  • OfflineGitConfig
  • GitHubApiConfig
• Core models:
  • FileEntry for file/directory representation
  • FileOperationResult for operation results
  • Version control models (VcRepositoryOwner, VcRepositoryName, VcBranchName, VcUrl)
• Type-safe configuration system
• Comprehensive error handling framework

Features

• Unified storage provider interface
• Cross-platform configuration models
• Version control aware models
• Exception hierarchy for robust error handling
• Type-safe configuration system

Dependencies

• from_json_to_json: ^0.4.0 - JSON serialization utilities
• meta: ^1.16.0 - Metadata annotations

Development Dependencies

• lints: ^6.0.0 - Dart linting rules
• xsoulspace_lints: ^0.1.2 - Custom linting rules

[Unreleased]

Planned

• Enhanced validation for configuration classes
• Additional utility models for common storage operations
• Migration helpers for configuration updates