Skip to content

Conversation

harrytmthy
Copy link
Owner

This release introduces v1.1.0-alpha02, a significant upgrade that enhances runtime safety and observability.

Highlights

  • SafeBoxBlobFileRegistry
    Prevents multiple SafeBox instances from accessing the same file concurrently. Enforces a strict single-instance-per-file constraint.

  • SafeBoxStateListener
    Observes lifecycle transitions (STARTING, WRITING, IDLE, CLOSED) tied to a specific SafeBox instance. Useful for ViewModel or short-lived scopes.

  • SafeBoxGlobalStateObserver
    Allows observing SafeBox state transitions globally by file name, even across different lifecycle owners. Useful in navigation-aware components or app-level coordination.

  • New Method: SafeBox.closeWhenIdle()
    Ensures file channel is closed only after all writes are completed. Prevents accidental file corruption during async transitions.

Docs & Migration

  • Updated README.md with improved performance charts and state observer usage.
  • MIGRATION.md updated to remove SafeBoxProvider references in favor of singleton-based usage.

@harrytmthy harrytmthy self-assigned this Jun 2, 2025
@harrytmthy harrytmthy merged commit 634ca2b into main Jun 2, 2025
3 checks passed
@harrytmthy harrytmthy deleted the release/1.1.0-alpha02 branch June 2, 2025 10:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant