syntax = "proto3"; package elide.cloud.v1; import "elide/pkgst/v1/descriptor.proto"; import "elide/pkgst/catalog/v1/catalog.proto"; import "elide/pkgst/maven/index/v1/index.proto"; // Public package-service contracts. HTTP mappings are published in the OpenAPI document. service PkgstService { rpc GetCatalogStatus(PkgstServiceGetCatalogStatusRequest) returns (PkgstServiceGetCatalogStatusResponse); rpc ListCatalogGroups(PkgstServiceListCatalogGroupsRequest) returns (PkgstServiceListCatalogGroupsResponse); rpc ListCatalogPackages(PkgstServiceListCatalogPackagesRequest) returns (PkgstServiceListCatalogPackagesResponse); rpc ListCatalogVersions(PkgstServiceListCatalogVersionsRequest) returns (PkgstServiceListCatalogVersionsResponse); rpc ListCatalogArtifacts(PkgstServiceListCatalogArtifactsRequest) returns (PkgstServiceListCatalogArtifactsResponse); rpc GetIndexStatus(PkgstServiceGetIndexStatusRequest) returns (PkgstServiceGetIndexStatusResponse); rpc GetIndexPackage(PkgstServiceGetIndexPackageRequest) returns (PkgstServiceGetIndexPackageResponse); rpc GetDescriptor(PkgstServiceGetDescriptorRequest) returns (PkgstServiceGetDescriptorResponse); rpc BatchGetDescriptors(PkgstServiceBatchGetDescriptorsRequest) returns (PkgstServiceBatchGetDescriptorsResponse); rpc ListPlatforms(PkgstServiceListPlatformsRequest) returns (PkgstServiceListPlatformsResponse); rpc GetPackage(PkgstServiceGetPackageRequest) returns (PkgstServiceGetPackageResponse); rpc GetVersion(PkgstServiceGetVersionRequest) returns (PkgstServiceGetVersionResponse); rpc BatchResolve(PkgstServiceBatchResolveRequest) returns (PkgstServiceBatchResolveResponse); rpc GetIdentity(PkgstServiceGetIdentityRequest) returns (PkgstServiceGetIdentityResponse); rpc GetPreferences(PkgstServiceGetPreferencesRequest) returns (PkgstServiceGetPreferencesResponse); rpc UpdatePreferences(PkgstServiceUpdatePreferencesRequest) returns (PkgstServiceUpdatePreferencesResponse); } message PkgstServiceGetIndexStatusRequest {} message PkgstServiceGetIndexStatusResponse { elide.pkgst.maven.index.v1.MavenIndexStatus status = 1; } message PkgstServiceGetIndexPackageRequest { // Literal groupId:artifactId from the Maven Central snapshot. string name = 1; uint32 page_size = 2; string page_token = 3; } message PkgstServiceGetIndexPackageResponse { elide.pkgst.maven.index.v1.MavenIndexStatus status = 1; elide.pkgst.maven.index.v1.MavenIndexPackage package = 2; string next_page_token = 3; } message PkgstPlatform { string platform = 1; string display_name = 2; repeated string capabilities = 3; } message PkgstPackage { string platform = 1; string name = 2; string latest = 3; repeated string versions = 4; string description = 5; map dist_tags = 6; } message PkgstArtifact { string filename = 1; string url = 2; string digest_algorithm = 3; string digest = 4; string integrity = 5; string size_bytes = 6; string requires_python = 7; bool yanked = 8; string yanked_reason = 9; } message PkgstVersion { string platform = 1; string name = 2; string version = 3; repeated PkgstArtifact artifacts = 4; string requires_python = 5; map engines = 6; map dependencies = 7; bool yanked = 8; repeated string requires_dist = 9; } message PkgstPreferences { uint32 schema_version = 1; optional string default_registry = 2; optional bool include_prerelease = 3; optional string python_version = 4; optional string module_target = 5; } message PkgstIdentity { string kind = 1; string subject = 2; string account_id = 3; string org_id = 4; repeated string scopes = 5; bool can_customize = 6; } message PkgstError { string code = 1; string message = 2; uint32 status = 3; } message PkgstResolveParams { string platform = 1; string name = 2; // Exact upstream version or "latest". This is not a general range solver. string version = 3; } message PkgstResolution { PkgstResolveParams request = 1; oneof result { PkgstVersion version = 2; PkgstError error = 3; } } message PkgstServiceListPlatformsRequest {} message PkgstServiceListPlatformsResponse { repeated PkgstPlatform platforms = 1; } message PkgstServiceGetPackageRequest { string platform = 1; string name = 2; uint32 page_size = 3; string page_token = 4; } message PkgstServiceGetPackageResponse { PkgstPackage package = 1; string next_page_token = 2; } message PkgstServiceGetVersionRequest { string platform = 1; string name = 2; string version = 3; } message PkgstServiceGetVersionResponse { PkgstVersion version = 1; } message PkgstServiceBatchResolveRequest { repeated PkgstResolveParams requests = 1; } message PkgstServiceBatchResolveResponse { repeated PkgstResolution results = 1; } message PkgstServiceGetIdentityRequest {} message PkgstServiceGetIdentityResponse { PkgstIdentity identity = 1; } message PkgstServiceGetPreferencesRequest {} message PkgstServiceGetPreferencesResponse { PkgstPreferences preferences = 1; string etag = 2; } message PkgstServiceUpdatePreferencesRequest { PkgstPreferences preferences = 1; // HTTP clients supply this value in If-Match. string etag = 2; } message PkgstServiceUpdatePreferencesResponse { PkgstPreferences preferences = 1; string etag = 2; } // Descriptor transports use shared references and versioned ecosystem models. message PkgstServiceGetDescriptorRequest { string ecosystem = 1; string name = 2; string version = 3; string repository = 4; reserved 5; reserved "include_source"; // Optional descriptive metadata and supplementary source provenance. bool include_metadata = 6; } message PkgstServiceGetDescriptorResponse { elide.pkgst.v1.PackageDescriptor descriptor = 1; } message PkgstServiceBatchGetDescriptorsRequest { repeated elide.pkgst.v1.DescriptorReference requests = 1; reserved 2; reserved "include_source"; // Optional descriptive metadata and supplementary source provenance. bool include_metadata = 3; // Framed streams may emit completed results before earlier request indexes. // Buffered responses retain request order. Descriptor contents are unchanged. bool unordered = 4; // Also return descriptors that successful POM results lead to, up to this many // levels; 0 disables, max 2. Expansion results carry `expanded` and are extra to the // one result per request; buffered responses append them after requested results. uint32 expand_depth = 5; } message PkgstServiceBatchGetDescriptorsResponse { repeated elide.pkgst.v1.DescriptorResult results = 1; } // Catalog cursors are scoped to an object revision. A 409 requires restarting pagination. // A 202 means initial inventory hydration is pending, not an empty repository/package. message PkgstServiceGetCatalogStatusRequest {} message PkgstServiceGetCatalogStatusResponse { uint32 schema_version = 1; string source = 2; string source_as_of = 3; uint32 committed_chunk = 4; string last_poll_at = 5; string last_successful_sync_at = 6; uint32 upstream_chunk = 7; string phase = 8; uint32 pending_batches = 9; string last_error = 10; string bootstrap = 11; bool authoritative_for_latest = 12; } message PkgstServiceListCatalogGroupsRequest { string ecosystem = 1; string repository = 2; string prefix = 3; uint32 limit = 4; string cursor = 5; } message PkgstServiceListCatalogGroupsResponse { repeated elide.pkgst.catalog.v1.CatalogGroup items = 1; string next_cursor = 2; uint64 sequence = 3; } message PkgstServiceListCatalogPackagesRequest { string ecosystem = 1; string repository = 2; string namespace = 3; string prefix = 4; uint32 limit = 5; string cursor = 6; } message PkgstServiceListCatalogPackagesResponse { repeated elide.pkgst.catalog.v1.CatalogPackage items = 1; string next_cursor = 2; uint64 sequence = 3; } message PkgstServiceListCatalogVersionsRequest { string ecosystem = 1; string repository = 2; string namespace = 3; string name = 4; uint32 limit = 5; string cursor = 6; } message PkgstServiceListCatalogVersionsResponse { repeated elide.pkgst.catalog.v1.CatalogVersion items = 1; string next_cursor = 2; uint64 sequence = 3; elide.pkgst.catalog.v1.CatalogState state = 4; } message PkgstServiceListCatalogArtifactsRequest { string observed_cursor = 8; string ecosystem = 1; string repository = 2; string namespace = 3; string name = 4; string version = 5; uint32 limit = 6; string cursor = 7; } message PkgstServiceListCatalogArtifactsResponse { repeated elide.pkgst.catalog.v1.CatalogArtifact items = 1; string next_cursor = 2; uint64 sequence = 3; elide.pkgst.catalog.v1.CatalogState state = 4; elide.pkgst.catalog.v1.CatalogObservedArtifacts observed_artifacts = 5; }