generator

type CreatePluginRequest struct {

	// Group to which the plugin belongs.
	Group string `protobuf:"bytes,1,opt,name=group,proto3" json:"group,omitempty"`
	// Name of the plugin.
	Name string `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
	// Version of the plugin.
	Version string `protobuf:"bytes,3,opt,name=version,proto3" json:"version,omitempty"`
	// Optional plugin configuration.
	Config *structpb.Struct `protobuf:"bytes,4,opt,name=config,proto3" json:"config,omitempty"`
	// Tags for the plugin.
	Tags []string `protobuf:"bytes,5,rep,name=tags,proto3" json:"tags,omitempty"`
	// contains filtered or unexported fields
}

type CreatePluginResponse struct {

	// The created plugin information.
	Plugin *PluginInfo `protobuf:"bytes,1,opt,name=plugin,proto3" json:"plugin,omitempty"`
	// contains filtered or unexported fields
}

type DeletePluginRequest struct {

	// Group to which the plugin belongs.
	Group string `protobuf:"bytes,1,opt,name=group,proto3" json:"group,omitempty"`
	// Name of the plugin.
	Name string `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
	// Version of the plugin.
	Version string `protobuf:"bytes,3,opt,name=version,proto3" json:"version,omitempty"`
	// contains filtered or unexported fields
}

type DeletePluginResponse struct {
	// contains filtered or unexported fields
}

type GenerateCodeRequest struct {

	// Standard protobuf code generator request.
	//
	// This should contain the proto files to process and any plugin-specific parameters.
	// The request is passed directly to the plugin's stdin.
	CodeGeneratorRequest *pluginpb.CodeGeneratorRequest `protobuf:"bytes,1,opt,name=code_generator_request,json=codeGeneratorRequest,proto3" json:"code_generator_request,omitempty"`
	// Name of the plugin to use for generation.
	//
	// Format: `<group>/<name>:<version>`
	//
	// Examples:
	// - `protocolbuffers/go:v1.36.10`
	// - `grpc/go:v1.5.1`
	// - `grpc-ecosystem/gateway:latest`
	PluginName string `protobuf:"bytes,2,opt,name=plugin_name,json=pluginName,proto3" json:"plugin_name,omitempty"`
	// contains filtered or unexported fields
}

type GenerateCodeResponse struct {

	// Standard protobuf code generator response.
	//
	// Contains the generated files and any error messages from the plugin.
	// Check the `error` field in the response for plugin-level errors.
	CodeGeneratorResponse *pluginpb.CodeGeneratorResponse `` /* 126-byte string literal not displayed */
	// contains filtered or unexported fields
}

type GeneratorAPIClient interface {
	// Generate code using a specified plugin.
	//
	// This method executes a protobuf code generation plugin and returns the generated files.
	// The plugin runs as a local child process under the limits described on the
	// service above — notably a time bound and an output-size bound, and notably
	// *not* a memory, CPU or network bound.
	//
	// This method is anonymous: it requires no credentials. Only the mutating
	// methods take a write token.
	//
	// ## Error Codes
	//
	// | Code | Description |
	// |------|-------------|
	// | `NOT_FOUND` | Plugin not found in registry |
	// | `INVALID_ARGUMENT` | Invalid plugin name format |
	// | `RESOURCE_EXHAUSTED` | The service is at its concurrency limit; retry later |
	// | `UNAVAILABLE` | Object storage is unreachable, or the service is shutting down |
	// | `FAILED_PRECONDITION` | The plugin is registered but its archive is not in storage |
	// | `INTERNAL` | Plugin execution failed |
	// | `DEADLINE_EXCEEDED` | Plugin execution timeout |
	GenerateCode(ctx context.Context, in *GenerateCodeRequest, opts ...grpc.CallOption) (*GenerateCodeResponse, error)
	// List available plugins.
	//
	// Returns a list of all plugins registered in the service.
	// Use this to discover available plugins and their versions.
	Plugins(ctx context.Context, in *PluginsRequest, opts ...grpc.CallOption) (*PluginsResponse, error)
	// Create a new plugin registration.
	//
	// Registers a plugin with the given group, name, version, optional config, and tags.
	// Requires an Enterprise license.
	//
	// ## Error Codes
	//
	// | Code | Description |
	// |------|-------------|
	// | `ALREADY_EXISTS` | Plugin with same group/name/version exists |
	// | `INVALID_ARGUMENT` | Invalid plugin name format |
	// | `RESOURCE_EXHAUSTED` | Max plugins limit reached |
	// | `PERMISSION_DENIED` | Enterprise license required |
	CreatePlugin(ctx context.Context, in *CreatePluginRequest, opts ...grpc.CallOption) (*CreatePluginResponse, error)
	// Update an existing plugin.
	//
	// Replaces the config and tags of an existing plugin identified by group/name/version.
	// Requires an Enterprise license.
	//
	// ## Error Codes
	//
	// | Code | Description |
	// |------|-------------|
	// | `NOT_FOUND` | Plugin not found |
	// | `INVALID_ARGUMENT` | Invalid plugin name format |
	// | `PERMISSION_DENIED` | Enterprise license required |
	UpdatePlugin(ctx context.Context, in *UpdatePluginRequest, opts ...grpc.CallOption) (*UpdatePluginResponse, error)
	// Delete a plugin.
	//
	// Removes a plugin from the registry by group/name/version.
	// Requires an Enterprise license.
	//
	// ## Error Codes
	//
	// | Code | Description |
	// |------|-------------|
	// | `NOT_FOUND` | Plugin not found |
	// | `PERMISSION_DENIED` | Enterprise license required |
	DeletePlugin(ctx context.Context, in *DeletePluginRequest, opts ...grpc.CallOption) (*DeletePluginResponse, error)
}

