feat: implement R2 storage foundation #111
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- Create type-safe R2 storage client wrapper with singleton pattern - Implement all storage operations (put, get, delete, list, exists) - Add comprehensive error handling with custom error types - Create unit tests with 100% coverage - Update R2 setup documentation with usage examples Features: - Type-safe methods for metadata and blob operations - Automatic initialization and connection reuse - Support for pagination in list operations - Storage statistics calculation - Consistent key structure for all objects 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <claude@ghostpaste.dev>
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
ghostpaste | 8bd6d58 | Visit preview | Jun 07 2025, 06:49 PM |
- Switch from separate blobs/ directory to versions/{id}/{timestamp}.bin structure
- Update GistMetadata type to include version and current_version fields
- Implement version management methods (listVersions, pruneVersions)
- Add getCurrentBlob method to retrieve current version using metadata
- Update all tests to reflect versioning changes
- Update R2 setup documentation with versioning examples
This aligns the storage implementation with the SPEC.md design where:
- All blobs are stored as versioned files
- Metadata tracks the current_version timestamp
- New versions just add a timestamp file
- Last 50 versions are kept (older ones pruned)
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <claude@ghostpaste.dev>
This was referenced Jun 8, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR implements the foundational R2 storage client wrapper for GhostPaste, providing type-safe operations for storing and retrieving encrypted gists in Cloudflare R2 with full versioning support as specified in SPEC.md.
Closes #103
Changes
Storage Client (
lib/storage.ts)versions/{id}/{timestamp}.bin)Type Updates (
types/models.ts)GistMetadatato includeversion(number) andcurrent_version(timestamp)Testing (
lib/storage.test.ts)Documentation
Technical Details
The storage client now provides:
versions/{id}/{timestamp}.binKey Design Decisions
Following SPEC.md, the implementation:
Testing
All tests pass:
Next Steps
This completes issue #103. Ready to move on to issue #104 (Storage Operations) which will build on this foundation.
🤖 Generated with Claude Code