object

type Metadata struct {
	Objects       int // Number of current objects
	Versions      int // Number of object versions
	DeleteMarkers int // Number of delete markers
}

type Object interface {
	// Find searches for objects matching the given regex pattern.
	Find(regex string) ([]string, error)

	// Size returns the size of the specified object in bytes.
	Size(object string) (size int64, err error)

	// List returns objects in the bucket, with pagination support.
	// Returns: objects, nextContinuationToken, count, error
	List(continuationToken string) ([]sdktps.Object, string, int64, error)

	// Walk iterates over all objects, calling md with metadata and f for each object.
	Walk(md WalkFuncMetadata, f WalkFunc) error

	// ListPrefix returns objects with the specified prefix, with pagination.
	// Returns: objects, nextContinuationToken, count, error
	ListPrefix(continuationToken string, prefix string) ([]sdktps.Object, string, int64, error)

	// WalkPrefix iterates over objects with the specified prefix.
	WalkPrefix(prefix string, md WalkFuncMetadata, f WalkFunc) error

	// Head retrieves metadata for an object without downloading it.
	Head(object string) (*sdksss.HeadObjectOutput, error)

	// Get retrieves an object's content and metadata.
	// Caller must close the returned Body ReadCloser.
	Get(object string) (*sdksss.GetObjectOutput, error)

	// Put uploads an object from an io.Reader.
	// For large files (>5MB), consider using MultipartPut.
	Put(object string, body io.Reader) error

	// Copy copies an object within the same bucket.
	Copy(source, destination string) error

	// CopyBucket copies an object between different buckets.
	CopyBucket(bucketSource, source, bucketDestination, destination string) error

	// Delete removes an object. If check is true, verifies object exists first.
	Delete(check bool, object string) error

	// DeleteAll removes multiple objects in a single request.
	DeleteAll(objects *sdktps.Delete) ([]sdktps.DeletedObject, error)

	// GetAttributes retrieves object attributes for a specific version.
	GetAttributes(object, version string) (*sdksss.GetObjectAttributesOutput, error)

	// MultipartList lists in-progress multipart uploads with pagination.
	MultipartList(keyMarker, markerId string) (uploads []sdktps.MultipartUpload, nextKeyMarker string, nextIdMarker string, count int64, e error)

	// MultipartNew creates a new multipart upload session.
	// Use for manual control of multipart upload process.
	MultipartNew(partSize libsiz.Size, bucket, object string) libmpu.MultiPart

	// MultipartCopy copies an object using multipart upload.
	// Useful for large objects (>5GB).
	MultipartCopy(partSize libsiz.Size, bucketSource, source, version, bucketDestination, destination string) error

	// MultipartPut uploads an object using multipart upload with default part size (10MB).
	MultipartPut(object string, body io.Reader) error

	// MultipartPutCustom uploads an object using multipart upload with custom part size.
	MultipartPutCustom(partSize libsiz.Size, object string, body io.Reader) error

	// MultipartCancel aborts a multipart upload session.
	MultipartCancel(uploadId, key string) error

	// UpdateMetadata updates object metadata by copying it to itself.
	UpdateMetadata(meta *sdksss.CopyObjectInput) error

	// SetWebsite configures website redirect for an object.
	SetWebsite(object, redirect string) error

	// VersionList lists all versions of objects with pagination.
	VersionList(prefix, keyMarker, markerId string) (version []sdktps.ObjectVersion, delMarker []sdktps.DeleteMarkerEntry, nextKeyMarker, nextMarkerId string, count int64, err error)

	// VersionWalk iterates over all object versions and delete markers.
	VersionWalk(md WalkFuncMetadata, fv WalkFuncVersion, fd WalkFuncDelMak) error

	// VersionWalkPrefix iterates over versions with the specified prefix.
	VersionWalkPrefix(prefix string, md WalkFuncMetadata, fv WalkFuncVersion, fd WalkFuncDelMak) error

	// VersionGet retrieves a specific version of an object.
	VersionGet(object, version string) (*sdksss.GetObjectOutput, error)

	// VersionHead retrieves metadata for a specific version.
	VersionHead(object, version string) (*sdksss.HeadObjectOutput, error)

	// VersionSize returns the size of a specific version in bytes.
	VersionSize(object, version string) (size int64, err error)

	// VersionDelete deletes a specific version of an object.
	VersionDelete(check bool, object, version string) error

	// VersionCopy copies a specific version within the same bucket.
	VersionCopy(source, version, destination string) error

	// VersionCopyBucket copies a specific version between buckets.
	VersionCopyBucket(bucketSource, source, version, bucketDestination, destination string) error

	// VersionDeleteLock deletes a locked version, optionally bypassing governance mode.
	VersionDeleteLock(check bool, object, version string, byPassGovernance bool) error

	// GetRetention retrieves the retention configuration for an object version.
	// Returns: retainUntilDate, mode, error
	GetRetention(object, version string) (until time.Time, mode string, err error)

	// SetRetention configures retention for an object version.
	// bypass: bypass governance mode restrictions
	// until: retain until this time
	// mode: GOVERNANCE or COMPLIANCE
	SetRetention(object, version string, bypass bool, until time.Time, mode string) error

	// GetLegalHold retrieves the legal hold status for an object version.
	GetLegalHold(object, version string) (sdktps.ObjectLockLegalHoldStatus, error)

	// SetLegalHold enables or disables legal hold on an object version.
	// Legal hold prevents deletion regardless of retention period.
	SetLegalHold(object, version string, flag sdktps.ObjectLockLegalHoldStatus) error

	// GetTags retrieves tags for an object or specific version.
	GetTags(object, version string) ([]sdktps.Tag, error)

	// SetTags sets tags for an object or specific version.
	SetTags(object, version string, tags ...sdktps.Tag) error
}

type WalkFunc func(obj sdktps.Object) bool

type WalkFuncDelMak func(del sdktps.DeleteMarkerEntry) bool

type WalkFuncMetadata func(md Metadata) bool

type WalkFuncVersion func(obj sdktps.ObjectVersion) bool