type GeneratorAPIServer interface {
	// Generate code using a specified plugin.
	//
	// This method executes a protobuf code generation plugin and returns the generated files.
	// The plugin runs as a local child process under the limits described on the
	// service above — notably a time bound and an output-size bound, and notably
	// *not* a memory, CPU or network bound.
	//
	// This method is anonymous: it requires no credentials. Only the mutating
	// methods take a write token.
	//
	// ## Error Codes
	//
	// | Code | Description |
	// |------|-------------|
	// | `NOT_FOUND` | Plugin not found in registry |
	// | `INVALID_ARGUMENT` | Invalid plugin name format |
	// | `RESOURCE_EXHAUSTED` | The service is at its concurrency limit; retry later |
	// | `UNAVAILABLE` | Object storage is unreachable, or the service is shutting down |
	// | `FAILED_PRECONDITION` | The plugin is registered but its archive is not in storage |
	// | `INTERNAL` | Plugin execution failed |
	// | `DEADLINE_EXCEEDED` | Plugin execution timeout |
	GenerateCode(context.Context, *GenerateCodeRequest) (*GenerateCodeResponse, error)
	// List available plugins.
	//
	// Returns a list of all plugins registered in the service.
	// Use this to discover available plugins and their versions.
	Plugins(context.Context, *PluginsRequest) (*PluginsResponse, error)
	// Create a new plugin registration.
	//
	// Registers a plugin with the given group, name, version, optional config, and tags.
	// Requires an Enterprise license.
	//
	// ## Error Codes
	//
	// | Code | Description |
	// |------|-------------|
	// | `ALREADY_EXISTS` | Plugin with same group/name/version exists |
	// | `INVALID_ARGUMENT` | Invalid plugin name format |
	// | `RESOURCE_EXHAUSTED` | Max plugins limit reached |
	// | `PERMISSION_DENIED` | Enterprise license required |
	CreatePlugin(context.Context, *CreatePluginRequest) (*CreatePluginResponse, error)
	// Update an existing plugin.
	//
	// Replaces the config and tags of an existing plugin identified by group/name/version.
	// Requires an Enterprise license.
	//
	// ## Error Codes
	//
	// | Code | Description |
	// |------|-------------|
	// | `NOT_FOUND` | Plugin not found |
	// | `INVALID_ARGUMENT` | Invalid plugin name format |
	// | `PERMISSION_DENIED` | Enterprise license required |
	UpdatePlugin(context.Context, *UpdatePluginRequest) (*UpdatePluginResponse, error)
	// Delete a plugin.
	//
	// Removes a plugin from the registry by group/name/version.
	// Requires an Enterprise license.
	//
	// ## Error Codes
	//
	// | Code | Description |
	// |------|-------------|
	// | `NOT_FOUND` | Plugin not found |
	// | `PERMISSION_DENIED` | Enterprise license required |
	DeletePlugin(context.Context, *DeletePluginRequest) (*DeletePluginResponse, error)
}

type GeneratorAPIToolHandler interface {
	Plugins(ctx context.Context, req *PluginsRequest) (*PluginsResponse, error)
}

