@routr/common 2.0.8-alpha.4 → 2.0.8-alpha.41

package/dist/connect/config.d.ts

@@ -0,0 +1,113 @@
+import { LoadBalancingAlgorithm, Privacy, Transport } from "../types";
+import { Kind } from "./types";
+export interface ConfigBase {
+    apiVersion: string;
+    ref: string;
+    metadata: {
+        name: string;
+    };
+}
+export interface AccessControlListConfig extends ConfigBase {
+    kind: Kind.ACL;
+    spec: {
+        accessControlList: {
+            allow: string[];
+            deny: string[];
+        };
+    };
+}
+export interface AgentConfig extends ConfigBase {
+    kind: Kind.AGENT;
+    spec: {
+        username: string;
+        domainRef: string;
+        credentialsRef: string;
+        privacy: Privacy;
+        enabled: boolean;
+    };
+}
+export interface PeerConfig extends ConfigBase {
+    kind: Kind.PEER;
+    spec: {
+        aor: string;
+        username: string;
+        credentialsRef?: string;
+        contactAddr?: string;
+        enabled?: boolean;
+        loadBalancing?: {
+            algorithm: LoadBalancingAlgorithm;
+            withSessionAffinity: boolean;
+        };
+    };
+}
+export interface CredentialsConfig extends ConfigBase {
+    kind: Kind.CREDENTIALS;
+    spec: {
+        credentials: {
+            username: string;
+            password: string;
+        };
+    };
+}
+export interface DomainConfig extends ConfigBase {
+    kind: Kind.DOMAIN;
+    spec: {
+        accessControlListRef?: string;
+        context: {
+            domainUri: string;
+            egressPolicies?: {
+                rule: string;
+                numberRef: string;
+            }[];
+        };
+    };
+}
+export interface NumberConfig extends Omit<ConfigBase, "metadata"> {
+    kind: Kind.NUMBER;
+    metadata: {
+        name: string;
+        geoInfo: {
+            city: string;
+            country: string;
+            countryISOCode: string;
+        };
+    };
+    spec: {
+        trunkRef: string;
+        location: {
+            telUrl: string;
+            aorLink: string;
+            sessionAffinityHeader: string;
+            extraHeaders: {
+                name: string;
+                value: string;
+            }[];
+        };
+    };
+}
+export interface TrunkConfig extends ConfigBase {
+    kind: Kind.TRUNK;
+    spec: {
+        inbound: {
+            uri: string;
+            accessControlListRef: string;
+            credentialsRef: string;
+        };
+        outbound: {
+            sendRegister: boolean;
+            credentialsRef: string;
+            uris: {
+                uri: {
+                    user: string;
+                    host: string;
+                    port: number;
+                    transport: Transport;
+                };
+                priority: number;
+                weight: number;
+                enabled: boolean;
+            }[];
+        };
+    };
+}
+export type UserConfig = AccessControlListConfig | AgentConfig | PeerConfig | CredentialsConfig | DomainConfig | NumberConfig | TrunkConfig;

package/dist/connect/config.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/connect/connect_error.d.ts

@@ -0,0 +1,21 @@
+import { HeaderModifier, ResponseType } from "../types";
+export declare const CodeToResponseTypeMap: {
+    401: ResponseType;
+    403: ResponseType;
+    500: ResponseType;
+};
+export interface ConnectError {
+    code: keyof typeof CodeToResponseTypeMap;
+    reason?: string;
+    headers: HeaderModifier[];
+}
+export declare const convertToErrorResponse: (connectError: ConnectError) => {
+    message: {
+        responseType: ResponseType;
+        reasonPhrase: string;
+        extensions: {
+            name: string;
+            value: string;
+        }[];
+    };
+};

