authed Caller for the admin-gated write endpoints.
auth-less Caller for the public, cacheable read
endpoints (index/detail/bundle URL). Defaults to call
so existing tests can construct with a single caller.
Open a curation case (ADR-0013). Admin.
Optionalopts: RequestOptionsDecide a curation case (approve / reject / request-changes). Admin.
Optionalopts: RequestOptionsFetch one template's full detail (manifest included). Public.
Optionalversion: stringoptional exact version; omitted resolves the latest.
Optionalopts: RequestOptionsget, but a WITHDRAWN (or unknown) template/version resolves to
null instead of throwing.
Yank state is not a field on any public response — the backend expresses it ONLY through absence (backend/src/routes/handlers/catalog.ts):
toSummary (:156-170) carries no yanked* field, so neither the index
nor the detail response ever reports it;getTemplateHandler (:327) 404s an explicit ?version= read of a yanked
version, and 404s the latest read when every version is yanked;list drops fully-yanked templates and repoints
the LATEST row to the newest surviving version on yank
(CatalogTemplateRepository.ts:288-290, :475-483).So a 404 IS the yank signal, and this method is what a caller uses to
confirm a version it learned about elsewhere (a cached index row, an app's
templateRef) is still serveable — e.g. the "update available" badge
verifying the advertised latest before advertising it.
Any non-404 failure still throws (a network blip must not read as "yanked").
Optionalversion: stringOptionalopts: RequestOptionsResolve a presigned URL for a compose bundle by digest. Public.
Optionalopts: RequestOptionsList published templates, optionally filtered. Public — no credentials required.
One row per template at its latest SERVEABLE version: the backend excludes fully-yanked templates and repoints LATEST past a yanked version, and no row carries yank state. A row is therefore a point-in-time claim — re-confirm with getAvailableVersion before acting on a cached one.
Optionalopts: RequestOptionsList curation cases, optionally filtered by status (queue view). Admin.
Optionalopts: RequestOptionsPublish a template version (manifest + bundle digest + image map). Admin.
Optionalopts: RequestOptionsReport a nightly verification outcome for a template (Phase 8 writer). Admin.
Optionalopts: RequestOptions
sdk.catalog — registry reads (public) + publish/verification/curation (admin). See the module doc for the auth split.