@routr/common 2.0.8-alpha.2 → 2.0.8-alpha.20

package/dist/index.js

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommonRequester = exports.CommonConnect = exports.Assertions = exports.Tracer = exports.IpUtils = exports.Helper = exports.CommonTypes = exports.Redis = exports.LOCATION_OBJECT_PROTO = exports.PROCESSOR_OBJECT_PROTO = exports.Method = exports.Transport = exports.ServiceUnavailableError = exports.calculateAuthResponse = exports.generateNonce = exports.getObjectProto = exports.createService = void 0;
+exports.ConnectSchemas = exports.CommonErrors = exports.CommonTypes = exports.CommonRequester = exports.CommonConnect = exports.Assertions = exports.Tracer = exports.IpUtils = exports.Helper = exports.Redis = exports.Auth = exports.LOCATION_OBJECT_PROTO = exports.PROCESSOR_OBJECT_PROTO = exports.Method = exports.Transport = exports.getObjectProto = exports.createService = void 0;
 /*
  * Copyright (C) 2022 by Fonoster Inc (https://fonoster.com)
  * http://github.com/fonoster/routr
@@ -42,11 +42,6 @@ exports.CommonRequester = exports.CommonConnect = exports.Assertions = exports.T
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-const auth_1 = require("./auth");
-Object.defineProperty(exports, "calculateAuthResponse", { enumerable: true, get: function () { return auth_1.calculateAuthResponse; } });
-Object.defineProperty(exports, "generateNonce", { enumerable: true, get: function () { return auth_1.generateNonce; } });
-const errors_1 = require("./errors");
-Object.defineProperty(exports, "ServiceUnavailableError", { enumerable: true, get: function () { return errors_1.ServiceUnavailableError; } });
 const service_1 = __importStar(require("./service"));
 exports.createService = service_1.default;
 Object.defineProperty(exports, "getObjectProto", { enumerable: true, get: function () { return service_1.getObjectProto; } });
@@ -55,11 +50,14 @@ Object.defineProperty(exports, "PROCESSOR_OBJECT_PROTO", { enumerable: true, get
 const types_1 = require("./types");
 Object.defineProperty(exports, "Method", { enumerable: true, get: function () { return types_1.Method; } });
 Object.defineProperty(exports, "Transport", { enumerable: true, get: function () { return types_1.Transport; } });
+exports.Auth = __importStar(require("./auth"));
 exports.Redis = __importStar(require("./redis"));
-exports.CommonTypes = __importStar(require("./types"));
 exports.Helper = __importStar(require("./helper"));
 exports.IpUtils = __importStar(require("./ip_utils"));
 exports.Tracer = __importStar(require("./tracer"));
 exports.Assertions = __importStar(require("./assertions"));
 exports.CommonConnect = __importStar(require("./connect"));
 exports.CommonRequester = __importStar(require("./requester"));
+exports.CommonTypes = __importStar(require("./types"));
+exports.CommonErrors = __importStar(require("./errors"));
+exports.ConnectSchemas = __importStar(require("./connect/schemas"));

package/dist/protos/common.proto

@@ -33,5 +33,3 @@ enum Transport {
   WS = 4;
   WSS = 5;
 }
-
-message Empty {}

package/dist/protos/location.proto

@@ -25,16 +25,17 @@ option java_package = "io.routr.location";
 option java_outer_classname = "LocationProto";
 option objc_class_prefix = "LC";
 
+import "google/protobuf/empty.proto";
 import "common.proto";
 import "processor.proto";
 
 service Location {
-  rpc AddRoute (AddRouteRequest) returns (fonoster.routr.common.v2draft1.Empty) {}
+  rpc AddRoute (AddRouteRequest) returns (.google.protobuf.Empty) {}
   rpc FindRoutes (FindRoutesRequest) returns (FindRoutesResponse) {}
-  rpc RemoveRoutes (RemoveRoutesRequest) returns (fonoster.routr.common.v2draft1.Empty) {}
+  rpc RemoveRoutes (RemoveRoutesRequest) returns (.google.protobuf.Empty) {}
 }
 
-// A binding create by an actual endpoint (Softphone, PBX, Conference System, etc.)
+// A binding created by an actual endpoint (Softphone, PBX, Conference System, etc.)
 message Route {
   string user = 1;
   string host = 2;
@@ -44,11 +45,13 @@ message Route {
   int32 expires = 6;
   int32 session_count = 7;
   string edge_port_ref = 8;
-  fonoster.routr.processor.v2draft1.NetInterface egress_listening_point = 9;
+  repeated fonoster.routr.processor.v2draft1.NetInterface listening_points = 9;
+  repeated string localnets = 10;
+  repeated string external_addrs = 11;
   // During route creation, an endpoint can request to add labels than can later be
   // used as selectors. For example, a Softphone can add a label `priority=1` to indicate
   // that it is the prefered endpoint for the given AOR.
-  map<string, string> labels = 10;
+  map<string, string> labels = 12;
 }
 
 message AddRouteRequest {
@@ -58,8 +61,20 @@ message AddRouteRequest {
 }
 
 message FindRoutesRequest {
-  string aor = 1;
-  map<string, string> labels = 2;
+  message Backend {
+    enum Algoritm {
+      ROUND_ROBIN = 0;
+      LEAST_SESSIONS = 1;
+    }
+    string ref = 1;
+    bool with_session_affinity = 2;
+    Algoritm algorithm = 3;
+  }
+  string call_id = 1;
+  string aor = 2;
+  string session_affinity_ref = 3;
+  Backend backend = 4;
+  map<string, string> labels = 5;
 }
 
 message FindRoutesResponse {

package/dist/protos/sipmessage.proto

@@ -207,4 +207,6 @@ message SIPMessage {
   repeated Via via = 13;
   repeated Route route = 14;
   repeated RecordRoute record_route = 15;
+  string reason_phrase = 16;
+  string body = 17;
 }

package/dist/service.d.ts

@@ -1,5 +1,5 @@
 import { ObjectProto, ServiceInfo } from "./types";
-import { ServiceDefinitionNotFound } from "./errors";
+import { ServiceDefinitionNotFoundError } from "./errors";
 export declare const PROCESSOR_OBJECT_PROTO: unknown;
 export declare const LOCATION_OBJECT_PROTO: unknown;
 /**
@@ -8,7 +8,7 @@ export declare const LOCATION_OBJECT_PROTO: unknown;
  * @param {ObjectProt} objectProto - The object proto to load.
  * @return {A} The proto definition.
  */