package/dist/connect/connect_error.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertToErrorResponse = exports.CodeToResponseTypeMap = void 0;
+/*
+ * Copyright (C) 2023 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster
+ *
+ * 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 types_1 = require("../types");
+exports.CodeToResponseTypeMap = {
+    401: types_1.ResponseType.UNAUTHORIZED,
+    403: types_1.ResponseType.FORBIDDEN,
+    500: types_1.ResponseType.SERVER_ERROR
+};
+const convertToErrorResponse = (connectError) => {
+    return {
+        message: {
+            responseType: exports.CodeToResponseTypeMap[connectError.code],
+            reasonPhrase: connectError.reason,
+            extensions: connectError.headers.map((modifier) => {
+                if (modifier.action === types_1.HeaderModifierAction.ADD) {
+                    return {
+                        name: modifier.name,
+                        value: modifier.value
+                    };
+                }
+            })
+        }
+    };
+};
+exports.convertToErrorResponse = convertToErrorResponse;

package/dist/connect/index.d.ts

@@ -1,3 +1,8 @@
-export * from "./data_api";
-export * from "./grpc_client";
+export * from "./api";
+export * from "./client";
 export * from "./types";
+export * from "./config";
+export * from "./mappers";
+export * from "./assertions";
+export * from "./validations";
+export * from "./connect_error";

package/dist/connect/index.js

@@ -15,7 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 /*
- * Copyright (C) 2022 by Fonoster Inc (https://fonoster.com)
+ * Copyright (C) 2023 by Fonoster Inc (https://fonoster.com)
  * http://github.com/fonoster
  *
  * This file is part of Routr.
@@ -32,6 +32,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-__exportStar(require("./data_api"), exports);
-__exportStar(require("./grpc_client"), exports);
+__exportStar(require("./api"), exports);
+__exportStar(require("./client"), exports);
 __exportStar(require("./types"), exports);
+__exportStar(require("./config"), exports);
+__exportStar(require("./mappers"), exports);
+__exportStar(require("./assertions"), exports);
+__exportStar(require("./validations"), exports);
+__exportStar(require("./connect_error"), exports);

package/dist/connect/mappers/acl.d.ts

@@ -0,0 +1,3 @@
+import { AccessControlListConfig } from "../config";
+import { AccessControlList } from "../types";
+export declare function mapToACL(config: AccessControlListConfig): AccessControlList;

package/dist/connect/mappers/acl.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapToACL = void 0;
+const schemas_1 = require("../schemas");
+const types_1 = require("../types");
+const assertions_1 = require("./assertions");
+const valid = schemas_1.schemaValidators.get(types_1.Kind.ACL);
+function mapToACL(config) {
+    var _a, _b, _c, _d;
+    (0, assertions_1.assertValidSchema)(config, valid);
+    return {
+        apiVersion: config.apiVersion,
+        ref: config.ref,
+        name: config.metadata.name,
+        allow: (_b = (_a = config.spec.accessControlList) === null || _a === void 0 ? void 0 : _a.allow) !== null && _b !== void 0 ? _b : [],
+        deny: (_d = (_c = config.spec.accessControlList) === null || _c === void 0 ? void 0 : _c.deny) !== null && _d !== void 0 ? _d : []
+    };
+}
+exports.mapToACL = mapToACL;

package/dist/connect/mappers/agent.d.ts

@@ -0,0 +1,3 @@
+import { AgentConfig } from "../config";
+import { Agent } from "../types";
+export declare function mapToAgent(config: AgentConfig): Agent;

package/dist/connect/mappers/agent.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapToAgent = void 0;
+/*
+ * Copyright (C) 2023 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster
+ *
+ * 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.
+ */
+/* eslint-disable require-jsdoc */
+const types_1 = require("../../types");
+const schemas_1 = require("../schemas");
+const types_2 = require("../types");
+const assertions_1 = require("./assertions");
+const valid = schemas_1.schemaValidators.get(types_2.Kind.AGENT);
+function mapToAgent(config) {
+    var _a;
+    (0, assertions_1.assertValidSchema)(config, valid);
+    return {
+        apiVersion: config.apiVersion,
+        ref: config.ref,
+        name: config.metadata.name,
+        username: config.spec.username,
+        privacy: (_a = config.spec.privacy) !== null && _a !== void 0 ? _a : types_1.Privacy.NONE,
+        enabled: config.spec.enabled,
+        domainRef: config.spec.domainRef,
+        credentialsRef: config.spec.credentialsRef
+    };
+}
+exports.mapToAgent = mapToAgent;

