OptionalcatalogA catalog the caller already has: the parsed object, its JSON text, or the bytes of the file (gzip or plain JSON). Nothing is requested.
OptionalchannelWhich catalog of the CDN to read when neither catalog nor url is given. Default: production.
OptionalignoreDownload the catalog without validators and keep the result, whatever the cache holds; a failed download is an error, the old copy is not used. Only for the public source with the cache on. Default: false.
OptionalmaxHow old a copy in the cache may be, in milliseconds, before the source is asked about it again. Default: 3,600,000 (one hour), the time the source allows a copy to be kept. Zero asks every time.
OptionalrefreshCheck the source now, whatever the age of the copy the cache holds: the request is still conditional, so a copy that is current costs no download. Without the cache, read again instead of using the catalog kept from an earlier read of this state. Default: false.
OptionalurlAn http(s) URL the caller names, for example a mirror of the catalog. Any
host is accepted, on purpose: it is meant for a location the caller
chooses, such as a mirror on a private network. Redirects are followed. It
is requested without any credential of the tenant, and it is allowed in
air-gapped mode, because the caller named it. A tool that passes arguments
on behalf of someone else (the MCP tools of the library do not offer
url, catalog or refresh) must not let that party choose it.
Which catalog to read. The first one that is given wins:
catalog, thenurl, then the CDN.