// traceWithRegionErr wraps [trace.WithRegion] to ease handling of failure cases.
func traceWithRegionErr(ctx context.Context, regionType string, fn func() error) error {
	defer trace.StartRegion(ctx, regionType).End()
	err := fn()
	if err != nil {
		return fmt.Errorf("%s: %w", regionType, err)
	}
	return nil
}

// traceWithRegion1Err1 wraps [trace.WithRegion] to ease defining a region for a function
// with one input parameter and returning a value and an error.
func traceWithRegion1Err1[I1 any, O1 any](ctx context.Context, regionType string, fn func(I1) (O1, error)) func(I1) (O1, error) {
	return func(i1 I1) (O1, error) {
		defer trace.StartRegion(ctx, regionType).End()
		o1, err := fn(i1)
		if err != nil {
			return o1, fmt.Errorf("%s: %w", regionType, err)
		}
		return o1, nil
	}
}

// traceWithRegionCtx1Err1 wraps [trace.WithRegion] to ease defining a region for a function
// with a context, another input parameter and returning a value and an error.
func traceWithRegionCtx1Err1[I1 any, O1 any](ctx context.Context, regionType string, fn func(context.Context, I1) (O1, error)) func(I1) (O1, error) {
	return func(i1 I1) (O1, error) {
		defer trace.StartRegion(ctx, regionType).End()
		o1, err := fn(ctx, i1)
		if err != nil {
			return o1, fmt.Errorf("%s: %w", regionType, err)
		}
		return o1, nil
	}
}

// traceWithRegionCtx31 wraps [trace.WithRegion] to ease defining a region for a function
// with a context, 3 other input parameters and returning one value.
func traceWithRegionCtx31[I1 any, I2 any, I3 any, O1 any](ctx context.Context, regionType string, fn func(context.Context, I1, I2, I3) O1) func(I1, I2, I3) O1 {
	return func(i1 I1, i2 I2, i3 I3) O1 {
		defer trace.StartRegion(ctx, regionType).End()
		return fn(ctx, i1, i2, i3)
	}
}