package/dist/connect/mappers/assertions.d.ts

@@ -0,0 +1,3 @@
+import { UserConfig } from "../config";
+export declare const assertValidSchema: (config: UserConfig, valid: (config: UserConfig) => boolean) => void;
+export declare const assertValidAorSchema: (config: UserConfig) => void;

package/dist/connect/mappers/assertions.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertValidAorSchema = exports.assertValidSchema = void 0;
+/*
+ * Copyright (C) 2023 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster
+ *
+ * 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 logger_1 = require("@fonoster/logger");
+const logger = (0, logger_1.getLogger)({ service: "common", filePath: __filename });
+const assertValidSchema = (config, valid) => {
+    if (!valid(config)) {
+        const error = valid.errors[0];
+        logger.error("found a bad resource: " + error.message + " at `" + error.dataPath + "`");
+        process.exit(1);
+    }
+};
+exports.assertValidSchema = assertValidSchema;
+const assertValidAorSchema = (config) => {
+    const spec = config.spec;
+    if (spec.aor.startsWith("backend:") && !spec.loadBalancing) {
+        logger.error("found a bad resource: balancing algorithm is required for `backend:` aors");
+        process.exit(1);
+    }
+    if (spec.aor.startsWith("sip:") && spec.loadBalancing) {
+        logger.error("found a bad resource: balancing algorithm is not allowed for `sip:` aors");
+        process.exit(1);
+    }
+};
+exports.assertValidAorSchema = assertValidAorSchema;

package/dist/connect/mappers/credentials.d.ts

@@ -0,0 +1,3 @@
+import { CredentialsConfig } from "../config";
+import { Credentials } from "../types";
+export declare function mapToCredentials(config: CredentialsConfig): Credentials;

package/dist/connect/mappers/credentials.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapToCredentials = void 0;
+const schemas_1 = require("../schemas");
+const types_1 = require("../types");
+const assertions_1 = require("./assertions");
+const valid = schemas_1.schemaValidators.get(types_1.Kind.CREDENTIALS);
+function mapToCredentials(config) {
+    (0, assertions_1.assertValidSchema)(config, valid);
+    return {
+        apiVersion: config.apiVersion,
+        ref: config.ref,
+        name: config.metadata.name,
+        username: config.spec.credentials.username,
+        password: config.spec.credentials.password
+    };
+}
+exports.mapToCredentials = mapToCredentials;

package/dist/connect/mappers/domain.d.ts

@@ -0,0 +1,3 @@
+import { DomainConfig } from "../config";
+import { Domain } from "../types";
+export declare function mapToDomain(config: DomainConfig): Domain;

package/dist/connect/mappers/domain.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapToDomain = void 0;
+const schemas_1 = require("../schemas");
+const types_1 = require("../types");
+const assertions_1 = require("./assertions");
+const valid = schemas_1.schemaValidators.get(types_1.Kind.DOMAIN);
+function mapToDomain(config) {
+    (0, assertions_1.assertValidSchema)(config, valid);
+    return {
+        apiVersion: config.apiVersion,
+        ref: config.ref,
+        name: config.metadata.name,
+        domainUri: config.spec.context.domainUri,
+        accessControlListRef: config.spec.accessControlListRef,
+        egressPolicies: config.spec.context.egressPolicies
+    };
+}
+exports.mapToDomain = mapToDomain;

package/dist/connect/mappers/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./acl";
+export * from "./agent";
+export * from "./credentials";
+export * from "./trunk";
+export * from "./number";
+export * from "./peer";
+export * from "./domain";

package/dist/connect/mappers/index.js

@@ -0,0 +1,41 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/*
+ * Copyright (C) 2023 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster
+ *
+ * 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.
+ */
+__exportStar(require("./acl"), exports);
+__exportStar(require("./agent"), exports);
+__exportStar(require("./credentials"), exports);
+__exportStar(require("./trunk"), exports);
+__exportStar(require("./number"), exports);
+__exportStar(require("./peer"), exports);
+__exportStar(require("./domain"), exports);

