connection_endpoint.h File Reference

Shared endpoint normalization for TCP and WebSocket connections. More...

Go to the source code of this file.

Data Structures
struct	connection_endpoint_t

Enumerations
enum	connection_endpoint_protocol_t { CONNECTION_ENDPOINT_TCP = 0 , CONNECTION_ENDPOINT_WEBSOCKET = 1 }

Functions
asciichat_error_t	connection_endpoint_resolve (const char *input, uint16_t default_port, connection_endpoint_t *endpoint_out)
const char *	connection_endpoint_protocol_name (connection_endpoint_protocol_t protocol)

Detailed Description

Shared endpoint normalization for TCP and WebSocket connections.

This helper removes repeated URL/scheme parsing across client and discovery connection setup code. Callers get one normalized endpoint description and can then choose the appropriate transport path.

Definition in file connection_endpoint.h.

Enumeration Type Documentation

connection_endpoint_protocol_t

enum connection_endpoint_protocol_t

Enumerator
CONNECTION_ENDPOINT_TCP
CONNECTION_ENDPOINT_WEBSOCKET

Definition at line 16 of file connection_endpoint.h.

             {
  CONNECTION_ENDPOINT_TCP = 0,
  CONNECTION_ENDPOINT_WEBSOCKET = 1,
} connection_endpoint_protocol_t;

Function Documentation

connection_endpoint_protocol_name()

const char * connection_endpoint_protocol_name

(

connection_endpoint_protocol_t

protocol

)

Definition at line 12 of file connection_endpoint.c.

                                                                                       {
  switch (protocol) {
  case CONNECTION_ENDPOINT_TCP:
    return "TCP";
  case CONNECTION_ENDPOINT_WEBSOCKET:
    return "WebSocket";
  default:
    return "Unknown";
  }
}

References CONNECTION_ENDPOINT_TCP, and CONNECTION_ENDPOINT_WEBSOCKET.

Referenced by connection_attempt_tcp().

connection_endpoint_resolve()

asciichat_error_t connection_endpoint_resolve	(	const char *	input,
		uint16_t	default_port,
		connection_endpoint_t *	endpoint_out
	)

Resolve an input string into a normalized TCP or WebSocket endpoint.

Supported inputs:

• ws://host[:port]
• wss://host[:port]
• tcp://host[:port]
• bare hostnames or host:port pairs

Bare hostnames are treated as TCP endpoints and use default_port when the input does not specify a port.

Definition at line 39 of file connection_endpoint.c.

                                                                                   {
  if (!input || !*input || !endpoint_out) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "input or endpoint_out is NULL");
  }
 
  url_parts_t parts = {0};
  asciichat_error_t result;
 
  if (url_is_websocket(input)) {
    result = url_parse(input, &parts);
    if (result != ASCIICHAT_OK) {
      return result;
    }
    result = connection_endpoint_from_parts(endpoint_out, &parts, CONNECTION_ENDPOINT_WEBSOCKET, default_port, input);
    url_parts_destroy(&parts);
    return result;
  }
 
  if (url_is_tcp(input)) {
    result = url_parse(input, &parts);
    if (result != ASCIICHAT_OK) {
      return result;
    }
    result = connection_endpoint_from_parts(endpoint_out, &parts, CONNECTION_ENDPOINT_TCP, default_port, input);
    url_parts_destroy(&parts);
    return result;
  }
 
  /* Unsupported explicit scheme. Bare hostnames are allowed and have no "://". */
  if (strstr(input, "://") != NULL) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "Unsupported connection scheme: %s", input);
  }
 
  result = url_parse(input, &parts);
  if (result != ASCIICHAT_OK) {
    return result;
  }
 
  result = connection_endpoint_from_parts(endpoint_out, &parts, CONNECTION_ENDPOINT_TCP, default_port, input);
  url_parts_destroy(&parts);
  return result;
}

References ASCIICHAT_OK, CONNECTION_ENDPOINT_TCP, CONNECTION_ENDPOINT_WEBSOCKET, ERROR_INVALID_PARAM, SET_ERRNO, url_is_tcp(), url_is_websocket(), url_parse(), and url_parts_destroy().

Referenced by connection_attempt_tcp(), connection_factory_open(), and server_connection_establish().