Method getDatabase

pkg/modelsdev/store.go:155–184

getDatabase returns the models.dev database. When allowFetch is false the catalog is served from memory or the on-disk cache only and the network is never touched; a cache miss yields an empty database rather than an error.

(ctx context.Context, allowFetch bool)

// catalog is served from memory or the on-disk cache only and the network is
// never touched; a cache miss yields an empty database rather than an error.
func (s *Store) getDatabase(ctx context.Context, allowFetch bool) (*Database, error) {
	s.mu.Lock()
	defer s.mu.Unlock()

	// The authoritative catalog, once loaded, serves every lookup — including
	// fetch-disallowed ones, which then benefit from the fresher data.
	if s.db != nil {
		return s.db, nil
	}

	if !allowFetch {
		// Serve (and memoize) a cache-only snapshot without touching the
		// network. Kept out of s.db so it can never satisfy a later
		// fetch-eligible lookup for a known provider.
		if s.cacheDB == nil {
			s.cacheDB, _ = loadDatabase(ctx, s.cacheFile, false, s.fetcher())
		}
		return s.cacheDB, nil
	}

	db, authoritative := loadDatabase(ctx, s.cacheFile, true, s.fetcher())
	// Only memoize a result that came from the on-disk cache or a live fetch.
	// The embedded fallback snapshot is deliberately NOT pinned, so a later
	// lookup retries the fetch once the network (or cache) recovers instead of
	// serving the build-time snapshot for the Store's entire lifetime.
	if authoritative {
		s.db = db
	}
	return db, nil
}

// fetcher returns the Store's catalog fetcher, defaulting to fetchFromAPI when
// unset. The constructors always populate s.fetch, but defaulting here guards