package/dist/connect/mappers/number.d.ts

@@ -0,0 +1,3 @@
+import { NumberConfig } from "../config";
+import { INumber } from "../types";
+export declare function mapToNumber(config: NumberConfig): INumber;

package/dist/connect/mappers/number.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapToNumber = void 0;
+const schemas_1 = require("../schemas");
+const types_1 = require("../types");
+const assertions_1 = require("./assertions");
+const valid = schemas_1.schemaValidators.get(types_1.Kind.NUMBER);
+function mapToNumber(config) {
+    (0, assertions_1.assertValidSchema)(config, valid);
+    const metadata = config.metadata;
+    const location = config.spec.location;
+    return {
+        apiVersion: config.apiVersion,
+        ref: config.ref,
+        name: metadata.name,
+        city: metadata.geoInfo.city,
+        country: metadata.geoInfo.country,
+        countryIsoCode: metadata.geoInfo.countryISOCode,
+        telUrl: location.telUrl,
+        aorLink: location.aorLink,
+        sessionAffinityHeader: location.sessionAffinityHeader,
+        extraHeaders: location.extraHeaders,
+        trunkRef: config.spec.trunkRef
+    };
+}
+exports.mapToNumber = mapToNumber;

package/dist/connect/mappers/peer.d.ts

@@ -0,0 +1,3 @@
+import { PeerConfig } from "../config";
+import { Peer } from "../types";
+export declare function mapToPeer(config: PeerConfig): Peer;

package/dist/connect/mappers/peer.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapToPeer = void 0;
+const schemas_1 = require("../schemas");
+const types_1 = require("../types");
+const assertions_1 = require("./assertions");
+const valid = schemas_1.schemaValidators.get(types_1.Kind.PEER);
+function mapToPeer(config) {
+    var _a, _b;
+    (0, assertions_1.assertValidSchema)(config, valid);
+    (0, assertions_1.assertValidAorSchema)(config);
+    const normalizeAlgorithm = (algorithm) => algorithm === null || algorithm === void 0 ? void 0 : algorithm.replace(/-/g, "_").toUpperCase();
+    return {
+        apiVersion: config.apiVersion,
+        ref: config.ref,
+        name: config.metadata.name,
+        username: config.spec.username,
+        aor: config.spec.aor,
+        contactAddr: config.spec.contactAddr,
+        enabled: config.spec.enabled,
+        credentialsRef: config.spec.credentialsRef,
+        balancingAlgorithm: normalizeAlgorithm((_a = config.spec.loadBalancing) === null || _a === void 0 ? void 0 : _a.algorithm),
+        withSessionAffinity: (_b = config.spec.loadBalancing) === null || _b === void 0 ? void 0 : _b.withSessionAffinity
+    };
+}
+exports.mapToPeer = mapToPeer;

package/dist/connect/mappers/trunk.d.ts

@@ -0,0 +1,3 @@
+import { TrunkConfig } from "../config";
+import { Trunk } from "../types";
+export declare function mapToTrunk(config: TrunkConfig): Trunk;

