feat: stats and update methods

[designcode]

Note

Medium Risk
Introduces new HTTP-based bucket metadata/stats calls and an object rename path that depends on CopyObject permissions, which may affect behavior for existing consumers and credentials.

Overview
Adds new public APIs getStats (bucket-level usage + listing metadata) and updateObject (rename via CopyObject+X-Tigris-Rename, and/or change ACL via PutObjectAcl).

Refactors getBucketInfo to stop relying on HeadBucket response headers and instead call a JSON metadata endpoint, expanding the response with structured forkInfo, settings (ACL + default tier), and sizeInfo, while deprecating the old fork-related fields.

Improves error handling by introducing handleError, tightening put’s caught error type, adding required headers (RENAME, COPY_SOURCE), exporting the new APIs from server.ts, and adding integration tests for updateObject.

^{Written by Cursor Bugbot for commit 35f2503. This will update automatically on new commits. Configure here.}

[greptile-apps]

Greptile Summary

Added getStats function to expose organization-level storage statistics and updateObject function to support renaming objects and updating ACLs. Expanded getBucketInfo to include fork details, settings, and size information.

Major Changes:

• New getStats() function returns org-level stats (total objects, storage bytes, bucket list with metadata)
• New updateObject() function supports renaming objects and changing ACL (public/private)
• getBucketInfo() now returns detailed fork info, bucket settings, and size estimates
• Deprecated consistency field in bucket creation options
• Improved error handling in put() to use unknown instead of any

Issues Found:

• Logical error in isSnapshotEnabled calculation (operator precedence)
• Logical error in hasForks calculation (should check HasChildren not just ForkInfo existence)
• Test attempting to update ACL on renamed file using original key will fail
• Missing else if in error handler causing unnecessary second condition check

Confidence Score: 2/5

• This PR has critical logical errors that will cause runtime bugs
• Two critical logical errors in getBucketInfo will return incorrect values for isSnapshotEnabled and hasForks. A test also contains flawed logic that doesn't match its intent. These must be fixed before merging.
• Pay close attention to packages/storage/src/lib/bucket/info.ts and packages/storage/src/test/integration.test.ts

Important Files Changed

Filename	Overview
packages/storage/src/lib/bucket/info.ts	Expanded to include fork info, settings, and size info; contains logical errors in isSnapshotEnabled and hasForks calculations
packages/storage/src/lib/object/update.ts	New file implementing object rename and ACL update functionality
packages/storage/src/lib/stats.ts	New file implementing organization-level stats with bucket details
packages/storage/src/test/integration.test.ts	Added tests for updateObject; one test has incorrect logic testing renamed file with original key

_{Last reviewed commit: 67096cd}

[greptile-apps]

_{9 files reviewed, 4 comments}

_{Edit Code Review Agent Settings | Greptile}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

[github-actions]

🎉 This PR is included in version 2.13.0 🎉

The release is available on:

• GitHub release
• npm package (@latest dist-tag)

Your semantic-release bot 📦🚀

[github-actions]

🎉 This PR is included in version 1.2.0 🎉

The release is available on:

• GitHub release
• npm package (@latest dist-tag)

Your semantic-release bot 📦🚀