Added shard not found error (cadence-workflow#7186)

What changed?
Added a shard not found error to the proto def, and mappers.
We now return this specific error when we get a lookup for a shard we do not know.

Why?
This error is an expected user error so we should treat it as such.

How did you test it?
Unit tests and local runs

Potential risks

Release notes

Documentation Changes

Author: jakobht

.gen/proto/sharddistributor/v1/service.pb.go

@@ -2882,6 +2882,7 @@ const (
 	ShardDistributorLatency
 	ShardDistributorErrContextTimeoutCounter
 	ShardDistributorErrNamespaceNotFound
+	ShardDistributorErrShardNotFound
 
 	ShardDistributorAssignLoopNumRebalancedShards
 	ShardDistributorAssignLoopShardRebalanceLatency
@@ -3644,6 +3645,7 @@ var MetricDefs = map[ServiceIdx]map[int]metricDefinition{
 		ShardDistributorFailures:                        {metricName: "shard_distributor_failures", metricType: Counter},
 		ShardDistributorLatency:                         {metricName: "shard_distributor_latency", metricType: Timer},
 		ShardDistributorErrNamespaceNotFound:            {metricName: "shard_distributor_err_namespace_not_found", metricType: Counter},
+		ShardDistributorErrShardNotFound:                {metricName: "shard_distributor_err_shard_not_found", metricType: Counter},
 		ShardDistributorAssignLoopShardRebalanceLatency: {metricName: "shard_distrubutor_shard_assign_latency", metricType: Histogram},
 		ShardDistributorAssignLoopNumRebalancedShards:   {metricName: "shard_distributor_shard_assign_reassigned_shards", metricType: Gauge},
 		ShardDistributorAssignLoopAttempts:              {metricName: "shard_distrubutor_shard_assign_attempt", metricType: Counter},

.gen/proto/sharddistributor/v1/service.pb.yarpc.go

@@ -87,6 +87,8 @@ func FromError(err error) error {
 		return typedErr
 	} else if ok, typedErr = errorutils.ConvertError(err, fromNamespaceNotFoundErr); ok {
 		return typedErr
+	} else if ok, typedErr = errorutils.ConvertError(err, fromShardNotFoundErr); ok {
+		return typedErr
 	}
 
 	return protobuf.NewError(yarpcerrors.CodeUnknown, err.Error())
@@ -124,6 +126,11 @@ func ToError(err error) error {
 			return &types.NamespaceNotFoundError{
 				Namespace: details.Namespace,
 			}
+		case *sharddistributorv1.ShardNotFoundError:
+			return &types.ShardNotFoundError{
+				Namespace: details.Namespace,
+				ShardKey:  details.ShardKey,
+			}
 		}
 	case yarpcerrors.CodeInvalidArgument:
 		switch getErrorDetails(err).(type) {
@@ -376,3 +383,10 @@ func fromNamespaceNotFoundErr(e *types.NamespaceNotFoundError) error {
 		Namespace: e.Namespace,
 	}))
 }
+
+func fromShardNotFoundErr(e *types.ShardNotFoundError) error {
+	return protobuf.NewError(yarpcerrors.CodeNotFound, e.Error(), protobuf.WithErrorDetails(&sharddistributorv1.ShardNotFoundError{
+		Namespace: e.Namespace,
+		ShardKey:  e.ShardKey,
+	}))
+}