Files
zeekay 645325a641 regenerate from cloud 939b09d4
The projection was 113 commits behind the document it claims to describe, and
`generate.py --all --check` reported every one of the thirteen clients DRIFTED —
the same +19 models in each, because they all fell behind the same emission.

Regenerated in place from hanzo-inc/cloud openapi.yaml at 939b09d4
(sha256 087024f6…), which is the only description of this API that cannot name a
route the binary does not serve. `--check` is clean across all thirteen after.

.spec-lock moved with the code. The generator READS that file and never writes
it — hanzoai/ci`s lane does — so a hand run leaves every lock naming the previous
document. A lock that disagrees with the tree beside it is worse than no lock:
the next `--check` without `--spec` fetches what production serves, compares it
to a digest that was already wrong, and reports drift that is really staleness.
2026-08-24 23:32:53 -07:00

114 lines
5.4 KiB
C++

/**
* Hanzo Cloud API
* The Hanzo Cloud API as a customer calls it: every operation under /v1/ except the operator's admin product, relay routes, legacy spellings and capabilities still reached by flag. Tagged by product: the first path segment after /v1/.
*
* The version of the OpenAPI document: v1
*
* NOTE: This class is auto generated by OpenAPI-Generator 7.14.0.
* https://openapi-generator.tech
* Do not edit the class manually.
*/
/*
* RegistryApi.h
*
*
*/
#ifndef HANZO_API_RegistryApi_H_
#define HANZO_API_RegistryApi_H_
#include "hanzo/ApiClient.h"
#include "hanzo/model/RegistryImageList.h"
#include "hanzo/model/RegistryMint.h"
#include "hanzo/model/RegistryPackageList.h"
#include "hanzo/model/RegistryProjectList.h"
#include "hanzo/model/RegistryStatus.h"
#include "hanzo/model/RegistryTagList.h"
#include "hanzo/model/RegistryToken.h"
#include <cpprest/details/basic_types.h>
#include <boost/optional.hpp>
namespace hanzo {
namespace api {
using namespace hanzo::model;
class RegistryApi
{
public:
explicit RegistryApi( std::shared_ptr<const ApiClient> apiClient );
virtual ~RegistryApi();
/// <summary>
/// Images lists the org&#39;s container repositories, read live from the OCI catalog and filtered server-side to the org&#39;s namespace — the page can only ever hold the caller&#39;s own images.
/// </summary>
/// <remarks>
/// Images lists the org&#39;s container repositories, read live from the OCI catalog and filtered server-side to the org&#39;s namespace — the page can only ever hold the caller&#39;s own images.
/// </remarks>
pplx::task<std::shared_ptr<RegistryImageList>> getRegistryImages(
) const;
/// <summary>
/// Packages lists the org&#39;s npm packages — &#x60;&lt;org&gt;&#x60; and &#x60;@&lt;org&gt;/…&#x60; — from the npm registry&#39;s search index, optionally narrowed by a query within that scope.
/// </summary>
/// <remarks>
/// Packages lists the org&#39;s npm packages — &#x60;&lt;org&gt;&#x60; and &#x60;@&lt;org&gt;/…&#x60; — from the npm registry&#39;s search index, optionally narrowed by a query within that scope. The org boundary is applied server-side after the search, so a query can never widen it.
/// </remarks>
/// <param name="query">Query narrows the listing within the org&#39;s scope when present; the org boundary itself is never widened by it. It rides the query string. (optional, default to utility::conversions::to_string_t(&quot;&quot;))</param>
pplx::task<std::shared_ptr<RegistryPackageList>> getRegistryPackages(
boost::optional<utility::string_t> query
) const;
/// <summary>
/// Projects lists the namespaces the caller can see with what each holds: the org&#39;s slug, its repository count on the OCI catalog, and its package count on the npm registry.
/// </summary>
/// <remarks>
/// Projects lists the namespaces the caller can see with what each holds: the org&#39;s slug, its repository count on the OCI catalog, and its package count on the npm registry. Today that is exactly one row — the caller&#39;s org.
/// </remarks>
pplx::task<std::shared_ptr<RegistryProjectList>> getRegistryProjects(
) const;
/// <summary>
/// Status reports whether the OCI and npm registries are reachable and, when the OCI half is auth-gated, which token realm its challenge advertises — an honest lens for \&quot;is the registry plane up\&quot;, never a fabricated ok.
/// </summary>
/// <remarks>
/// Status reports whether the OCI and npm registries are reachable and, when the OCI half is auth-gated, which token realm its challenge advertises — an honest lens for \&quot;is the registry plane up\&quot;, never a fabricated ok.
/// </remarks>
pplx::task<std::shared_ptr<RegistryStatus>> getRegistryStatus(
) const;
/// <summary>
/// Tags lists one org-owned repository&#39;s tags, read live from the OCI registry.
/// </summary>
/// <remarks>
/// Tags lists one org-owned repository&#39;s tags, read live from the OCI registry. The repository is addressed inside the org&#39;s namespace — a name outside it cannot be expressed, and an unknown one answers 404.
/// </remarks>
/// <param name="image">Image is the repository name inside the org&#39;s namespace, as returned by the images op. It rides the query string. (optional, default to utility::conversions::to_string_t(&quot;&quot;))</param>
pplx::task<std::shared_ptr<RegistryTagList>> getRegistryTags(
boost::optional<utility::string_t> image
) const;
/// <summary>
/// Token mints a short-lived, pull-only registry token for exactly one of the org&#39;s images, through the same IAM realm the docker CLI authenticates against.
/// </summary>
/// <remarks>
/// Token mints a short-lived, pull-only registry token for exactly one of the org&#39;s images, through the same IAM realm the docker CLI authenticates against. The scope is pinned server-side to &#x60;&lt;org&gt;/&lt;image&gt;&#x60; with the &#x60;pull&#x60; action — no field exists to name another org&#39;s image or ask for push. Use it as &#x60;Authorization: Bearer …&#x60; on the OCI wire; it expires in minutes.
/// </remarks>
/// <param name="registryMint"></param>
pplx::task<std::shared_ptr<RegistryToken>> postRegistryToken(
std::shared_ptr<RegistryMint> registryMint
) const;
protected:
std::shared_ptr<const ApiClient> m_ApiClient;
};
}
}
#endif /* HANZO_API_RegistryApi_H_ */