Client/.api-template/core/ApiConfig.handlebars

extends {{>partials/api_config_parent_class}}
class_name {{>partials/api_config_class_name}}

{{>partials/disclaimer_autogenerated}}

# Configuration options for Api endpoints
# =======================================
#
# Helps share configuration customizations across Apis:
# - host, port & scheme
# - extra headers (low priority, high priority)
# - transport layer security options (TLS certificates)
# - log level
#
# You probably want to make an instance of this class with your own values,
# and feed it to each Api's constructor, before calling the Api's methods.
#
# Since it is a Resource, you may use `ResourceSaver.save()` and `preload()`
# to save it and load it from file, for convenience.
#


# These are constant, immutable default values.  Best not edit them.
# To set different values at runtime, use the @export'ed properties below.
const BEE_DEFAULT_HOST := "{{#if host}}{{{host}}}{{else}}localhost{{/if}}"
const BEE_DEFAULT_PORT_HTTP := 80
const BEE_DEFAULT_PORT_HTTPS := 443
const BEE_DEFAULT_POLLING_INTERVAL_MS := 333  # milliseconds


# Configuration also handles logging because it's convenient.
enum LogLevel {
	SILENT,
	ERROR,
	WARNING,
	INFO,
	DEBUG,
}


## Log level to configure verbosity.
@export var log_level := LogLevel.WARNING

{{!--
# Not sure if this should hold the HTTPClient instance or not.  Not for now.
# Godot recommends using a single client for all requests, so it perhaps should.

# Godot's HTTP Client we are using.
# If none was set (by you), we'll lazily make one.
var bee_client: HTTPClient:
	set(value):
		bee_client = value
	get:
		if not bee_client:
			bee_client = HTTPClient.new()
		return bee_client
--}}

## The host to connect to, with or without the protocol scheme.
## We toggle TLS accordingly to the provided scheme, if any.
@export var host := BEE_DEFAULT_HOST:
	set(value):
		if value.begins_with("https://"):
			tls_enabled = true
			value = value.substr(8)  # "https://".length() == 8
		elif value.begins_with("http://"):
			tls_enabled = false
			value = value.substr(7)  # "http://".length() == 7
		host = value


## Port through which the connection will be established.
## NOTE: changing the host may change the port as well if the scheme was provided, see above.
@export var port := BEE_DEFAULT_PORT_HTTP


## Headers used as base for all requests made by Api instances using this config.
## Those are the lowest priority headers, and are merged with custom headers provided in the bee_request() method call
## as well as the headers override below, to compute the final, actually sent headers.
@export var headers_base := {
	# Stigmergy: everyone does what is left to do (like ants do)
	"User-Agent": "Stigmergiac/1.0 (Godot)",
	# For my mental health's sake, only JSON is supported for now
	"Accept": "application/json",
	"Content-Type": "application/json",
}


## High-priority headers, they will always override other headers coming from the base above or the method call.
@export var headers_override := {}


## Duration of sleep between poll() calls.
@export var polling_interval_ms := BEE_DEFAULT_POLLING_INTERVAL_MS  # milliseconds


## Enable the Transport Security Layer (packet encryption, HTTPS)
@export var tls_enabled := false:
	set(value):
		tls_enabled = value
		# port = BEE_DEFAULT_PORT_HTTPS if tls_enabled else BEE_DEFAULT_PORT_HTTP


## You should preload your *.crt file (the whole chain) in here if you want TLS.
## I usually concatenate my /etc/ssl/certs/ca-certificates.crt and webserver certs here.
## Remember to add the *.crt file to the exports, if necessary.
@export var trusted_chain: X509Certificate  # only used if tls is enabled
@export var common_name_override := ""  # for TLSOptions


## Dynamic accessor using the TLS properties above, but you may inject your own
## for example if you need to use TLSOptions.client_unsafe.  Best not @export this.
var tls_options: TLSOptions:
	set(value):
		tls_options = value
	get:
		if not tls_enabled:
			return null
		if not tls_options:
			tls_options = TLSOptions.client(trusted_chain, common_name_override)
		return tls_options


func log_error(message: String):
	if self.log_level >= LogLevel.ERROR:
		push_error(message)

func log_warning(message: String):
	if self.log_level >= LogLevel.WARNING:
		push_warning(message)

func log_info(message: String):
	if self.log_level >= LogLevel.INFO:
		print(message)

func log_debug(message: String):
	if self.log_level >= LogLevel.DEBUG:
		print(message)


{{#each authMethods}}
# Authentication method `{{name}}`.
{{#if isBasicBearer }}
# Basic Bearer Authentication `{{bearerFormat}}`
func set_security_{{name}}(value: String):
	self.headers_base["Authorization"] = "Bearer %s" % value


{{else if isApiKey }}
# Api Key Authentication `{{keyParamName}}`
func set_security_{{name}}(value: String):
	{{#if isKeyInHeader }}
	self.headers_base["{{keyParamName}}"] = value
	{{else if isKeyInQuery }}
	# Implementing this should be straightforward
	log_error("Api Key in Query is not supported at the moment.  (contribs welcome)")
	{{else if isKeyInCookie }}
	log_error("Api Key in Cookie is not supported at the moment.  (contribs welcome)")
	{{else }}
	log_error("Unrecognized Api Key format (contribs welcome).")
	{{/if}}


{{else}}
# → Skipped: not implemented in the gdscript templates.  (contribs are welcome)


{{/if}}
{{/each}}