-export declare function getObjectProto<A>(objectProto: ObjectProto): A | ServiceDefinitionNotFound;
+export declare function getObjectProto<A>(objectProto: ObjectProto): A | ServiceDefinitionNotFoundError;
 /**
  * Creates a new service using the given service definition.
  *

package/dist/service.js

@@ -62,7 +62,7 @@ function getObjectProto(objectProto) {
     const objProto = (_b = (_a = grpc.loadPackageDefinition(definitions)) === null || _a === void 0 ? void 0 : _a.fonoster) === null || _b === void 0 ? void 0 : _b.routr[objectProto.name];
     return (objProto === null || objProto === void 0 ? void 0 : objProto[objectProto.version])
         ? objProto[objectProto.version]
-        : new errors_1.ServiceDefinitionNotFound(objectProto.name, objectProto.version);
+        : new errors_1.ServiceDefinitionNotFoundError(objectProto.name, objectProto.version);
 }
 exports.getObjectProto = getObjectProto;
 /**

package/dist/types.d.ts

@@ -1,4 +1,7 @@
+import * as grpc from "@grpc/grpc-js";
 import { ServiceDefinition } from "@grpc/proto-loader";
+import { JsonArray, JsonValue, Struct } from "pb-util/build";
+export type JsonData = Record<string, string | number | boolean | JsonValue | JsonArray | Struct>;
 export declare enum Method {
     UNKNOWN = "UNKNOWN",
     REGISTER = "REGISTER",
@@ -13,23 +16,32 @@ export declare enum Method {
     OPTIONS = "OPTIONS"
 }
 export declare enum Transport {
-    TCP = "tcp",
-    UDP = "udp",
-    TLS = "tls",
-    SCTP = "sctp",
-    WS = "ws",
-    WSS = "wss"
+    TCP = "TCP",
+    UDP = "UDP",
+    TLS = "TLS",
+    SCTP = "SCTP",
+    WS = "WS",
+    WSS = "WSS"
+}
+export declare enum LoadBalancingAlgorithm {
+    ROUND_ROBIN = "ROUND-ROBIN",
+    LEAST_SESSIONS = "LEAST-SESSIONS"
 }
 export declare enum ExtraHeader {
     REQUEST_URI = "X-Request-Uri",
     GATEWAY_AUTH = "X-Gateway-Auth",
     EDGEPORT_REF = "X-Edgeport-Ref",
-    SESSION_COUNT = "X-Session-Count"
+    SESSION_COUNT = "X-Session-Count",
+    DOD_NUMBER = "X-DOD-Number",
+    DOD_PRIVACY = "X-DOD-Privacy"
 }
 export declare enum Privacy {
-    NONE = "none",
-    PRIVATE = "id"
+    NONE = "NONE",
+    PRIVATE = "ID"
 }
+export type AuthorizationAlgorithm = "MD5";
+export type AuthorizationScheme = "Digest";
+export type Qop = "auth" | "auth-int" | "";
 export interface NetInterface {
     host: string;
     port: number;
@@ -72,32 +84,32 @@ export interface ObjectProto {
 export interface AuthChallengeRequest {
     realm: string;
     domain: string;
-    scheme: string;
-    nonce: string;
-    algorithm: string;
-    qop: string;
     opaque: string;
     stale: boolean;
+    nonce: string;
+    scheme: AuthorizationScheme;
+    algorithm: AuthorizationAlgorithm;
+    qop: Qop;
 }
 export interface AuthChallengeResponse {
     realm: string;
     domain: string;
-    scheme: string;
     cNonce: string;
+    nonce: string;
     nonceCount: number;
     response: string;
     username: string;
-    nonce: string;
-    algorithm: string;
-    qop: string;
     opaque: string;
     stale: boolean;
     uri: string;
-    method: string;
+    method: Method;
+    scheme: AuthorizationScheme;
+    algorithm: AuthorizationAlgorithm;
+    qop: Qop;
 }
 export declare enum HeaderModifierAction {
-    ADD = "add",
-    REMOVE = "remove"
+    ADD = 0,
+    REMOVE = 1
 }
 export interface HeaderModifier {
     name: string;
@@ -110,10 +122,19 @@ export interface Route {
     port: number;
     transport: Transport;
     registeredOn?: number;
+    /**
+     * Number of active sessions. This is used to determine if a route is
+     * overloaded and for load balancing.
+     *
+     * This value is reported by the endpoint during the REGISTER request,
+     * using the X-Session-Count header.
+     */
     sessionCount?: number;
     expires?: number;
     edgePortRef: string;
