cdn_bstore

type CachedBlockStoreOptions struct {
	// CdnBaseURL is the public CDN origin (e.g. https://cdn.spacewave.app).
	CdnBaseURL string
	// SpaceID is the CDN Space ULID.
	SpaceID string
	// CacheBlockStoreID is the bus block store used for writeback and
	// pack-index persistence. Empty disables the local cache.
	CacheBlockStoreID string
	// PointerTTL is the cache TTL for the decoded root pointer. See Options.
	PointerTTL time.Duration
	// WritebackWindowBytes bounds co-block writeback buffering.
	WritebackWindowBytes int64
	// HttpClient overrides the default http.Client.
	HttpClient *http.Client
	// Release is called when a looked-up cache dependency is disposed while
	// the assembled store is still live. Callers whose store sits under a
	// lifecycle owner pass their invalidation callback here. Callers that
	// own the store for their whole lifetime may leave it nil; the bus
	// references are still freed by the returned release function.
	Release func()
}

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

type Options struct {
	// CdnBaseURL is the public CDN origin (e.g. https://cdn.spacewave.app).
	CdnBaseURL string
	// SpaceID is the CDN Space ULID.
	SpaceID string
	// HttpClient overrides the default http.Client.
	HttpClient *http.Client
	// PointerTTL is the cache TTL for the decoded root pointer. Zero falls
	// back to DefaultPointerTTL. Negative disables the TTL (pointer is cached
	// until explicitly invalidated).
	PointerTTL time.Duration
	// IndexCache optionally persists raw packfile index tails across restarts.
	IndexCache packfile_store.IndexCache
}

type RootBlockStore interface {
	// BlockStore reads blocks for the CDN Space.
	bstore.BlockStore

	// Pointer returns the currently-cached root pointer without
	// triggering a fetch. Returns nil if no pointer has been fetched yet.
	Pointer() *cdn.CdnRootPointer
	// Refresh re-fetches the root pointer.
	// Returns nil if the CDN Space has no published root.
	Refresh(ctx context.Context) (*cdn.CdnRootPointer, error)
	// Close releases resources owned by the store.
	Close()
}

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

type SuppliedOptions struct {
	// CdnBaseURL is the public CDN origin (e.g. https://cdn.spacewave.app).
	CdnBaseURL string
	// SpaceID is the CDN Space ULID.
	SpaceID string
	// HttpClient overrides the default http.Client for root pointer fetches.
	HttpClient *http.Client
	// Store serves every block read. Another owner holds the CDN transport,
	// pack readers, and durable writeback behind it.
	Store block_store.Store
}