@tdxvolt/volt-client-grpc 0.20.20 → 0.20.21

package/lib/index.cjs

@@ -2237,6 +2237,15 @@ enum SecureMode {
   SECURE_MODE_TLS = 2;
 }
 
+// Per-method gRPC rate limit (unary: each RPC; client/bidi streams: first client message only).
+message GrpcRpcRateLimit {
+  // Full gRPC method path, e.g. "/tdx.volt_api.volt.v1.VoltAPI/SendEmail"
+  string method_full_name = 1;
+
+  // Maximum requests allowed per rolling 60-second window per identity. Zero disables this rule.
+  uint32 max_requests_per_minute = 2;
+}
+
 // Encapsulates the various Volt parameters that are configurable by the Volt owner.
 message VoltParameters {
   string id = 1;
@@ -2412,6 +2421,9 @@ message VoltParameters {
   // Number of gRPC event processing threads.
   // If unset or zero, the server default thread count is used.
   uint32 grpc_num_event_threads = 56;
+
+  // Optional per-method gRPC rate limits (see GrpcRpcRateLimit). Keyed by peer identity or fingerprint.
+  repeated GrpcRpcRateLimit grpc_rpc_rate_limit = 57;
 }
 
 message VoltEndpoint {
@@ -2802,6 +2814,27 @@ message Session {
 
   SessionStatus status = 10;
 }
+
+message Email {
+  // The email address to send to.
+  repeated string to = 1;
+
+  // The email address to send cc to.
+  repeated string cc = 2;
+
+  // The email address to send bcc to.
+  repeated string bcc = 3;
+
+  // The subject of the email.
+  string subject = 4;
+
+  // The body of the email.
+  string body = 5;
+
+  // The email address to send from.
+  string from = 6;
+}
+
 `;
 const volt_api = `syntax = "proto3";
 
@@ -2950,6 +2983,10 @@ service VoltAPI {
   // Requires \`volt:session-write\` permission. Authenticated sessions have this privilege by default.
   rpc SaveSession(SaveSessionRequest) returns (SaveSessionResponse);
 
+  // Send an email.
+  // This is a privileged API call and requires volt:api-call / volt:send-email permission.
+  rpc SendEmail(SendEmailRequest) returns (SendEmailResponse);
+
   // Set Volt access request decision.
   // This is a privileged API call and requires volt:api-call / volt:set-access-request-decision permission.
   rpc SetAccessRequestDecision(SetAccessRequestDecisionRequest) returns (SetAccessRequestDecisionResponse);
@@ -3970,6 +4007,29 @@ message SaveSessionResponse {
   Session session = 2;
 }
 
+message SendEmailRequest {
+  // The email to send.
+  Email email = 1;
+}
+
+message SendEmailResponse {
+  // Details of any error that occurred on the call.
+  tdx.volt_api.volt.v1.Status status = 1;
+}
+
+message SetAccessRequestDecisionRequest {
+  // The id of the access request.
+  string id = 1;
+
+  // The decision to save against the access request.
+  PolicyDecision decision = 2;
+}
+
+message SetAccessRequestDecisionResponse {
+  // Details of any error that occurred on the call.
+  tdx.volt_api.volt.v1.Status status = 1;
+}
+
 message SetPolicyRequest {
   // The id of the policy to set.
   // Should be either 00000000-0000-0000-0000-000000000000 or 00000000-0000-0000-0000-000000000001 for the first or last custom policy respectively.
@@ -3997,19 +4057,6 @@ message SetServiceStatusResponse {
   Resource resource = 2;
 }
 
-message SetAccessRequestDecisionRequest {
-  // The id of the access request.
-  string id = 1;
-
-  // The decision to save against the access request.
-  PolicyDecision decision = 2;
-}
-
-message SetAccessRequestDecisionResponse {
-  // Details of any error that occurred on the call.
-  tdx.volt_api.volt.v1.Status status = 1;
-}
-
 // This message is emtpy.
 message ShutdownRequest {
 }
@@ -6348,6 +6395,10 @@ class VoltClient extends EventEmitter__default["default"] {
     return unaryCallInternal.call(this, "SaveSession", request);
   }
 
+  SendEmail(request) {
+    return unaryCallInternal.call(this, "SendEmail", request);
+  }
+
   SetAccessRequestDecision(request) {
     return unaryCallInternal.call(this, "SetAccessRequestDecision", request);
   }

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.20.20",
+  "version": "0.20.21",
   "description": "tdx Volt library for nodejs clients",
   "type": "module",
   "exports": {
@@ -33,8 +33,8 @@
   "author": "toby.ealden@gmail.com",
   "license": "ISC",
   "dependencies": {
-    "@tdxvolt/volt-client-web": "^0.20.20",
-    "@tdxvolt/volt-utility": "^0.20.18",
+    "@tdxvolt/volt-client-web": "^0.20.21",
+    "@tdxvolt/volt-utility": "^0.20.21",
     "debug": "^4.1.1",
     "ip": "^1.1.5",
     "jsonwebtoken": "^8.5.1",

package/src/volt-client.js

@@ -471,6 +471,10 @@ export class VoltClient extends EventEmitter {
     return unaryCallInternal.call(this, "SaveSession", request);
   }
 
+  SendEmail(request) {
+    return unaryCallInternal.call(this, "SendEmail", request);
+  }
+
   SetAccessRequestDecision(request) {
     return unaryCallInternal.call(this, "SetAccessRequestDecision", request);
   }

package/src/volt-proto-literals.js

@@ -1689,6 +1689,15 @@ enum SecureMode {
   SECURE_MODE_TLS = 2;
 }
 
+// Per-method gRPC rate limit (unary: each RPC; client/bidi streams: first client message only).
+message GrpcRpcRateLimit {
+  // Full gRPC method path, e.g. "/tdx.volt_api.volt.v1.VoltAPI/SendEmail"
+  string method_full_name = 1;
+
+  // Maximum requests allowed per rolling 60-second window per identity. Zero disables this rule.
+  uint32 max_requests_per_minute = 2;
+}
+
 // Encapsulates the various Volt parameters that are configurable by the Volt owner.
 message VoltParameters {
   string id = 1;
@@ -1864,6 +1873,9 @@ message VoltParameters {
   // Number of gRPC event processing threads.
   // If unset or zero, the server default thread count is used.
   uint32 grpc_num_event_threads = 56;
+
+  // Optional per-method gRPC rate limits (see GrpcRpcRateLimit). Keyed by peer identity or fingerprint.
+  repeated GrpcRpcRateLimit grpc_rpc_rate_limit = 57;
 }
 
 message VoltEndpoint {
@@ -2254,6 +2266,27 @@ message Session {
 
   SessionStatus status = 10;
 }
+
+message Email {
+  // The email address to send to.
+  repeated string to = 1;
+
+  // The email address to send cc to.
+  repeated string cc = 2;
+
+  // The email address to send bcc to.
+  repeated string bcc = 3;
+
+  // The subject of the email.
+  string subject = 4;
+
+  // The body of the email.
+  string body = 5;
+
+  // The email address to send from.
+  string from = 6;
+}
+
 `;
 export const volt_api = `syntax = "proto3";
 
@@ -2402,6 +2435,10 @@ service VoltAPI {
   // Requires \`volt:session-write\` permission. Authenticated sessions have this privilege by default.
   rpc SaveSession(SaveSessionRequest) returns (SaveSessionResponse);
 
+  // Send an email.
+  // This is a privileged API call and requires volt:api-call / volt:send-email permission.
+  rpc SendEmail(SendEmailRequest) returns (SendEmailResponse);
+
   // Set Volt access request decision.
   // This is a privileged API call and requires volt:api-call / volt:set-access-request-decision permission.
   rpc SetAccessRequestDecision(SetAccessRequestDecisionRequest) returns (SetAccessRequestDecisionResponse);
@@ -3422,6 +3459,29 @@ message SaveSessionResponse {
   Session session = 2;
 }
 
+message SendEmailRequest {
+  // The email to send.
+  Email email = 1;
+}
+
+message SendEmailResponse {
+  // Details of any error that occurred on the call.
+  tdx.volt_api.volt.v1.Status status = 1;
+}
+
+message SetAccessRequestDecisionRequest {
+  // The id of the access request.
+  string id = 1;
+
+  // The decision to save against the access request.
+  PolicyDecision decision = 2;
+}
+
+message SetAccessRequestDecisionResponse {
+  // Details of any error that occurred on the call.
+  tdx.volt_api.volt.v1.Status status = 1;
+}
+
 message SetPolicyRequest {
   // The id of the policy to set.
   // Should be either 00000000-0000-0000-0000-000000000000 or 00000000-0000-0000-0000-000000000001 for the first or last custom policy respectively.
@@ -3449,19 +3509,6 @@ message SetServiceStatusResponse {
   Resource resource = 2;
 }
 
-message SetAccessRequestDecisionRequest {
-  // The id of the access request.
-  string id = 1;
-
-  // The decision to save against the access request.
-  PolicyDecision decision = 2;
-}
-
-message SetAccessRequestDecisionResponse {
-  // Details of any error that occurred on the call.
-  tdx.volt_api.volt.v1.Status status = 1;
-}
-
 // This message is emtpy.
 message ShutdownRequest {
 }