/home/mrjunejune/zenbu: seobeo/seobeo.h annotate

annotate seobeo/seobeo.h @ 184:8c74204fd362

[MD to HTML] Updated so it can be used through readme to html

author	MrJuneJune <me@mrjunejune.com>
date	Fri, 23 Jan 2026 22:20:35 -0800
parents	a8976a008a9d
children	8cf4ec5e2191

rev	line source
1 adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	1 #ifndef SEOBEO_SERVER_H
adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	2 #define SEOBEO_SERVER_H
adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	3
19 875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	4 /**
875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	5 * Seobeo
875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	6 * ------
875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	7 *
875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	8 * Library for starting TCP, UDP server and serving static file or path.
875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	9 */
1 adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	10
96 70401cf61e97 [Seobeo] Added logging. June Park <parkjune1995@gmail.com> parents: 79 diff changeset	11 #include "seobeo/seobeo_internal.h"
64 a30944e5719e Added vibe coded markdown to html script since it is useful for me. Updated Dowa so that it can be compiled without dirnet for windows. June Park <parkjune1995@gmail.com> parents: 36 diff changeset	12
96 70401cf61e97 [Seobeo] Added logging. June Park <parkjune1995@gmail.com> parents: 79 diff changeset	13 #include <stdarg.h>
1 adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	14 #include <unistd.h>
adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	15 #include <errno.h>
adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	16 #include <string.h>
adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	17 #include <sys/types.h>
adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	18 #include <sys/socket.h>
adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	19 #include <netinet/in.h>
adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	20 #include <netdb.h>
adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	21 #include <arpa/inet.h>
adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	22 #include <sys/wait.h>
adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	23 #include <signal.h>
adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	24 #include <fcntl.h>
7 114cad94008f [Seobeo] Updated to support thread and edge server calls. June Park <parkjune1995@gmail.com> parents: 6 diff changeset	25 #include <pthread.h>
1 adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	26
adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	27
4 0b3b4f5887bb [Seobeo] Updated so that it create socket for both server and clients. June Park <parkjune1995@gmail.com> parents: 3 diff changeset	28 #define INITIAL_BUFFER_CAPACITY 4096
0b3b4f5887bb [Seobeo] Updated so that it create socket for both server and clients. June Park <parkjune1995@gmail.com> parents: 3 diff changeset	29
6 1e61008b9980 [Seobeo] Updated seobeo so that API is more opinionated. Added my webpage./build.sh June Park <parkjune1995@gmail.com> parents: 5 diff changeset	30 // HTTP STATUS CODE
1e61008b9980 [Seobeo] Updated seobeo so that API is more opinionated. Added my webpage./build.sh June Park <parkjune1995@gmail.com> parents: 5 diff changeset	31 #define HTTP_OK 200
1e61008b9980 [Seobeo] Updated seobeo so that API is more opinionated. Added my webpage./build.sh June Park <parkjune1995@gmail.com> parents: 5 diff changeset	32 #define HTTP_CREATED 201
1e61008b9980 [Seobeo] Updated seobeo so that API is more opinionated. Added my webpage./build.sh June Park <parkjune1995@gmail.com> parents: 5 diff changeset	33 #define HTTP_MOVED_PERMANENTLY 301
1e61008b9980 [Seobeo] Updated seobeo so that API is more opinionated. Added my webpage./build.sh June Park <parkjune1995@gmail.com> parents: 5 diff changeset	34 #define HTTP_FOUND 302
1e61008b9980 [Seobeo] Updated seobeo so that API is more opinionated. Added my webpage./build.sh June Park <parkjune1995@gmail.com> parents: 5 diff changeset	35 #define HTTP_BAD_REQUEST 400
1e61008b9980 [Seobeo] Updated seobeo so that API is more opinionated. Added my webpage./build.sh June Park <parkjune1995@gmail.com> parents: 5 diff changeset	36 #define HTTP_UNAUTHORIZED 401
1e61008b9980 [Seobeo] Updated seobeo so that API is more opinionated. Added my webpage./build.sh June Park <parkjune1995@gmail.com> parents: 5 diff changeset	37 #define HTTP_FORBIDDEN 403
1e61008b9980 [Seobeo] Updated seobeo so that API is more opinionated. Added my webpage./build.sh June Park <parkjune1995@gmail.com> parents: 5 diff changeset	38 #define HTTP_NOT_FOUND 404
1e61008b9980 [Seobeo] Updated seobeo so that API is more opinionated. Added my webpage./build.sh June Park <parkjune1995@gmail.com> parents: 5 diff changeset	39 #define HTTP_INTERNAL_ERROR 500
1e61008b9980 [Seobeo] Updated seobeo so that API is more opinionated. Added my webpage./build.sh June Park <parkjune1995@gmail.com> parents: 5 diff changeset	40
79 5710108c949e [Seobeo] Added Redirect logic. June Park <parkjune1995@gmail.com> parents: 78 diff changeset	41 #define CREATE_REDIRECT_HANDLER(name, target_url) \
5710108c949e [Seobeo] Added Redirect logic. June Park <parkjune1995@gmail.com> parents: 78 diff changeset	42 Seobeo_Request_Entry* GetRedirect##name(Seobeo_Request_Entry req, Dowa_Arena arena) \
5710108c949e [Seobeo] Added Redirect logic. June Park <parkjune1995@gmail.com> parents: 78 diff changeset	43 { \
5710108c949e [Seobeo] Added Redirect logic. June Park <parkjune1995@gmail.com> parents: 78 diff changeset	44 Seobeo_Request_Entry *resp = NULL; \
5710108c949e [Seobeo] Added Redirect logic. June Park <parkjune1995@gmail.com> parents: 78 diff changeset	45 Dowa_HashMap_Push_Arena(resp, "status", "301", arena); \
5710108c949e [Seobeo] Added Redirect logic. June Park <parkjune1995@gmail.com> parents: 78 diff changeset	46 Dowa_HashMap_Push_Arena(resp, "content-type", "text/plain", arena); \
5710108c949e [Seobeo] Added Redirect logic. June Park <parkjune1995@gmail.com> parents: 78 diff changeset	47 Dowa_HashMap_Push_Arena(resp, "Body", "", arena); \
5710108c949e [Seobeo] Added Redirect logic. June Park <parkjune1995@gmail.com> parents: 78 diff changeset	48 Dowa_HashMap_Push_Arena(resp, "Location", target_url, arena); \
5710108c949e [Seobeo] Added Redirect logic. June Park <parkjune1995@gmail.com> parents: 78 diff changeset	49 return resp; \
5710108c949e [Seobeo] Added Redirect logic. June Park <parkjune1995@gmail.com> parents: 78 diff changeset	50 }
5710108c949e [Seobeo] Added Redirect logic. June Park <parkjune1995@gmail.com> parents: 78 diff changeset	51
36 84672efec192 [Zenbu] WIP fixing issues regarding to using edge only. I think there is a problem where socket closes before sending back the info. MrJuneJune <me@mrjunejune.com> parents: 19 diff changeset	52 extern volatile sig_atomic_t stop_server;
84672efec192 [Zenbu] WIP fixing issues regarding to using edge only. I think there is a problem where socket closes before sending back the info. MrJuneJune <me@mrjunejune.com> parents: 19 diff changeset	53
3 2758f5527d2b [Seobeo] Working on simple TCP server and client logic. June Park <parkjune1995@gmail.com> parents: 1 diff changeset	54 // --- TCP --- //
19 875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	55 // --- Generate a Server Handle. ---//
66 a0f0ad5e42eb [Misc] taking out capital P stuff. June Park <parkjune1995@gmail.com> parents: 64 diff changeset	56 extern Seobeo_Handle Seobeo_Stream_Handle_Server_Create(const char host, const char* port);
19 875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	57 // --- Generate a Client Handle. ---//
66 a0f0ad5e42eb [Misc] taking out capital P stuff. June Park <parkjune1995@gmail.com> parents: 64 diff changeset	58 extern Seobeo_Handle Seobeo_Stream_Handle_Client_Create(const char host, const char* port, boolean use_tls);
19 875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	59 // --- Generate a Client Handle from given Server Handle. ---//
66 a0f0ad5e42eb [Misc] taking out capital P stuff. June Park <parkjune1995@gmail.com> parents: 64 diff changeset	60 extern Seobeo_Handle Seobeo_Stream_Handle_Server_Accept(Seobeo_Handle p_server_handle);
6 1e61008b9980 [Seobeo] Updated seobeo so that API is more opinionated. Added my webpage./build.sh June Park <parkjune1995@gmail.com> parents: 5 diff changeset	61
1e61008b9980 [Seobeo] Updated seobeo so that API is more opinionated. Added my webpage./build.sh June Park <parkjune1995@gmail.com> parents: 5 diff changeset	62 // --- Web --- //
19 875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	63 /* Generate HTTP 1.1 Header value with given content_types and length. */
875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	64 extern void Seobeo_Web_Header_Generate(void buffer, int status, const char content_type, const int content_length);
183 a8976a008a9d [BenchMark] Added bun bench mark to test seoboe vs other popular benchmarks. MrJuneJune <me@mrjunejune.com> parents: 163 diff changeset	65 /* Generate HTTP 1.1 Header with keep-alive option. */
a8976a008a9d [BenchMark] Added bun bench mark to test seoboe vs other popular benchmarks. MrJuneJune <me@mrjunejune.com> parents: 163 diff changeset	66 extern void Seobeo_Web_Header_Generate_KeepAlive(void buffer, int status, const char content_type, const int content_length, boolean keep_alive);
19 875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	67 /* Start a Generic HTTP static file server with given folder. It will store folder into memory. */
875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	68 extern int Seobeo_Web_Server_Start(const char folder_path, const char port, Seobeo_ServerMode mode, int thread_count);
875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	69 /* Generic HTTP GET Rquest to given host and port with path. It will mimic chrome. */
875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	70 extern int Seobeo_Web_Client_Get(const char host, const char port, const char *path);
119 c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	71
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	72 // --- HTTP Client (curl-like API) --- //
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	73 /* Create a new HTTP client request with the given URL. */
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	74 extern Seobeo_Client_Request Seobeo_Client_Request_Create(const char url);
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	75 /* Set HTTP method (GET, POST, PUT, DELETE, etc.). Default is GET. */
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	76 extern void Seobeo_Client_Request_Set_Method(Seobeo_Client_Request p_req, const char method);
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	77 /* Add a header using key-value pairs (stored in HashMap). */
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	78 extern void Seobeo_Client_Request_Add_Header_Map(Seobeo_Client_Request p_req, const char key, const char *value);
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	79 /* Add a header as a string "Key: Value" (stored in Array). */
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	80 extern void Seobeo_Client_Request_Add_Header_Array(Seobeo_Client_Request p_req, const char header);
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	81 /* Set request body with given data and length. */
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	82 extern void Seobeo_Client_Request_Set_Body(Seobeo_Client_Request p_req, const char body, size_t length);
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	83 /* Enable/disable following redirects with max redirect count. Default is FALSE with 10 max. */
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	84 extern void Seobeo_Client_Request_Set_Follow_Redirects(Seobeo_Client_Request *p_req, boolean follow, int32 max_redirects);
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	85 /* Set download path to save response body to file instead of memory. */
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	86 extern void Seobeo_Client_Request_Set_Download_Path(Seobeo_Client_Request p_req, const char path);
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	87 /* Execute the HTTP request and return response. */
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	88 extern Seobeo_Client_Response Seobeo_Client_Request_Execute(Seobeo_Client_Request p_req);
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	89 /* Destroy request and free all resources. */
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	90 extern void Seobeo_Client_Request_Destroy(Seobeo_Client_Request *p_req);
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	91 /* Destroy response and free all resources. */
c39582f937e5 [Seobeo Client] Added client side logic which will be used for all my other calls instead of curl. June Park <parkjune1995@gmail.com> parents: 96 diff changeset	92 extern void Seobeo_Client_Response_Destroy(Seobeo_Client_Response *p_resp);
120 cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	93
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	94 /**
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	95 * WebSocket Client API
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	96 * ------
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	97 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	98 * # Overview
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	99 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	100 * A clean, easy-to-use WebSocket client library following RFC 6455. It will auto handle over 64 bits long data into a continous stream.
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	101 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	102 * ## Examples
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	103 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	104 * ### 1. Simple Text Echo
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	105 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	106 * ```c
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	107 * // Connect to WebSocket server
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	108 * Seobeo_WebSocket *p_ws = Seobeo_WebSocket_Connect("wss://echo.websocket.org");
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	109 * if (!p_ws)
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	110 * {
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	111 * printf("Failed to connect\n");
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	112 * return;
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	113 * }
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	114 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	115 * // Send text message
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	116 * const char *message = "Hello, WebSocket!";
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	117 * Seobeo_WebSocket_Send_Text(p_ws, message);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	118 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	119 * // Receive echo response
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	120 * Seobeo_WebSocket_Message *p_msg = Seobeo_WebSocket_Receive(p_ws);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	121 * if (p_msg && p_msg->opcode == SEOBEO_WS_OPCODE_TEXT)
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	122 * {
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	123 * printf("Received: %.s\n", (int)p_msg->length, (char)p_msg->data);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	124 * Seobeo_WebSocket_Message_Destroy(p_msg);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	125 * }
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	126 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	127 * // Close connection
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	128 * Seobeo_WebSocket_Close(p_ws, 1000, "Normal closure");
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	129 * Seobeo_WebSocket_Destroy(p_ws);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	130 * ```
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	131 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	132 * ### 2. Binary Data Transfer
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	133 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	134 * ```c
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	135 * Seobeo_WebSocket *p_ws = Seobeo_WebSocket_Connect("wss://example.com/data");
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	136 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	137 * // Send binary data
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	138 * uint8 data[] = {0x01, 0x02, 0x03, 0xAA, 0xBB, 0xCC};
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	139 * Seobeo_WebSocket_Send_Binary(p_ws, data, sizeof(data));
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	140 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	141 * // Receive binary response
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	142 * Seobeo_WebSocket_Message *p_msg = Seobeo_WebSocket_Receive(p_ws);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	143 * if (p_msg && p_msg->opcode == SEOBEO_WS_OPCODE_BINARY)
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	144 * {
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	145 * printf("Received %zu bytes\n", p_msg->length);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	146 * // Process binary data...
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	147 * Seobeo_WebSocket_Message_Destroy(p_msg);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	148 * }
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	149 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	150 * Seobeo_WebSocket_Destroy(p_ws);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	151 * ```
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	152 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	153 * ### 3. Chat Application
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	154 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	155 * ```c
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	156 * Seobeo_WebSocket *p_ws = Seobeo_WebSocket_Connect("wss://chat.example.com");
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	157 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	158 * // Send chat message
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	159 * Seobeo_WebSocket_Send_Text(p_ws, "Hello everyone!");
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	160 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	161 * // Continuous receive loop
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	162 * while (1)
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	163 * {
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	164 * Seobeo_WebSocket_Message *p_msg = Seobeo_WebSocket_Receive(p_ws);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	165 * if (p_msg)
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	166 * {
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	167 * if (p_msg->opcode == SEOBEO_WS_OPCODE_TEXT)
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	168 * {
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	169 * printf("Chat: %.s\n", (int)p_msg->length, (char)p_msg->data);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	170 * }
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	171 * Seobeo_WebSocket_Message_Destroy(p_msg);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	172 * }
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	173 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	174 * usleep(10000); // 10ms sleep to avoid busy waiting
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	175 * }
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	176 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	177 * Seobeo_WebSocket_Destroy(p_ws);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	178 * ```
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	179 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	180 * ### 4. Ping/Pong Keep-Alive
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	181 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	182 * ```c
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	183 * Seobeo_WebSocket *p_ws = Seobeo_WebSocket_Connect("wss://api.example.com");
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	184 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	185 * // Send ping to keep connection alive
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	186 * Seobeo_WebSocket_Send_Ping(p_ws, "keep-alive");
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	187 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	188 * // Server will automatically receive pong responses
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	189 * // (pong responses are handled internally)
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	190 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	191 * Seobeo_WebSocket_Destroy(p_ws);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	192 * ```
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	193 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	194 * ### 5. Handling Different Message Types
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	195 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	196 * ```c
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	197 * Seobeo_WebSocket *p_ws = Seobeo_WebSocket_Connect("wss://example.com");
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	198 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	199 * while (1)
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	200 * {
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	201 * Seobeo_WebSocket_Message *p_msg = Seobeo_WebSocket_Receive(p_ws);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	202 * if (p_msg)
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	203 * {
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	204 * switch (p_msg->opcode)
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	205 * {
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	206 * case SEOBEO_WS_OPCODE_TEXT:
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	207 * printf("Text: %.s\n", (int)p_msg->length, (char)p_msg->data);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	208 * break;
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	209 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	210 * case SEOBEO_WS_OPCODE_BINARY:
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	211 * printf("Binary: %zu bytes\n", p_msg->length);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	212 * break;
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	213 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	214 * default:
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	215 * printf("Unknown opcode: 0x%X\n", p_msg->opcode);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	216 * break;
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	217 * }
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	218 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	219 * Seobeo_WebSocket_Message_Destroy(p_msg);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	220 * }
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	221 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	222 * usleep(10000);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	223 * }
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	224 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	225 * Seobeo_WebSocket_Destroy(p_ws);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	226 * ```
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	227 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	228 * ### 6. Graceful Shutdown
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	229 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	230 * ```c
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	231 * Seobeo_WebSocket *p_ws = Seobeo_WebSocket_Connect("wss://example.com");
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	232 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	233 * // Do work...
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	234 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	235 * // Close with custom status code and reason
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	236 * Seobeo_WebSocket_Close(p_ws, 1000, "Client shutting down");
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	237 * Seobeo_WebSocket_Destroy(p_ws);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	238 * ```
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	239 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	240 * ## WebSocket Close Codes
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	241 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	242 * Common close status codes (RFC 6455):
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	243 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	244 * - 1000: Normal closure
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	245 * - 1001: Going away (e.g., server shutdown, browser navigation)
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	246 * - 1002: Protocol error
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	247 * - 1003: Unsupported data type
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	248 * - 1006: Abnormal closure (no close frame received)
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	249 * - 1007: Invalid frame payload data
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	250 * - 1008: Policy violation
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	251 * - 1009: Message too big
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	252 * - 1010: Mandatory extension missing
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	253 * - 1011: Internal server error
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	254 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	255 * ## Building
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	256 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	257 * ### Build the library:
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	258 * ```bash
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	259 * bazel build //seobeo:seobeo_client
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	260 * ```
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	261 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	262 * ### Build and run the WebSocket test:
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	263 * ```bash
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	264 * bazel test //seobeo:seobeo_websocket_test
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	265 * ```
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	266 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	267 * ## Message Structure
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	268 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	269 * ```c
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	270 * typedef struct {
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	271 * Seobeo_WebSocket_Opcode opcode; // Message type
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	272 * uint8 *data; // Message payload
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	273 * size_t length; // Payload length
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	274 * boolean is_final; // Final fragment flag
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	275 * } Seobeo_WebSocket_Message;
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	276 * ```
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	277 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	278 * ## Protocol Details
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	279 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	280 * The implementation follows RFC 6455
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	281 *
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	282 * 1. Handshake: HTTP Upgrade request with `Sec-WebSocket-Key`
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	283 * 2. Frame Format: Proper FIN, opcode, mask, and payload length handling
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	284 * 3. Masking: All client-to-server frames are masked (required by RFC)
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	285 * 4. Fragmentation: Handles fragmented messages across multiple frames
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	286 * 5. Control Frames: Proper handling of ping, pong, and close frames
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	287 */
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	288
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	289 /* Connect to WebSocket server with given URL (ws:// or wss://). */
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	290 extern Seobeo_WebSocket Seobeo_WebSocket_Connect(const char url);
163 058de208e640 [Config] Adding os ignore files. June Park <parkjune1995@gmail.com> parents: 125 diff changeset	291 /* Connect to WebSocket server with custom headers. Headers should be newline-separated "Key: Value" pairs. */
058de208e640 [Config] Adding os ignore files. June Park <parkjune1995@gmail.com> parents: 125 diff changeset	292 extern Seobeo_WebSocket Seobeo_WebSocket_Connect_With_Headers(const char url, const char *headers);
120 cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	293 /* Send text message over WebSocket. */
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	294 extern int32 Seobeo_WebSocket_Send_Text(Seobeo_WebSocket p_ws, const char text);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	295 /* Send binary message over WebSocket. */
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	296 extern int32 Seobeo_WebSocket_Send_Binary(Seobeo_WebSocket p_ws, const uint8 data, size_t length);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	297 /* Send ping frame (for keep-alive). */
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	298 extern int32 Seobeo_WebSocket_Send_Ping(Seobeo_WebSocket p_ws, const char payload);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	299 /* Send pong frame (usually in response to ping). */
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	300 extern int32 Seobeo_WebSocket_Send_Pong(Seobeo_WebSocket p_ws, const char payload);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	301 /* Receive a message from WebSocket. Returns NULL if no message available or on error. */
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	302 extern Seobeo_WebSocket_Message Seobeo_WebSocket_Receive(Seobeo_WebSocket p_ws);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	303 /* Destroy received message. */
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	304 extern void Seobeo_WebSocket_Message_Destroy(Seobeo_WebSocket_Message *p_msg);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	305 /* Close WebSocket connection with status code and optional reason. */
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	306 extern int32 Seobeo_WebSocket_Close(Seobeo_WebSocket p_ws, uint16 code, const char reason);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	307 /* Destroy WebSocket and free all resources. */
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	308 extern void Seobeo_WebSocket_Destroy(Seobeo_WebSocket *p_ws);
cbbf78b17cfa [Seobeo][Websocket] Created Web socket client logic. June Park <parkjune1995@gmail.com> parents: 119 diff changeset	309
121 7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	310 // --- WebSocket Server API --- //
7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	311 /* Initialize WebSocket server routing system. Call before registering routes. */
7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	312 extern void Seobeo_WebSocket_Server_Init();
7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	313 /* Register a WebSocket route handler for a specific path. */
7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	314 extern void Seobeo_WebSocket_Server_Register(const char path, Seobeo_WebSocket_Server_Handler handler, void p_user_data);
7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	315 /* Send text message to specific WebSocket client. */
7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	316 extern int32 Seobeo_WebSocket_Server_Send_Text(Seobeo_WebSocket_Server_Connection p_conn, const char text);
7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	317 /* Send binary message to specific WebSocket client. */
7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	318 extern int32 Seobeo_WebSocket_Server_Send_Binary(Seobeo_WebSocket_Server_Connection p_conn, const uint8 data, size_t length);
7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	319 /* Broadcast text message to all connected WebSocket clients. */
125 f236c895604e [MrJuneJune] Added web socket for chat to this. June Park <parkjune1995@gmail.com> parents: 121 diff changeset	320 extern void Seobeo_WebSocket_Server_Broadcast_Text(const char text, Seobeo_WebSocket_Server_Connection origin_p_conn);
121 7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	321 /* Broadcast binary message to all connected WebSocket clients. */
7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	322 extern void Seobeo_WebSocket_Server_Broadcast_Binary(const uint8 *data, size_t length);
7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	323 /* Close WebSocket connection with status code and reason. */
7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	324 extern void Seobeo_WebSocket_Server_Connection_Close(Seobeo_WebSocket_Server_Connection p_conn, uint16 code, const char reason);
7b1719fa918c [Seobeo] Added web socket server. June Park <parkjune1995@gmail.com> parents: 120 diff changeset	325
72 4532ce6d9eb8 [Seobeo] Added router to the server logic. Few dowa string manipulation logics. June Park <parkjune1995@gmail.com> parents: 66 diff changeset	326 /* Initialize the router system (called automatically by Seobeo_Web_Server_Start) */
4532ce6d9eb8 [Seobeo] Added router to the server logic. Few dowa string manipulation logics. June Park <parkjune1995@gmail.com> parents: 66 diff changeset	327 extern void Seobeo_Router_Init();
4532ce6d9eb8 [Seobeo] Added router to the server logic. Few dowa string manipulation logics. June Park <parkjune1995@gmail.com> parents: 66 diff changeset	328 /* Register an API route handler. Call before starting server. */
4532ce6d9eb8 [Seobeo] Added router to the server logic. Few dowa string manipulation logics. June Park <parkjune1995@gmail.com> parents: 66 diff changeset	329 extern void Seobeo_Router_Register(const char method, const char path_pattern, Seobeo_Route_Handler handler);
4532ce6d9eb8 [Seobeo] Added router to the server logic. Few dowa string manipulation logics. June Park <parkjune1995@gmail.com> parents: 66 diff changeset	330 /* Clean up router resources */
4532ce6d9eb8 [Seobeo] Added router to the server logic. Few dowa string manipulation logics. June Park <parkjune1995@gmail.com> parents: 66 diff changeset	331 extern void Seobeo_Router_Destroy();
4532ce6d9eb8 [Seobeo] Added router to the server logic. Few dowa string manipulation logics. June Park <parkjune1995@gmail.com> parents: 66 diff changeset	332 /* Find matching route handler (internal use) */
4532ce6d9eb8 [Seobeo] Added router to the server logic. Few dowa string manipulation logics. June Park <parkjune1995@gmail.com> parents: 66 diff changeset	333 extern Seobeo_Route_Handler Seobeo_Router_Find_Handler(const char method, const char path, Seobeo_Request_Entry *pp_request_map, Dowa_Arena p_arena);
4532ce6d9eb8 [Seobeo] Added router to the server logic. Few dowa string manipulation logics. June Park <parkjune1995@gmail.com> parents: 66 diff changeset	334 /* Send HTTP response from response map (internal use) */
4532ce6d9eb8 [Seobeo] Added router to the server logic. Few dowa string manipulation logics. June Park <parkjune1995@gmail.com> parents: 66 diff changeset	335 extern void Seobeo_Router_Send_Response(Seobeo_Handle p_handle, Seobeo_Request_Entry p_response_map, Dowa_Arena *p_arena);
183 a8976a008a9d [BenchMark] Added bun bench mark to test seoboe vs other popular benchmarks. MrJuneJune <me@mrjunejune.com> parents: 163 diff changeset	336 /* Send HTTP response with keep-alive option */
a8976a008a9d [BenchMark] Added bun bench mark to test seoboe vs other popular benchmarks. MrJuneJune <me@mrjunejune.com> parents: 163 diff changeset	337 extern void Seobeo_Router_Send_Response_KeepAlive(Seobeo_Handle p_handle, Seobeo_Request_Entry p_response_map, Dowa_Arena *p_arena, boolean keep_alive);
78 e7bf9e002850 amend June Park <parkjune1995@gmail.com> parents: 77 diff changeset	338 extern char Seobeo_Web_LoadFile(const char file_path, size_t *p_file_size);
72 4532ce6d9eb8 [Seobeo] Added router to the server logic. Few dowa string manipulation logics. June Park <parkjune1995@gmail.com> parents: 66 diff changeset	339
5 3e12bf044589 Fixed Dowa hashmap to recursively add files into memory. June Park <parkjune1995@gmail.com> parents: 4 diff changeset	340 // --- Helper functions --- //
19 875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	341 /* Destroy handle. It will handle all NULL poointers. */
66 a0f0ad5e42eb [Misc] taking out capital P stuff. June Park <parkjune1995@gmail.com> parents: 64 diff changeset	342 extern void Seobeo_Handle_Destroy(Seobeo_Handle *p_handle);
19 875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	343 /* Write to socket from write_buffer in the handle. */
66 a0f0ad5e42eb [Misc] taking out capital P stuff. June Park <parkjune1995@gmail.com> parents: 64 diff changeset	344 extern int Seobeo_Handle_Flush(Seobeo_Handle *p_handle);
19 875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	345 /* Write to socket with given data source, if the data source is bigger than the write buffer for handle then we just directly write from the data source. */
66 a0f0ad5e42eb [Misc] taking out capital P stuff. June Park <parkjune1995@gmail.com> parents: 64 diff changeset	346 extern int Seobeo_Handle_Queue(Seobeo_Handle p_handle, const uint8_t data, uint32_t data_size);
19 875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	347 /* Read to socket from read_buffer in the handle. */
66 a0f0ad5e42eb [Misc] taking out capital P stuff. June Park <parkjune1995@gmail.com> parents: 64 diff changeset	348 extern int Seobeo_Handle_Read(Seobeo_Handle *p_handle);
19 875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	349 /* Move to read_buffer to front and we already consumed the given amount in the handle. */
66 a0f0ad5e42eb [Misc] taking out capital P stuff. June Park <parkjune1995@gmail.com> parents: 64 diff changeset	350 extern void Seobeo_Handle_Consume(Seobeo_Handle *p_handle, uint32 consumed);
19 875bb6e10db7 [Seobeo] Chaning Function naming to be easily readable. June Park <parkjune1995@gmail.com> parents: 18 diff changeset	351 /* Assign IP4 or IP6 to sockaddr. TODO: Maybe create my own struct for this? */
96 70401cf61e97 [Seobeo] Added logging. June Park <parkjune1995@gmail.com> parents: 79 diff changeset	352 extern void Seobeo_Get_IP4_Or_IP6(struct sockaddr sa);
70401cf61e97 [Seobeo] Added logging. June Park <parkjune1995@gmail.com> parents: 79 diff changeset	353 /* Logging */
70401cf61e97 [Seobeo] Added logging. June Park <parkjune1995@gmail.com> parents: 79 diff changeset	354 typedef enum {
70401cf61e97 [Seobeo] Added logging. June Park <parkjune1995@gmail.com> parents: 79 diff changeset	355 SEOBEO_INFO = 0,
70401cf61e97 [Seobeo] Added logging. June Park <parkjune1995@gmail.com> parents: 79 diff changeset	356 SEOBEO_WARNING,
70401cf61e97 [Seobeo] Added logging. June Park <parkjune1995@gmail.com> parents: 79 diff changeset	357 SEOBEO_ERROR,
70401cf61e97 [Seobeo] Added logging. June Park <parkjune1995@gmail.com> parents: 79 diff changeset	358 SEOBEO_DEBUG,
70401cf61e97 [Seobeo] Added logging. June Park <parkjune1995@gmail.com> parents: 79 diff changeset	359 } Seobeo_Log_Level;
70401cf61e97 [Seobeo] Added logging. June Park <parkjune1995@gmail.com> parents: 79 diff changeset	360 extern int Seobeo_Log(Seobeo_Log_Level level, const char *format, ...);
1 adcfad6e86fb Updated naming and separated out some logic within seobeo. June Park <parkjune1995@gmail.com> parents: diff changeset	361 #endif

Mercurial

annotate seobeo/seobeo.h @ 184:8c74204fd362