Documentation
¶
Overview ¶
Package acquisition composes provider and external-source acquisition above the small immutable Starmap client.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func NewProviderFetcher ¶
func NewProviderFetcher( providers catalogs.ProvidersReader, opts ...sources.ProviderOption, ) *sources.ProviderFetcher
NewProviderFetcher returns the repository's opt-in concrete provider composition. Importing starmap alone never imports provider SDKs.
Types ¶
type ImportResult ¶
type ImportResult struct {
// SourceGenerationID identifies the exact verified release generation.
SourceGenerationID string
// Publication identifies the locally committed reconciled generation.
Publication starmap.Publication
// Projection reports the post-commit human-workspace projection.
Projection *catalogmeta.ProjectionResult
}
ImportResult describes a verified release observation and any local generation it produced after authority-aware reconciliation.
type Option ¶
type Option func(*options) error
Option configures one acquisition Syncer.
func WithProviderClientFactory ¶
func WithProviderClientFactory(factory sources.ProviderClientFactory) Option
WithProviderClientFactory replaces the concrete provider-client composition. It is intended for source plugins, restricted deployments, and deterministic integration tests.
type Syncer ¶
type Syncer struct {
// contains filtered or unexported fields
}
Syncer observes configured sources, reconciles a complete candidate, and delegates serialized durable publication to a Client.
func New ¶
New constructs an explicit acquisition composition. It starts no goroutine and performs no source or filesystem work.
func (*Syncer) ImportRelease ¶
func (s *Syncer) ImportRelease( ctx context.Context, release catalogartifact.Release, verifier catalogartifact.PublisherVerifier, ) (*ImportResult, error)
ImportRelease verifies a portable catalog release, reconciles it as a trusted low-authority observation with the current catalog and human workspace, then atomically publishes the result. Verification failure cannot mutate the client. The release generation itself is never activated wholesale.
Source Files