package/dist/connect/mappers/trunk.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapToTrunk = void 0;
+const schemas_1 = require("../schemas");
+const types_1 = require("../types");
+const assertions_1 = require("./assertions");
+const valid = schemas_1.schemaValidators.get(types_1.Kind.TRUNK);
+function mapToTrunk(config) {
+    var _a, _b, _c, _d, _e, _f;
+    (0, assertions_1.assertValidSchema)(config, valid);
+    return {
+        apiVersion: config.apiVersion,
+        ref: config.ref,
+        name: config.metadata.name,
+        sendRegister: config.spec.outbound.sendRegister,
+        inboundUri: (_a = config.spec.inbound) === null || _a === void 0 ? void 0 : _a.uri,
+        inboundCredentialsRef: (_b = config.spec.inbound) === null || _b === void 0 ? void 0 : _b.credentialsRef,
+        outboundCredentialsRef: (_c = config.spec.outbound) === null || _c === void 0 ? void 0 : _c.credentialsRef,
+        accessControlListRef: (_d = config.spec.inbound) === null || _d === void 0 ? void 0 : _d.accessControlListRef,
+        uris: (_f = (_e = config.spec.outbound) === null || _e === void 0 ? void 0 : _e.uris) === null || _f === void 0 ? void 0 : _f.map((entry) => {
+            var _a;
+            return {
+                user: entry.uri.user,
+                host: entry.uri.host,
+                port: entry.uri.port,
+                transport: (_a = entry.uri.transport) === null || _a === void 0 ? void 0 : _a.toUpperCase(),
+                enabled: entry.enabled,
+                weight: entry.weight,
+                priority: entry.priority
+            };
+        })
+    };
+}
+exports.mapToTrunk = mapToTrunk;

package/dist/connect/protos/acl.proto

@@ -0,0 +1,112 @@
+/*
+ * Copyright (C) 2023 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.
+ */
+syntax = "proto3";
+
+package fonoster.routr.connect.acl.v2draft1;
+
+import "google/protobuf/struct.proto";
+import "google/protobuf/empty.proto";
+
+// AccessControlList(ACL) service definition
+service ACLService {
+  // Create a new ACL
+  rpc Create (CreateACLRequest) returns (AccessControlList) {}
+  // Update an existing ACL
+  rpc Update (UpdateACLRequest) returns (AccessControlList) {}
+  // Get an existing ACL
+  rpc Get (GetACLRequest) returns (AccessControlList) {}
+  // Delete an existing ACL
+  rpc Delete (DeleteACLRequest) returns (.google.protobuf.Empty) {}
+  // Get a list of ACLs
+  rpc List (ListACLsRequest) returns (ListACLsResponse) {}
+}
+
+// The message for AccessControlList resource
+message AccessControlList {
+  // The version of the API
+  string api_version = 1;
+  // The ACL reference
+  string ref = 2;
+  // A friendly name for the ACL
+  string name = 3;
+  // The list of allowed IP addresses
+  repeated string allow = 4;
+  // The list of denied IP addresses
+  repeated string deny = 5;
+  // The date the ACL was created
+  int32 created_at = 6;
+  // The date the ACL was last updated
+  int32 updated_at = 7;
+  // The extended attributes of the ACL
+  .google.protobuf.Struct extended = 8;
+}
+
+// The request message for the AccessControlList.Create method
+message CreateACLRequest {
+  // A friendly name for the ACL
+  string name = 2;
+  // The list of allowed IP addresses
+  repeated string allow = 3;
+  // The list of denied IP addresses
+  repeated string deny = 4;
+  // The extended attributes of the ACL
+  .google.protobuf.Struct extended = 5;  
+}
+
+// The request message for the AccessControlList.Update method
+message UpdateACLRequest {
+  // The ACL reference
+  string ref = 1;
+  // A friendly name for the ACL
+  string name = 2;
+  // The list of allowed IP addresses
+  repeated string allow = 3;
+  // The list of denied IP addresses
+  repeated string deny = 4;
+  // The extended attributes of the ACL
+  .google.protobuf.Struct extended = 5;
+} 
+
+// The request message for the AccessControlList.Get method
+message GetACLRequest  {
+  string ref = 1;
+}
+
+// The request message for the AccessControlList.Delete method
+message DeleteACLRequest  {
+  string ref = 1;
+}
+
+// The request message for the AccessControlList.List method
+message ListACLsRequest {
+  // 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 response message for the AccessControlList.List method
+message ListACLsResponse {
+  // List of items
+  repeated AccessControlList items = 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;
+}