Skip to main content

universal_storage_interface 1.0.0 copy "universal_storage_interface: ^1.0.0" to clipboard
universal_storage_interface: ^1.0.0 copied to clipboard

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.

Unreleased #

Added #

  • feat: SyncAvailability tri-state (none / always / withRemoteConfig) added to StorageCapabilities and profile negotiation.
  • feat: default declaredCapabilities (StorageCapabilities.none) on StorageProvider so providers only override what they support.

Fixed #

  • fix: saveFile race guard — inside async functions a bare return future bypasses surrounding try/on handlers; provider results are now awaited before returning so the on FileAlreadyExistsException → updateFile fallback actually engages when concurrent savers race between existence check and create.

Breaking changes #

  • Removed dead mixins RemoteSyncCapable, VersionControlCapable, and AuthenticatedProvider; capability declaration now flows exclusively through StorageCapabilities / declaredCapabilities.

1.0.0 - 2026-11-20 #

⚠ BREAKING CHANGES #

  • deps: SDK floor raised from Dart 3.13 to Dart 3.14.

Bug Fixes #

  • deps: require Dart ^3.14.0 and widen sibling deps (4703d0c)
  • universal storage (b707abe)

0.1.1-dev.12 - 2026-10-25 #

Bug Fixes #

0.1.0-dev.12 - 2026-03-28 #

  • chore: update dependencies

0.1.0-dev.11 - 2026-03-03 #

  • feat: add CloudKitConfig extends StorageConfig
  • feat: add CloudKit enums:
    • CloudKitEnvironment
    • CloudKitDatabaseScope
    • CloudKitDataMode
  • feat: add validation for CloudKit remoteOnly / localMirror modes
  • test: add dedicated CloudKitConfig validation tests

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
0
likes
140
points
88
downloads

Documentation

Documentation
API reference

Publisher

unverified uploader

Weekly Downloads

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

Repository (GitHub)
View/report issues
Contributing

License

MIT (license)

Dependencies

crypto, from_json_to_json, meta, path, universal_io

More

Packages that depend on universal_storage_interface