type PluginInfo struct {

	// Unique identifier for the plugin.
	//
	// This is an internal UUID assigned when the plugin is registered.
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// Group to which the plugin belongs.
	//
	// Groups organize plugins by maintainer or ecosystem.
	//
	// Common groups:
	// - `protocolbuffers` — Official Google protobuf plugins
	// - `grpc` — Official gRPC plugins
	// - `grpc-ecosystem` — gRPC ecosystem plugins (gateway, openapi)
	// - `community` — Community-maintained plugins
	Group string `protobuf:"bytes,2,opt,name=group,proto3" json:"group,omitempty"`
	// Name of the plugin.
	//
	// This is the plugin's identifier within its group.
	//
	// Examples: `go`, `python`, `gateway`, `openapiv2`
	Name string `protobuf:"bytes,3,opt,name=name,proto3" json:"name,omitempty"`
	// Version of the plugin.
	//
	// Follows semantic versioning (semver) format.
	Version string `protobuf:"bytes,4,opt,name=version,proto3" json:"version,omitempty"`
	// Timestamp when the plugin was registered.
	CreatedAt *timestamppb.Timestamp `protobuf:"bytes,5,opt,name=created_at,proto3" json:"created_at,omitempty"`
	// Tags associated with the plugin for categorization.
	//
	// Tags help organize and filter plugins by category.
	// Examples: `go`, `grpc`, `official`, `community`
	Tags []string `protobuf:"bytes,6,rep,name=tags,proto3" json:"tags,omitempty"`
	// contains filtered or unexported fields
}

type PluginsRequest struct {

	// Filter by exact plugin group.
	//
	// Omit to return plugins from all groups.
	Group *string `protobuf:"bytes,1,opt,name=group,proto3,oneof" json:"group,omitempty"`
	// Filter by exact plugin name.
	//
	// Omit to return plugins with any name.
	Name *string `protobuf:"bytes,2,opt,name=name,proto3,oneof" json:"name,omitempty"`
	// Filter by exact plugin version.
	//
	// Omit to return all versions.
	Version *string `protobuf:"bytes,3,opt,name=version,proto3,oneof" json:"version,omitempty"`
	// Filter by tags.
	//
	// A plugin must contain all specified tags to match.
	Tags []string `protobuf:"bytes,4,rep,name=tags,proto3" json:"tags,omitempty"`
	// Maximum number of plugins to return in one response.
	//
	// Omitting it (or zero) selects the server's default page size (100).
	// Values above the server's ceiling (1000) are cut down to it rather than
	// rejected.
	PageSize *uint32 `protobuf:"varint,5,opt,name=page_size,json=pageSize,proto3,oneof" json:"page_size,omitempty"`
	// Continuation token from a previous response's next_page_token.
	//
	// Omit to read the first page. The token is opaque: it is only meaningful
	// to the server that issued it, and only together with the same filters —
	// changing the filters between pages makes the result undefined.
	PageToken *string `protobuf:"bytes,6,opt,name=page_token,json=pageToken,proto3,oneof" json:"page_token,omitempty"`
	// contains filtered or unexported fields
}

type PluginsResponse struct {

	// List of available plugins matching the supplied filters.
	//
	// Plugins are sorted by group, name, and version.
	Plugins []*PluginInfo `protobuf:"bytes,1,rep,name=plugins,proto3" json:"plugins,omitempty"`
	// Token for the next page, empty when this response is the last page.
	//
	// Pass it back in PluginsRequest.page_token, with the same filters, to
	// continue the listing.
	NextPageToken string `protobuf:"bytes,3,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"`
	// contains filtered or unexported fields
}

type UnimplementedGeneratorAPIServer struct{}

type UnsafeGeneratorAPIServer interface {
	// contains filtered or unexported methods
}

type UpdatePluginRequest struct {

	// Group to which the plugin belongs.
	Group string `protobuf:"bytes,1,opt,name=group,proto3" json:"group,omitempty"`
	// Name of the plugin.
	Name string `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
	// Version of the plugin.
	Version string `protobuf:"bytes,3,opt,name=version,proto3" json:"version,omitempty"`
	// New plugin configuration.
	//
	// Replaces the existing config when `update_mask` selects it. Note that a
	// config is validated on the way in: `command[0]` must name the plugin
	// executable inside the service's plugins directory.
	Config *structpb.Struct `protobuf:"bytes,4,opt,name=config,proto3" json:"config,omitempty"`
	// New tags. Replaces the existing tags when `update_mask` selects them.
	Tags []string `protobuf:"bytes,5,rep,name=tags,proto3" json:"tags,omitempty"`
	// Fields to replace: any of "config", "tags".
	//
	// Omitting the mask replaces both, which is what this RPC has always done.
	//
	// The mask exists because "both, always" made a tag edit impossible: `config`
	// is validated before anything else, an absent one was an empty one, and the
	// call was rejected. Renaming a tag therefore meant resending the plugin's
	// whole command line, and getting that wrong is how a registry entry starts
	// pointing at the wrong binary.
	UpdateMask *fieldmaskpb.FieldMask `protobuf:"bytes,6,opt,name=update_mask,json=updateMask,proto3" json:"update_mask,omitempty"`
	// contains filtered or unexported fields
}

type UpdatePluginResponse struct {

	// The updated plugin information.
	Plugin *PluginInfo `protobuf:"bytes,1,opt,name=plugin,proto3" json:"plugin,omitempty"`
	// contains filtered or unexported fields
}