syntax = "proto3";

package worldmonitor.giving.v1;

import "sebuf/http/annotations.proto";
import "worldmonitor/giving/v1/get_giving_summary.proto";

// GivingService provides APIs for global personal giving and philanthropy tracking.
service GivingService {
  option (sebuf.http.service_config) = {base_path: "/api/giving/v1"};

  // GetGivingSummary retrieves a composite global giving activity index and platform breakdowns.
  // Empty/absent summary with fetched_at=0 or data_available=false means the
  // snapshot is unavailable/degraded, not that giving activity is zero.
  rpc GetGivingSummary(GetGivingSummaryRequest) returns (GetGivingSummaryResponse) {
    option (sebuf.http.config) = {path: "/get-giving-summary", method: HTTP_METHOD_GET};
  }
}
