@fonoster/common 0.5.5 → 0.6.0

package/dist/protos/applications.proto

@@ -0,0 +1,154 @@
+/*
+ * Copyright (C) 2024 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * 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.applications.v1beta2;
+
+import "google/protobuf/struct.proto";
+
+// Applications service definition
+service Applications {
+  // Create a new application
+  rpc CreateApplication(CreateApplicationRequest) returns (CreateApplicationResponse) {}
+  // Get an application
+  rpc GetApplication(GetApplicationRequest) returns (Application) {}
+  // List applications
+  rpc ListApplications(ListApplicationsRequest) returns (ListApplicationsResponse) {}
+  // Update an application
+  rpc UpdateApplication(UpdateApplicationRequest) returns (UpdateApplicationResponse) {}
+  // Delete an application
+  rpc DeleteApplication(DeleteApplicationRequest) returns (DeleteApplicationResponse) {}
+}
+
+// The type of application
+enum ApplicationType {
+  // Programmable Voice
+  PROGRAMMABLE_VOICE = 0;
+}
+
+message ProductContainer {
+  // Product reference
+  string product_ref = 1;
+  // Product configuration
+  google.protobuf.Struct config = 2;
+  // Product credentials
+  google.protobuf.Struct credentials = 3;
+}
+
+// Application definition
+message Application {
+  // Reference to the application
+  string ref = 1;
+  // The application's resource name
+  string name = 2;
+  // Application type
+  ApplicationType type = 3;
+  // Endpoint for programmable voice
+  string app_endpoint = 4;
+  // Text to speech product
+  ProductContainer text_to_speech = 5;
+  // Speech to text product
+  ProductContainer speech_to_text = 6;
+  // Conversation product
+  ProductContainer conversation = 7;
+  // Creation time
+  int64 created_at = 8;
+  // Update time
+  int64 updated_at = 9;
+}
+
+// Request to create a new application
+message CreateApplicationRequest {
+  // Name of the application
+  string name = 1;
+  // Application type
+  ApplicationType type = 2;
+  // App URL for programmable voice
+  string app_endpoint = 3;
+  // Text to speech product
+  ProductContainer text_to_speech = 4;
+  // Speech to text product
+  ProductContainer speech_to_text = 5;
+  // Conversation product
+  ProductContainer intelligence = 6;
+}
+
+// Response for create application
+message CreateApplicationResponse {
+  // Echo the reference of the application
+  string ref = 1;
+}
+
+// Request to get an application
+message GetApplicationRequest {
+  // The reference to the application
+  string ref = 1;
+}
+
+// Request to list applications
+message ListApplicationsRequest {
+  // The number of items to list
+  int32 page_size = 1;
+  // The page token
+  string page_token = 2;
+}
+
+// Response for list applications
+message ListApplicationsResponse {
+  // List of applications
+  repeated Application items = 1;
+  // The page token
+  string next_page_token = 2;
+}
+
+// Request to update an application
+message UpdateApplicationRequest {
+  // Reference to the application
+  string ref = 1;
+  // Name of the application
+  string name = 2;
+  // Application type
+  ApplicationType type = 3;
+  // App URL for programmable voice
+  string app_endpoint = 4;
+  // Text to speech product
+  ProductContainer text_to_speech = 5;
+  // Speech to text product
+  ProductContainer speech_to_text = 6;
+  // Conversation product
+  ProductContainer intelligence = 7;
+}
+
+// Response for update application
+message UpdateApplicationResponse {
+  // Echo the reference of the application
+  string ref = 1;
+}
+
+// Request to delete an application
+message DeleteApplicationRequest {
+  // The reference to the application
+  string ref = 1;
+}
+
+// Response for delete application
+message DeleteApplicationResponse {
+  // Echo the reference of the application
+  string ref = 1;
+}

package/dist/protos/calls.proto

@@ -0,0 +1,162 @@
+/*
+ * Copyright (C) 2024 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * 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.calls.v1beta2;
+
+// TODO: Consider using Timestamp instead of int64
+// import "google/protobuf/timestamp.proto";
+
+// Calls service definition
+service Calls {
+  // Call a number and returns the call status
+  rpc CreateCall (CreateCallRequest) returns (CreateCallResponse) {}
+  // Get a list of Call Detail Records
+  rpc ListCalls (ListCallsRequest) returns (ListCallsResponse) {}
+  // Get a Call Detail Record
+  rpc GetCall (GetCallRequest) returns (CallDetailRecord) {}
+  // Stream call status
+  rpc TrackCall (TrackCallRequest) returns (stream TrackCallResponse) {}
+}
+
+enum CallType {
+  PROGRAMMABLE = 0;
+  SIP_TRUNKING = 1;
+}
+
+enum HangupCause {
+  NORMAL_CLEARING = 0;
+  CALL_REJECTED = 1;
+  UNALLOCATED = 2;
+  NO_USER_RESPONSE = 3;
+  NO_ROUTE_DESTINATION = 4;
+  NO_ANSWER = 5;
+  USER_BUSY = 6;
+  NOT_ACCEPTABLE_HERE = 7;
+  SERVICE_UNAVAILABLE = 8;
+  INVALID_NUMBER_FORMAT = 9;
+  UNKNOWN = 10;
+}
+
+enum CallStatus {
+  QUEUED = 0;
+  RINGING = 1;
+  IN_PROGRESS = 2;
+  COMPLETED = 3;
+  FAILED = 4;
+  BUSY = 5;
+  NO_ANSWER = 6;
+  CANCELED = 7;
+  REJECTED = 8;
+  TIMEOUT = 9;
+  UNKNOWN = 10;
+}
+
+enum CallDirection {
+  INBOUND = 0;
+  OUTBOUND = 1;
+}
+
+// Message for a Call Detail Record
+message CallDetailRecord {
+  // The unique identifier of the Call
+  string ref = 1;
+  // The call type
+  CallType type = 2;
+  // The call status
+  CallStatus status = 3;
+  // Hangup cause
+  HangupCause hangup_cause = 4;
+  // Start time of the call
+  int64 started_at = 5;
+  // End time of the call
+  int64 ended_at = 6;
+  // The from number (E.164 format or SIP URI)
+  string from = 7;
+  // The to number (E.164 format or SIP URI)
+  string to = 8;
+  // The call duration in seconds
+  int32 duration = 9;
+  // The call direction
+  CallDirection direction = 10;
+}
+
+// The request message for Calls.Call
+message CreateCallRequest {
+  // The from number (E.164 format or SIP URI)
+  string from = 1;
+  // The to number (E.164 format or SIP URI)
+  string to = 2;
+  // Optional application reference
+  string app_ref = 3;
+}
+
+// The response message for Calls.Call
+message CreateCallResponse {
+  // The refence of the call
+  string ref = 1;
+}
+
+// The request message for Calls.ListCalls
+message ListCallsRequest {
+  // Optional start date in RFC3339 format
+  string after = 1;
+  // Optional end date in RFC3339 format
+  string before = 2;
+  // Optional call type
+  CallType type = 3;
+  // Optional call status
+  CallStatus status = 4;
+  // Optional from number (E.164 format or SIP URI)
+  string from = 5;
+  // Optional to number (E.164 format or SIP URI)
+  string to = 6;
+  // The page size
+  int32 page_size = 7;
+  // The page token
+  string page_token = 8;
+}
+
+// The response message for Calls.ListCalls
+message ListCallsResponse {
+  // The list of Call Detail Records
+  repeated CallDetailRecord items = 1;
+  // The token to retrieve the next page of results
+  string next_page_token = 2;
+}
+
+// The request message for Calls.GetCall
+message GetCallRequest {
+  // The unique identifier of the Call
+  string ref = 1;
+}
+
+// The request message for Calls.TrackCall
+message TrackCallRequest {
+  // The unique identifier of the Call
+  string ref = 1;
+}
+
+// The response message for Calls.TrackCall
+message TrackCallResponse {
+  // The refence of the call
+  string ref = 1;
+  // The call status
+  CallStatus status = 2;
+}

package/dist/protos/credentials.proto

@@ -0,0 +1,119 @@
+/*
+ * Copyright (C) 2024 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * 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.credentials.v1beta2;
+
+// The Credentials service definition
+service CredentialsService {
+  // Creates a new set of Credentials
+  rpc CreateCredentials (CreateCredentialsRequest) returns (CreateCredentialsResponse) {}
+  // Updates an existing set of Credentials
+  rpc UpdateCredentials (UpdateCredentialsRequest) returns (UpdateCredentialsResponse) {}
+  // Gets the details of a given set of Credentials
+  rpc GetCredentials (GetCredentialsRequest) returns (Credentials) {}
+  // Deletes an existing set of Credentials
+  rpc DeleteCredentials (DeleteCredentialsRequest) returns (DeleteCredentialsResponse) {}
+  // Lists all Credentials
+  rpc ListCredentials (ListCredentialsRequest) returns (ListCredentialsResponse) {}
+}
+
+// The message for the Credentials resource
+message Credentials {
+  // The reference of the Credentials
+  string ref = 1;
+  // The name of the Credentials
+  string name = 2;
+  // The username of the Credentials
+  string username = 3;
+  // The password of the Credentials
+  string password = 4;
+  // The time the Credentials was created
+  int64 created_at = 5;
+  // The time the Credentials was updated
+  int64 updated_at = 6;
+}
+
+// The request message for the Credentials.CreateCredentials method
+message CreateCredentialsRequest {
+  // The name of the Credentials
+  string name = 1;
+  // The username of the Credentials
+  string username = 2;
+  // The password of the Credentials
+  string password = 3;
+}
+
+// The response message for the Credentials.CreateCredentials method
+message CreateCredentialsResponse {
+  // The reference of the created Credentials
+  string ref = 1;
+}
+
+// The request message for the Credentials.UpdateCredentials method
+message UpdateCredentialsRequest {
+  // The reference of the Credentials to update
+  string ref = 1;
+  // The new name of the Credentials
+  string name = 2;
+  // The new username of the Credentials
+  string username = 3;
+  // The new password of the Credentials
+  string password = 4;
+}
+
+// The response message for the Credentials.UpdateCredentials method
+message UpdateCredentialsResponse {
+  // The reference of the updated Credentials
+  string ref = 1;
+}
+
+// The request message for the Credentials.GetCredentials method
+message GetCredentialsRequest  {
+  // The reference of the Credentials to retrieve
+  string ref = 1;
+}
+
+// The request message for the Credentials.DeleteCredentials method
+message DeleteCredentialsRequest  {
+  // The reference of the Credentials to delete
+  string ref = 1;
+}
+
+// The response message for the Credentials.DeleteCredentials method
+message DeleteCredentialsResponse {
+  // The reference of the deleted Credentials
+  string ref = 1;
+}
+
+// The request message for the Credentials.ListCredentials method
+message ListCredentialsRequest {
+  // 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 Credentials.ListCredentials method
+message ListCredentialsResponse {
+  // List of Credentials
+  repeated Credentials 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;
+}

package/dist/protos/domains.proto

@@ -0,0 +1,127 @@
+/*
+ * Copyright (C) 2024 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * 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.domains.v1beta2;
+
+// The Domains service definition
+service Domains {
+  // Create a new Domain
+  rpc CreateDomain (CreateDomainRequest) returns (CreateDomainResponse) {}
+  // Update an existing Domain
+  rpc UpdateDomain (UpdateDomainRequest) returns (UpdateDomainResponse) {}
+  // Get an existing Domain
+  rpc GetDomain (GetDomainRequest) returns (Domain) {}
+  // List all Domains
+  rpc ListDomains (ListDomainsRequest) returns (ListDomainsResponse) {}
+  // Delete an existing Domain
+  rpc DeleteDomain (DeleteDomainRequest) returns (DeleteDomainResponse) {}
+}
+
+// The message for the Domain resource
+message Domain {
+  // The unique identifier of the Domain
+  string ref = 2;
+  // The name of the Domain
+  string name = 3;
+  // The URI of the Domain
+  string domain_uri = 4;
+  // The date of creation of the Domain
+  int64 created_at = 5;
+  // The date of the last update
+  int64 updated_at = 6;
+}
+
+// EgressPolicy defines the policy for egress traffic
+message EgressPolicy {
+  // The pattern to match
+  string rule = 1;
+  // Reference to the number to use for egress
+  string number_ref = 2;
+}
+
+// The request message for Domains.CreateDomain
+message CreateDomainRequest {
+  // The name of the Domain
+  string name = 1;
+  // The domain_uri of the Domain
+  string domain_uri = 2;
+  // Reference to the Access Control List
+  string access_control_list_ref = 3;
+  // Optional list of egress policies
+  repeated EgressPolicy egress_policies = 4;
+}
+
+// The response message for Domains.CreateDomain
+message CreateDomainResponse {
+  // The id of the new Domain
+  string ref = 1;
+}
+
+// The request message for Domains.UpdateDomain
+message UpdateDomainRequest {
+  // The id of the Domain
+  string ref = 1;
+  // The name of the Domain
+  string name = 2;
+  // Reference to the Access Control List
+  string access_control_list_ref = 3;
+  // Optional list of egress policies
+  repeated EgressPolicy egress_policies = 4;
+}
+
+// The response message for Domains.UpdateDomain
+message UpdateDomainResponse {
+  // The id of the updated Domain
+  string ref = 1;
+}
+
+// The request message for Domains.GetDomain
+message GetDomainRequest {
+  // // The unique identifier of the Domain
+  string ref = 1;
+}
+
+// The request message for Domains.DeleteDomain
+message DeleteDomainRequest {
+  // The unique identifier of the Domain
+  string ref = 1;
+}
+
+// The response message for Domains.DeleteDomain
+message DeleteDomainResponse {
+  // Echo back the id of the deleted Domain
+  string ref = 1;
+}
+
+// The request message for Domains.ListDomains
+message ListDomainsRequest {
+  // 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 Domains.ListDomains
+message ListDomainsResponse {
+  // List of Domains
+  repeated Domain 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;
+}