Skip to content

refactor(ObjectStore/S3): improve multipart upload validation and strengthen S3 typing/docs#58819

Draft
joshtrichards wants to merge 5 commits intomasterfrom
jtr/refactor-ObjectStore-S3
Draft

refactor(ObjectStore/S3): improve multipart upload validation and strengthen S3 typing/docs#58819
joshtrichards wants to merge 5 commits intomasterfrom
jtr/refactor-ObjectStore-S3

Conversation

@joshtrichards
Copy link
Member

@joshtrichards joshtrichards commented Mar 10, 2026

  • Resolves: #

Summary

This changeset:

  • tightens S3 object store internals by hardening initiateMultipartUpload UploadId validation slightly
  • improves maintainability with clearer S3 docblocks and expanded static-analysis typing (notably in IObjectStoreMultiPartUpload.php public interface and S3ConfigTrait docs)
  • added default values to S3 configuration parameters (based on fallbacks assigned elsewhere currently) so that we can centralize more logically here

Overall, it’s a refactor/docs-focused update with a minor hardening in multipart upload flow.

TODO

Checklist

AI (if applicable)

  • The content of this PR was partly or fully generated using AI

Signed-off-by: Josh <josh.t.richards@gmail.com>
…idation

Signed-off-by: Josh <josh.t.richards@gmail.com>
…properties

- Trait docblock (including shared context)
- Docs for every property

Signed-off-by: Josh <josh.t.richards@gmail.com>
…Upload.php

- Not quite there on runtime typing, but let's add for total static analysis 
- Adds docblocks for class and functions too


Signed-off-by: Josh <josh.t.richards@gmail.com>
@joshtrichards joshtrichards added this to the Nextcloud 34 milestone Mar 10, 2026
@joshtrichards joshtrichards added feature: external storage feature: object storage ♻️ refactor Refactor code (not a bug fix, not a feature just refactoring) labels Mar 10, 2026
Signed-off-by: Josh <josh.t.richards@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature: external storage feature: object storage ♻️ refactor Refactor code (not a bug fix, not a feature just refactoring)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants