deployer

type DeployDecorator interface {
	UpdateAnnotations(fn.Function, map[string]string) map[string]string
	UpdateLabels(fn.Function, map[string]string) map[string]string
}

type Exposer interface {
	// Expose creates or updates the exposing object and returns the hostname
	// a router admitted it at, waiting for that admission.
	Expose(ctx context.Context, client dynamic.Interface, e Exposure) (host string, err error)

	// Unexpose removes the object belonging to ref's function. It takes a
	// ref, not a name, so it removes the object func labelled and leaves
	// anything else alone. Finding nothing to remove is success.
	Unexpose(ctx context.Context, client dynamic.Interface, ref ExposureRef) error
}

type Exposure struct {
	// Name of the function being exposed: the identity for lookup, like
	// FunctionNamespace.
	FunctionName string

	// Where the function is deployed, which is not always where its exposing
	// object goes. See ExposureRef.
	FunctionNamespace string

	// Name of the exposing object, not always the function's. Where one
	// namespace collects every function's objects it must carry the function's
	// namespace too, or same-named functions collide. Creation uses it; lookup
	// goes by label.
	Name string

	// Namespace holds the exposing object. See ExposureRef.
	Namespace string

	// TargetService is the Service to send traffic to, TargetPort the port name
	// on it. The raw deployer targets the function's own Service on "http";
	// keda targets the interceptor on "proxy".
	TargetService string
	TargetPort    string

	// Owner is deleted together with the exposing object. Nil where the two
	// cannot be linked, since Kubernetes rejects an owner reference across
	// namespaces, which obliges the caller to Unexpose by hand.
	Owner *metav1.OwnerReference

	Labels      map[string]string
	Annotations map[string]string
}

type ExposureRef struct {
	// Both are needed: where one namespace collects every function's objects,
	// the name alone cannot separate two functions of the same name.
	FunctionName      string
	FunctionNamespace string

	// Namespace holds the exposing object, not always the function's own:
	// keda targets the interceptor Service in the operator's namespace, and an
	// exposing object can only target a Service beside it.
	Namespace string
}