-    egressListeningPoint: NetInterface;
+    listeningPoints: NetInterface[];
+    localnets: string[];
+    externalAddrs: string[];
     labels?: Map<string, string>;
     headers?: HeaderModifier[];
 }
@@ -189,17 +210,17 @@ export interface WWWAuthenticate {
 }
 export interface Authorization {
     realm: string;
-    scheme: string;
+    scheme: AuthorizationScheme;
     nonce: string;
     cNonce: string;
     nonceCount: number;
     response: string;
     username: string;
     uri: string;
-    algorithm: string;
-    qop: string;
+    algorithm: AuthorizationAlgorithm;
+    qop: Qop;
     opaque: string;
-    method?: string;
+    method?: Method;
 }
 export interface CallID {
     callId: string;
@@ -221,7 +242,7 @@ export interface SipURI {
     user?: string;
     host: string;
     port?: number;
-    transportParam: string;
+    transportParam: Transport;
     mAddrParam?: string;
     userParam?: string;
     ttlParam?: number;
@@ -281,10 +302,10 @@ export interface SIPMessage {
     wwwAuthenticate?: WWWAuthenticate;
     maxForwards: MaxForwards;
     authorization?: Authorization;
-    extensions?: Extension[];
-    via?: Via[];
-    route?: RouteHeader[];
-    recordRoute?: RecordRoute[];
+    extensions: Extension[];
+    via: Via[];
+    route: RouteHeader[];
+    recordRoute: RecordRoute[];
 }
 export interface GrpcCallback {
     (error: Error | {
@@ -293,4 +314,5 @@ export interface GrpcCallback {
 }
 export interface GrpcCall {
     request: Record<string, any>;
+    metadata?: grpc.Metadata;
 }

package/dist/types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MessageType = exports.ResponseType = exports.HeaderModifierAction = exports.Privacy = exports.ExtraHeader = exports.Transport = exports.Method = void 0;
+exports.MessageType = exports.ResponseType = exports.HeaderModifierAction = exports.Privacy = exports.ExtraHeader = exports.LoadBalancingAlgorithm = exports.Transport = exports.Method = void 0;
 var Method;
 (function (Method) {
     Method["UNKNOWN"] = "UNKNOWN";
@@ -17,29 +17,36 @@ var Method;
 })(Method = exports.Method || (exports.Method = {}));
 var Transport;
 (function (Transport) {
-    Transport["TCP"] = "tcp";
-    Transport["UDP"] = "udp";
-    Transport["TLS"] = "tls";
-    Transport["SCTP"] = "sctp";
-    Transport["WS"] = "ws";
-    Transport["WSS"] = "wss";
+    Transport["TCP"] = "TCP";
+    Transport["UDP"] = "UDP";
+    Transport["TLS"] = "TLS";
+    Transport["SCTP"] = "SCTP";
+    Transport["WS"] = "WS";
+    Transport["WSS"] = "WSS";
 })(Transport = exports.Transport || (exports.Transport = {}));
+var LoadBalancingAlgorithm;
+(function (LoadBalancingAlgorithm) {
+    LoadBalancingAlgorithm["ROUND_ROBIN"] = "ROUND-ROBIN";
+    LoadBalancingAlgorithm["LEAST_SESSIONS"] = "LEAST-SESSIONS";
+})(LoadBalancingAlgorithm = exports.LoadBalancingAlgorithm || (exports.LoadBalancingAlgorithm = {}));
 var ExtraHeader;
 (function (ExtraHeader) {
     ExtraHeader["REQUEST_URI"] = "X-Request-Uri";
     ExtraHeader["GATEWAY_AUTH"] = "X-Gateway-Auth";
     ExtraHeader["EDGEPORT_REF"] = "X-Edgeport-Ref";
     ExtraHeader["SESSION_COUNT"] = "X-Session-Count";
+    ExtraHeader["DOD_NUMBER"] = "X-DOD-Number";
+    ExtraHeader["DOD_PRIVACY"] = "X-DOD-Privacy";
 })(ExtraHeader = exports.ExtraHeader || (exports.ExtraHeader = {}));
 var Privacy;
 (function (Privacy) {
-    Privacy["NONE"] = "none";
-    Privacy["PRIVATE"] = "id";
+    Privacy["NONE"] = "NONE";
+    Privacy["PRIVATE"] = "ID";
 })(Privacy = exports.Privacy || (exports.Privacy = {}));
 var HeaderModifierAction;
 (function (HeaderModifierAction) {
-    HeaderModifierAction["ADD"] = "add";
-    HeaderModifierAction["REMOVE"] = "remove";
+    HeaderModifierAction[HeaderModifierAction["ADD"] = 0] = "ADD";
+    HeaderModifierAction[HeaderModifierAction["REMOVE"] = 1] = "REMOVE";
 })(HeaderModifierAction = exports.HeaderModifierAction || (exports.HeaderModifierAction = {}));
 var ResponseType;
 (function (ResponseType) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@routr/common",
-  "version": "2.0.8-alpha.2",
+  "version": "2.0.8-alpha.20",
   "description": "Common package",
   "author": "Pedro Sanders <psanders@fonoster.com>",
   "homepage": "https://github.com/fonoster/routr#readme",
@@ -10,11 +10,11 @@
   "scripts": {
     "prebuild": "rimraf ./dist tsconfig.tsbuildinfo",
     "build": "tsc -b tsconfig.json",
-    "postbuild": "mkdir -p dist/protos && cp src/protos/* dist/protos"
+    "postbuild": "cp -a src/protos dist/protos && cp -a src/connect/protos dist/connect/protos"
   },
   "dependencies": {
     "@fonoster/logger": "0.3.18",
-    "@grpc/grpc-js": "^1.5.9",
+    "@grpc/grpc-js": "^1.8.4",
     "@grpc/proto-loader": "^0.6.9",
     "@opentelemetry/api": "^1.0.4",
     "@opentelemetry/exporter-jaeger": "^1.0.4",
@@ -24,9 +24,12 @@
     "@opentelemetry/sdk-trace-base": "^1.0.4",
     "@opentelemetry/sdk-trace-node": "^1.0.4",
     "@opentelemetry/semantic-conventions": "^1.0.4",
+    "ajv": "^6.12.6",
     "fp-ts": "^2.11.8",
     "ip-utils": "^2.4.0",
-    "pb-util": "^1.0.3"
+    "js-yaml": "^4.1.0",
+    "pb-util": "^1.0.3",
+    "toml": "^3.0.0"
   },
   "directories": {
     "src": "src",
@@ -45,5 +48,8 @@
   "bugs": {
     "url": "https://github.com/fonoster/routr/issues"
   },
-  "gitHead": "28ab976b0ef8b5cd34e278ea6fda13c518d7d052"
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.5"
+  },
+  "gitHead": "a22ee8342d03f5dfe46fddba89ffe3e6d0d5deb6"
 }

package/dist/connect/data_api.d.ts

@@ -1,11 +0,0 @@
-import { FindParameters, Resource } from "./types";
-/**
- * Data API for the Connect module.
- *
- * @param {string} apiAddr - The address of the API server
- * @return {Promise<Resource[]>}
- */
-export declare function dataAPI(apiAddr: string): {
-    get: (ref: string) => Promise<Resource>;
-    findBy: (request: FindParameters) => Promise<Resource[]>;
-};

package/dist/connect/data_api.js

@@ -1,91 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.dataAPI = void 0;
-/*
- * Copyright (C) 2022 by Fonoster Inc (https://fonoster.com)
- * http://github.com/fonoster/routr
- *
- * This file is part of Routr
- *
- * Licensed under the MIT License (the "License");
- * you may not use this file except in compliance with
- * the License. You may obtain a copy of the License at
- *
- *    https://opensource.org/licenses/MIT
- *
- * 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.
- */
-const grpc = __importStar(require("@grpc/grpc-js"));
-const protobufUtil = __importStar(require("pb-util"));
-const errors_1 = require("../errors");
-const grpc_client_1 = require("./grpc_client");
-const jsonToStruct = protobufUtil.struct.encode;
-const jsonFromStruct = protobufUtil.struct.decode;
-/**
- * Data API for the Connect module.
- *
- * @param {string} apiAddr - The address of the API server
- * @return {Promise<Resource[]>}
- */
-function dataAPI(apiAddr) {
-    const client = new grpc_client_1.RESOURCES_PROTO.v2draft1.Resources(apiAddr, grpc.credentials.createInsecure());
-    return {
-        get: (ref) => new Promise((resolve, reject) => {
-            client.get({ ref }, (err, response) => {
-                if (err) {
-                    return (err === null || err === void 0 ? void 0 : err.code) === grpc.status.UNAVAILABLE
-                        ? reject(new errors_1.ServiceUnavailableError(`api server at ${apiAddr} is unavailable`))
-                        : reject(err);
-                }
-                // Convert back to Json
-                response.spec = jsonFromStruct(response.spec);
-                resolve(response);
-            });
-        }),
-        findBy: (request) => new Promise((resolve, reject) => {
-            request.parameters = jsonToStruct(request.parameters);
-            client.findBy(request, (err, response) => {
-                var _a;
-                if (err) {
-                    return (err === null || err === void 0 ? void 0 : err.code) === grpc.status.UNAVAILABLE
-                        ? reject(new errors_1.ServiceUnavailableError(`api server at ${apiAddr} is unavailable`))
-                        : reject(err);
-                }
-                const res = (_a = response === null || response === void 0 ? void 0 : response.resources) === null || _a === void 0 ? void 0 : _a.map((resource) => {
-                    // Convert back to Json
-                    resource.spec = jsonFromStruct(resource.spec);
-                    return resource;
-                });
-                resolve(res);
-            });
-        })
-    };
-}
-exports.dataAPI = dataAPI;

package/dist/connect/grpc_client.d.ts

@@ -1 +0,0 @@
-export declare const RESOURCES_PROTO: any;

package/dist/protos/resources.proto

@@ -1,108 +0,0 @@
-// TODO: Show a link to were this proto was downloaded from
-syntax = "proto3";
-
-package fonoster.routr.resources.v2draft1;
-
-import "google/protobuf/struct.proto";
-
-// Resources service
-service Resources {
-  rpc Create (CreateRequest) returns (Resource) {}
-  rpc Update (UpdateRequest) returns (Resource) {}
-  rpc Get (GetRequest) returns (Resource) {}
-  rpc Delete (DeleteRequest) returns (Empty) {}
-  rpc List (ListRequest) returns (ListResponse) {}
-  rpc FindBy (FindByRequest) returns (FindByResponse) {}
-}
-
-message Metadata {
-  // The resource's name
-  string name = 1;
-  // Created at
-  int32 create_time = 2;
-  // Updated at
-  int32 update_time = 3;
-}
-
-message Resource {
-  // The resource's api version
-  string apiVersion = 1;
-  // The resource's kind
-  string kind = 2;
-  // The resource's unique identifier
-  string ref = 3;
-  // The resource's metadata
-  Metadata metadata = 4;
-  // The resource's data
-  .google.protobuf.Struct spec = 5;
-}
-
-message CreateRequest  {
-  Metadata metadata = 1;
-  .google.protobuf.Struct spec = 2;
-}
-
-message UpdateRequest  {
-  Metadata metadata = 1;
-  .google.protobuf.Struct spec = 2;
-}
-
-message DeleteRequest  {
-  string ref = 1;
-}
-
-message GetRequest  {
-  string ref = 1;
-}
-
-message ListRequest {
-  // The maximum number of items in the list
-  int32 page_size = 1;
-
-  // The next_page_token value returned from the previous request, if any
-  string page_token = 2;
-
-  // The filter to apply to the list
-  string filter = 3;
-
-  // The type of resource to list
-  string kind = 4;
-
-  // Level of detail of the individual entities (reserved)
-  View view = 5;
-}
-
-message ListResponse {
-  // List of Resources
-  repeated Resource resources = 1;
-
-  // Token to retrieve the next page of results, or empty if there are no more results in the list
-  string next_page_token = 2;
-}
-
-message FindByRequest {
-  // The type of resource to find
-  string kind = 1;
-
-  // Search criteria for the request
-  string criteria = 2;
-
-  // Parameters to apply in combination with the search criteria
-  .google.protobuf.Struct parameters = 3; 
-
-  // Level of detail of the individual entities (reserved)
-  View view = 4;
-}
-
-message FindByResponse {
-  // List of Resources
-  repeated Resource resources = 1;
-}
-
-enum View {
-  BASIC = 0;
-  STANDARD = 1;
-  FULL = 2;
-}
-
-message Empty {}