Grpc transcoding support

.github/workflows/ci-protobuf.yml

@@ -24,5 +24,5 @@ jobs:
         project: protobuf
         dotnet_solution: dotnet/protobuf/KinNekoDe.ApiContract.Protobuf.sln
         golang_module: golang/kinnekode/protobuf
-        major_minor_patch: 0.2.10
+        major_minor_patch: 0.2.11
       secrets: inherit

.github/workflows/ci-restaurant.yml

@@ -24,5 +24,5 @@ jobs:
         project: restaurant
         dotnet_solution: dotnet/restaurant/KinNekoDe.ApiContract.Restaurant.sln
         golang_module: golang/kinnekode/restaurant
-        major_minor_patch: 0.1.2
+        major_minor_patch: 0.1.3
       secrets: inherit

proto/google/api/README.md

@@ -0,0 +1,46 @@
+## API Protos
+
+This folder contains the schema of the configuration model for Google's
+internal API serving platform, which handles routing, quotas, monitoring,
+logging, and the like.
+
+Google refers to this configuration colloquially as the "service config",
+and the `service.proto` file in this directory is the entry point for
+understanding these.
+
+## Using these protos
+
+To be honest, we probably open sourced way too much of this (basically by
+accident). There are a couple files in here you are most likely to be
+interested in: `http.proto`, `documentation.proto`, `auth.proto`, and
+`annotations.proto`.
+
+### HTTP and REST
+
+The `http.proto` file contains the `Http` message (which then is wrapped
+in an annotation in `annotations.proto`), which provides a specification
+for REST endpoints and verbs (`GET`, `POST`, etc.) on RPC methods.
+We recommend use of this annotation for describing the relationship
+between RPCs and REST endpoints.
+
+### Documentation
+
+The `documentation.proto` file contains a `Documentation` message which
+provides a mechanism to fully describe an API, allowing a tool to build
+structured documentation artifacts.
+
+### Authentication
+
+The `auth.proto` file contains descriptions of both authentication rules
+and authenticaion providers, allowing you to describe what your services
+expect and accept from clients.
+
+## api-compiler
+
+Google provides a tool called [api-compiler][], which is a tool that accepts
+a protocol buffer descriptor and a YAML file specifying some of the
+options described in `service.proto`, and outputs a much more thorough
+`Service` descriptor based on the information it infers from the protos
+themselves.
+
+  [api-compiler]: https://github.com/googleapis/api-compiler

proto/google/api/annotations.proto

@@ -0,0 +1,31 @@
+// Copyright (c) 2015, Google Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.api;
+
+import "google/api/http.proto";
+import "google/protobuf/descriptor.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/api/annotations;annotations";
+option java_multiple_files = true;
+option java_outer_classname = "AnnotationsProto";
+option java_package = "com.google.api";
+option objc_class_prefix = "GAPI";
+
+extend google.protobuf.MethodOptions {
+  // See `HttpRule`.
+  HttpRule http = 72295728;
+}