cs3

type Authenticator interface {
	// Token returns a reva access token to place in the x-access-token header.
	Token(ctx context.Context) (string, error)
}

type CachedAuth struct {
	// contains filtered or unexported fields
}

type Client struct {
	// contains filtered or unexported fields
}

type ClientOption func(*Client)

type Entry struct {
	// Path is the space-relative, slash-separated path with no leading "./" or
	// "/", e.g. "photos/img.jpg". The empty string denotes the space root.
	Path string
	// IsDir reports whether the entry is a directory.
	IsDir bool
	// Size is the file size in bytes (0 for directories).
	Size int64
	// MTimeUnix is the modification time (seconds); mtime is in scope
	// (decisions.md #4).
	MTimeUnix int64
}

type Env struct {
	GatewayAddr          string        `` /* 233-byte string literal not displayed */
	DataServerURL        string        `` /* 170-byte string literal not displayed */
	ServiceAccountID     config.Secret `env:"OC_SERVICE_ACCOUNT_ID" doc:"Id of the OpenCloud service account the service acts as."`
	ServiceAccountSecret config.Secret `` /* 153-byte string literal not displayed */
}

type GatewayClient interface {
	Authenticate(ctx context.Context, in *gateway.AuthenticateRequest, opts ...grpc.CallOption) (*gateway.AuthenticateResponse, error)
	ListStorageSpaces(ctx context.Context, in *provider.ListStorageSpacesRequest, opts ...grpc.CallOption) (*provider.ListStorageSpacesResponse, error)
	ListContainer(ctx context.Context, in *provider.ListContainerRequest, opts ...grpc.CallOption) (*provider.ListContainerResponse, error)
	Stat(ctx context.Context, in *provider.StatRequest, opts ...grpc.CallOption) (*provider.StatResponse, error)
	InitiateFileDownload(ctx context.Context, in *provider.InitiateFileDownloadRequest, opts ...grpc.CallOption) (*gateway.InitiateFileDownloadResponse, error)
	// The write path (restore Path B).
	CreateContainer(ctx context.Context, in *provider.CreateContainerRequest, opts ...grpc.CallOption) (*provider.CreateContainerResponse, error)
	InitiateFileUpload(ctx context.Context, in *provider.InitiateFileUploadRequest, opts ...grpc.CallOption) (*gateway.InitiateFileUploadResponse, error)
	// Delete backs the service's own state Space only; no restore path uses it.
	Delete(ctx context.Context, in *provider.DeleteRequest, opts ...grpc.CallOption) (*provider.DeleteResponse, error)
}

type Member struct {
	// Role is the authority derived from the grant's permission set.
	Role Role
	// ExpiresAt is when the grant lapses; the zero time means "never".
	ExpiresAt time.Time
	// Group reports whether the principal is a group rather than a user.
	Group bool
}

type ResourceID struct {
	StorageID string
	SpaceID   string
	OpaqueID  string
}

type Role int

type ServiceAccountAuth struct {
	Gateway  GatewayClient
	ClientID string
	Secret   string
}

type Space struct {
	// ID is the CS3 space (storage) ID.
	ID string
	// Name is the human-readable space name.
	Name string
	// Type is the space type ("personal", "project", ...).
	Type string
	// Owner is the owning user's opaque ID (empty for some project spaces).
	Owner string
	// Root is the space root's resource id, used to build space-relative
	// references for the walk and download paths.
	Root ResourceID
	// Members maps principal ID -> grant for shared spaces, derived from the
	// space's Opaque grants/groups/grants_expirations maps (see role.go).
	// A principal may be a user or a group. Empty for a personal space.
	Members map[string]Member
}

type SpaceProvisioner interface {
	CreateStorageSpace(ctx context.Context, in *provider.CreateStorageSpaceRequest, opts ...grpc.CallOption) (*provider.CreateStorageSpaceResponse, error)
}

type SpaceReader interface {
	// ListSpaces returns the spaces the worker credential may back up.
	ListSpaces(ctx context.Context) ([]Space, error)
	// ListDir returns the direct children of one space-relative directory.
	// The empty path denotes the space root. Returned entries carry paths
	// relative to the space root.
	ListDir(ctx context.Context, space Space, relDir string) ([]Entry, error)
	// OpenFile streams the bytes of one space-relative file starting at offset.
	// The caller closes the returned reader.
	OpenFile(ctx context.Context, space Space, relPath string, offset int64) (io.ReadCloser, error)
}

type SpaceWriter interface {
	// MakeDir creates one space-relative directory. It is idempotent: an
	// existing directory is not an error.
	MakeDir(ctx context.Context, space Space, relDir string) error
	// Upload writes size bytes from r to a space-relative path, creating the
	// file. modTime is preserved where the server supports it.
	Upload(ctx context.Context, space Space, relPath string, size int64, modTime time.Time, r io.Reader) error
	// Delete removes one space-relative path, returning ErrNotFound when it
	// does not exist.
	//
	// A restore never calls this — restores only ever create (decisions.md #3).
	// It exists for the service's own state, which lives in its own Space and
	// has to be able to drop a released lock or an expired job record.
	Delete(ctx context.Context, space Space, relPath string) error
}

type StaticTokenAuth struct{ Value string }