neon-sprawl/client/scripts/position_authority_client.gd

extends Node

## NS-16: POST MoveCommand then GET PositionState; emits authoritative world position for the
## avatar. NS-19: failed validation (HTTP 400 + rejection body) emits `move_rejected`.
## NS-23: second signal arg — `true` = boot snap, `false` = post-move (nav goal, no teleport).
## (No `class_name` so headless/CI can load the project before `.godot` import exists.)

signal authoritative_position_received(world: Vector3, apply_as_snap: bool)
signal move_rejected(reason_code: String)

enum Phase { BOOT_GET, POST_MOVE, VERIFY_GET }

@export var base_url: String = "http://127.0.0.1:5253"
@export var dev_player_id: String = "dev-local-1"

## `HTTPRequest` at runtime; tests may inject a `Node` with `request()` + `request_completed`.
var _http: Node
var _busy: bool = false
var _phase: Phase = Phase.BOOT_GET

## Latest click target while [_busy] (POST or VERIFY in flight); coalesced so clicks are not lost.
var _pending_move_target: Variant = null


func _create_http_request() -> Node:
	return HTTPRequest.new()


func _ready() -> void:
	_http = _create_http_request()
	add_child(_http)
	if _http is HTTPRequest:
		(_http as HTTPRequest).timeout = 30.0
	@warning_ignore("unsafe_method_access")
	_http.request_completed.connect(_on_request_completed)


func sync_from_server() -> void:
	if _busy:
		return
	_busy = true
	_phase = Phase.BOOT_GET
	_request_get()


func submit_move_target(world: Vector3) -> void:
	if _busy:
		_pending_move_target = world
		return
	_pending_move_target = null
	_start_move_post(world)


func _try_flush_pending_move() -> void:
	if _busy:
		return
	if _pending_move_target is Vector3:
		var w: Vector3 = _pending_move_target as Vector3
		_pending_move_target = null
		_start_move_post(w)


func _start_move_post(world: Vector3) -> void:
	_busy = true
	_phase = Phase.POST_MOVE
	var url := "%s/game/players/%s/move" % [_base_root(), _player_path_segment()]
	var payload := {
		"schemaVersion": 1,
		"target": {"x": world.x, "y": world.y, "z": world.z},
	}
	var body := JSON.stringify(payload)
	var headers := PackedStringArray(["Content-Type: application/json"])
	var err: Error = _http.request(url, headers, HTTPClient.METHOD_POST, body)
	if err != OK:
		push_warning("PositionAuthorityClient: POST failed to start (%s)" % err)
		_busy = false
		_try_flush_pending_move()


func _base_root() -> String:
	return base_url.strip_edges().rstrip("/")


func _player_path_segment() -> String:
	# ASCII-safe ids (e.g. dev-local-1); use percent-encoding if ids gain reserved URL characters.
	return dev_player_id.strip_edges()


func _request_get() -> void:
	var url := "%s/game/players/%s/position" % [_base_root(), _player_path_segment()]
	var err: Error = _http.request(url)
	if err != OK:
		push_warning("PositionAuthorityClient: GET failed to start (%s)" % err)
		_busy = false
		_try_flush_pending_move()


func _on_request_completed(
	_result: int, response_code: int, _headers: PackedStringArray, body: PackedByteArray
) -> void:
	if _result != HTTPRequest.RESULT_SUCCESS:
		push_warning(
			"PositionAuthorityClient: HTTP failed (result=%s); releasing busy." % _result
		)
		_busy = false
		_try_flush_pending_move()
		return

	var text := body.get_string_from_utf8()

	match _phase:
		Phase.BOOT_GET:
			_busy = false
			if response_code == 200:
				_emit_position_from_response(text, true)
			_try_flush_pending_move()
		Phase.POST_MOVE:
			if response_code == 400:
				_emit_move_rejection_if_present(text)
				_busy = false
				_try_flush_pending_move()
				return
			if response_code != 200:
				push_warning(
					"PositionAuthorityClient: move POST unexpected code %s" % response_code
				)
				_busy = false
				_try_flush_pending_move()
				return
			_phase = Phase.VERIFY_GET
			_request_get()
		Phase.VERIFY_GET:
			_busy = false
			if response_code == 200:
				_emit_position_from_response(text, false)
			else:
				push_warning(
					"PositionAuthorityClient: VERIFY GET unexpected code %s" % response_code
				)
			_try_flush_pending_move()


func _emit_move_rejection_if_present(json_text: String) -> void:
	var parsed: Variant = JSON.parse_string(json_text)
	if parsed != null and parsed is Dictionary:
		var data: Dictionary = parsed
		var code_variant: Variant = data.get("reasonCode", "")
		if code_variant is String:
			var code: String = code_variant as String
			if code.is_empty():
				move_rejected.emit("unknown")
			else:
				move_rejected.emit(code)
			return
	move_rejected.emit("unknown")


func _emit_position_from_response(json_text: String, apply_as_snap: bool) -> void:
	var parsed: Variant = JSON.parse_string(json_text)
	if parsed == null:
		push_warning("PositionAuthorityClient: position response JSON parse failed")
		return
	if not parsed is Dictionary:
		push_warning("PositionAuthorityClient: position response is not a JSON object")
		return
	var data: Dictionary = parsed
	var pos_variant: Variant = data.get("position", null)
	if not pos_variant is Dictionary:
		push_warning("PositionAuthorityClient: position response missing `position` object")
		return
	var pos: Dictionary = pos_variant
	var x: float = float(pos.get("x", 0.0))
	var y: float = float(pos.get("y", 0.0))
	var z: float = float(pos.get("z", 0.0))
	authoritative_position_received.emit(Vector3(x, y, z), apply_as_snap)