Struct RegistryApi 

pub struct RegistryApi { /* private fields */ }

Spec registry — publish, search, yank, share spec artifacts

Implementations

impl RegistryApi

pub async fn feature_registry_spec( &self, scope: &str, name: &str, ) -> Result<RegistrySpecFeatureState>

Add a SPEC to the featured set (super-admin)

The SPEC’s existence is confirmed BEFORE the featured set is touched, so a typo cannot leave a dangling id in a shared list — that is what the 404 protects. The set itself is mutated under a compare-and-set retry, because it is one shared record and a plain read-modify-write was last-writer-wins.

Idempotent: featuring an already-featured SPEC is 200, not a conflict.

POST /api/v1/registry/admin/specs/{scope}/{name}/feature

pub async fn registry_admin_list_specs( &self, params: &RegistryAdminListSpecsParams, ) -> Result<RegistryAdminListSpecsResponse>

Admin: list all specs (regardless of visibility)

GET /api/v1/registry/admin/specs

pub async fn registry_get_artifact( &self, scope: &str, name: &str, version: &str, ) -> Result<Bytes>

Download tarball/artifact bundle for a spec version

GET /api/v1/registry/spec/{scope}/{name}/{version}/artifact

pub async fn registry_get_file( &self, scope: &str, name: &str, version: &str, params: &RegistryGetFileParams, ) -> Result<RegistryGetFileResponse>

Get a single file from inside a spec version artifact

GET /api/v1/registry/spec/{scope}/{name}/{version}/file

pub async fn registry_get_readme( &self, scope: &str, name: &str, version: &str, ) -> Result<RegistryGetReadmeResponse>

Get README for a spec version

GET /api/v1/registry/spec/{scope}/{name}/{version}/readme

pub async fn registry_get_share( &self, scope: &str, name: &str, ) -> Result<RegistryGetShareResponse>

Get share/visibility settings for a spec

GET /api/v1/registry/spec/{scope}/{name}/share

pub async fn registry_get_sparse_index( &self, shard: &str, scope: &str, name: &str, ) -> Result<RegistryGetSparseIndexResponse>

Get sparse-index entry for a spec

GET /api/v1/registry/index/{shard}/{scope}/{name}

pub async fn registry_get_spec_metadata( &self, scope: &str, name: &str, ) -> Result<RegistryGetSpecMetadataResponse>

Get spec metadata (latest version pointers, owners)

GET /api/v1/registry/spec/{scope}/{name}

pub async fn registry_get_spec_version( &self, scope: &str, name: &str, version: &str, ) -> Result<RegistryGetSpecVersionResponse>

Get a specific version of a spec

Returns the full PublishedSpec record plus a download_url pointing at the artifact endpoint.

GET /api/v1/registry/spec/{scope}/{name}/{version}

pub async fn registry_list_files( &self, scope: &str, name: &str, version: &str, ) -> Result<RegistryListFilesResponse>

List files inside a spec version artifact

GET /api/v1/registry/spec/{scope}/{name}/{version}/files

pub async fn registry_publish( &self, body: &RegistryPublishRequest, ) -> Result<RegistryPublishResponse>

Publish a new spec version to the registry

Multipart upload of a tarball + manifest. Server validates manifest, verifies optional sha256, and persists the artifact. Returns the full PublishedSpec record. Location header points at the version’s metadata endpoint.

POST /api/v1/registry/publish

pub async fn registry_search( &self, params: &RegistrySearchParams, ) -> Result<RegistrySearchResponse>

Search the registry for specs

GET /api/v1/registry/search

pub async fn registry_set_share( &self, scope: &str, name: &str, body: &RegistrySetShareRequest, ) -> Result<RegistrySetShareResponse>

Set share/visibility settings for a spec

POST /api/v1/registry/spec/{scope}/{name}/share

pub async fn registry_unyank_version( &self, scope: &str, name: &str, version: &str, ) -> Result<RegistryUnyankVersionResponse>

Reverse a yank on a published spec version

POST /api/v1/registry/spec/{scope}/{name}/{version}/unyank

pub async fn registry_yank_version( &self, scope: &str, name: &str, version: &str, body: &RegistryYankVersionRequest, ) -> Result<RegistryYankVersionResponse>

Yank (mark unsafe) a published spec version

POST /api/v1/registry/spec/{scope}/{name}/{version}/yank

pub async fn seed_starter_specs(&self) -> Result<SeedStarterSpecsResponse>

Bulk-publish the bundled starter SPECs (super-admin)

Idempotent: a starter SPEC already present is counted in skipped, not republished, so re-running is safe and is how a partially-failed seed is completed.

errors is present ONLY when at least one SPEC failed. Its absence means no failures — not that the field is unavailable — so a client should treat missing as empty rather than unknown. A run can be partially successful: added and errors are both meaningful in the same response, and the status is still 200.

POST /api/v1/registry/admin/specs/seed

pub async fn set_registry_spec_visibility( &self, scope: &str, name: &str, body: &SetRegistrySpecVisibilityRequest, ) -> Result<SetRegistrySpecVisibilityResponse>

Make a SPEC public or private (super-admin)

PATCH and only PATCH — a PUT is 405 with the allowed methods named.

WRITE SEMANTICS: replaces the visibility, which is the only field this route touches. visibility is required and must be exactly public or private; anything else, including a missing body or a near-miss like unlisted, is 400 rather than being coerced or ignored.

PATCH /api/v1/registry/admin/specs/{scope}/{name}/visibility

pub async fn unfeature_registry_spec( &self, scope: &str, name: &str, ) -> Result<RegistrySpecFeatureState>

Remove a SPEC from the featured set (super-admin)

Same shape and same guards as the POST; the response’s featured is simply false. Idempotent — un-featuring something that was not featured is 200.

DELETE /api/v1/registry/admin/specs/{scope}/{name}/feature

Trait Implementations

impl Clone for RegistryApi

fn clone(&self) -> RegistryApi

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RegistryApi

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.