Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

contentbridge

package

Go to main page

Versions in this module

v0

v0.52.6

Oct 9, 2026

v0.52.5

Oct 9, 2026

v0.52.4

Oct 7, 2026

v0.52.2

Oct 7, 2026

v0.51.8

Oct 4, 2026

v0.51.6

Oct 4, 2026

Changes in this version

+ const DefaultImmichKeyFile

+ const DefaultImmichURL

+ const DefaultListen

+ const EnvCacheTTL

+ const EnvHomelabID

+ const EnvImmichKeyFile

+ const EnvImmichURL

+ const EnvListen

+ const HealthPath

+ const ImmichKeyName

+ const ImmichKeySlot

+ const MaxCacheTTL

+ const SummaryPath

+ const Version

+ const WorkloadRef

+ var ErrAppUnreachable = errors.New("content bridge: app unreachable")

+ var ErrCredentialInvalid = errors.New("content bridge: app credential invalid")

+ var ErrNotConfigured = errors.New("content bridge: app not configured")

+ var ErrRequestRefused = errors.New("content bridge: request refused by the read-only allowlist")

+ func ImmichKeySecretRef() string

+ func ImmichPermissions() []string

+ func NewHandler(service *Service, authority TierAuthority) http.Handler

+ func NewReadOnlyTransport(next http.RoundTripper, origin *url.URL, endpoints []Endpoint) http.RoundTripper

+ type Adapter interface

+ Ceiling func() Tier

+ Counts func(ctx context.Context) (any, error)

+ UseCase func() UseCase

+ type Config struct

+ CacheTTL time.Duration

+ HomelabID string

+ ImmichKeyFile string

+ ImmichURL string

+ Listen string

+ func ConfigFromEnv(getenv func(string) string) (Config, error)

+ type Document struct

+ AsOf string

+ HomelabID string

+ UseCases []UseCaseResult

+ Version string

+ type Endpoint struct

+ Path string

+ Query []string

+ func ImmichEndpoints() []Endpoint

+ type ImmichAdapter struct

+ func NewImmichAdapter(client *ReadOnlyClient, now func() time.Time) *ImmichAdapter

+ func (*ImmichAdapter) Ceiling() Tier

+ func (*ImmichAdapter) UseCase() UseCase

+ func (a *ImmichAdapter) Counts(ctx context.Context) (any, error)

+ type KeyFunc func() (string, error)

+ func FileKey(path string) KeyFunc

+ type LoopbackQueryTier struct

+ func (LoopbackQueryTier) GrantedTier(r *http.Request) (Tier, error)

+ type PhotosCounts struct

+ Albums *int64

+ Assets *int64

+ Images *int64

+ OnThisDay *int64

+ Videos *int64

+ type ReadOnlyClient struct

+ func NewReadOnlyClient(origin string, endpoints []Endpoint, key KeyFunc, base http.RoundTripper) (*ReadOnlyClient, error)

+ func (c *ReadOnlyClient) GetJSON(ctx context.Context, path string, query url.Values, out any) error

+ type Service struct

+ func NewService(cfg ServiceConfig) *Service

+ func NewServiceFromConfig(cfg Config, logger *slog.Logger) (*Service, error)

+ func (s *Service) HomelabID() string

+ func (s *Service) Summarize(ctx context.Context, useCases []UseCase, granted Tier, homelabID string) Document

+ type ServiceConfig struct

+ Adapters []Adapter

+ CacheTTL time.Duration

+ HomelabID string

+ Logger *slog.Logger

+ Now func() time.Time

+ type Status string

+ const StatusAppUnreachable

+ const StatusConsentRequired

+ const StatusCredentialInvalid

+ const StatusNotConfigured

+ const StatusOK

+ type Tier string

+ const TierOff

+ const TierPreviews

+ const TierSummary

+ func MinTier(a, b Tier) Tier

+ func ParseTier(value string) (Tier, bool)

+ type TierAuthority interface

+ GrantedTier func(r *http.Request) (Tier, error)

+ type TierError struct

+ Code string

+ HTTPStatus int

+ func (e *TierError) Error() string

+ type UseCase string

+ const UseCaseDocuments

+ const UseCaseFiles

+ const UseCaseMedia

+ const UseCasePhotos

+ const UseCaseSmartHome

+ func ParseUseCase(value string) (UseCase, bool)

+ type UseCaseResult struct

+ App string

+ AsOf string

+ Counts any

+ Status Status

+ Tier Tier

+ UseCase UseCase