plan_catalog_download

winbrew_app::operations::update::planner

Function plan_catalog_download 

Source 
pub(super) fn plan_catalog_download(
    local_metadata: Option<&CatalogMetadata>,
    selection: CatalogUpdateResponse,
) -> Result<Option<CatalogDownloadPlan>>
Expand description

Converts the update API response into a concrete catalog download plan.

The planner is intentionally small and deterministic: it validates the API payload against the caller’s local metadata, then maps the response into one of three outcomes.

  • Current: the catalog is already up to date and no download is needed.
  • Full: the workflow should download a full snapshot plus its metadata.
  • Patch: the workflow should apply one or more incremental SQL patches to the existing local catalog.

The function returns Ok(None) when the response is incomplete or incompatible with the local catalog state, which lets the caller fall back to a full snapshot request.