snac.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317
  1. /* snac - A simple, minimalistic ActivityPub instance */
  2. /* copyright (c) 2022 - 2024 grunfink et al. / MIT license */
  3. #define VERSION "2.44-dev"
  4. #define USER_AGENT "snac/" VERSION
  5. #define WHAT_IS_SNAC_URL "https:/" "/comam.es/what-is-snac"
  6. #define DIR_PERM 00770
  7. #define DIR_PERM_ADD 02770
  8. #define ISO_DATE_SPEC "%Y-%m-%dT%H:%M:%SZ"
  9. #ifndef MAX_THREADS
  10. #define MAX_THREADS 256
  11. #endif
  12. extern double disk_layout;
  13. extern xs_str *srv_basedir;
  14. extern xs_dict *srv_config;
  15. extern xs_str *srv_baseurl;
  16. extern int dbglevel;
  17. #define L(s) (s)
  18. int mkdirx(const char *pathname);
  19. int valid_status(int status);
  20. xs_str *tid(int offset);
  21. double ftime(void);
  22. void srv_log(xs_str *str);
  23. #define srv_debug(level, str) do { if (dbglevel >= (level)) \
  24. { srv_log((str)); } } while (0)
  25. typedef struct {
  26. xs_str *uid; /* uid */
  27. xs_str *basedir; /* user base directory */
  28. xs_dict *config; /* user configuration */
  29. xs_dict *config_o; /* user configuration admin override */
  30. xs_dict *key; /* keypair */
  31. xs_str *actor; /* actor url */
  32. xs_str *md5; /* actor url md5 */
  33. } snac;
  34. typedef struct {
  35. int srv_running; /* server running on/off */
  36. int use_fcgi; /* FastCGI use on/off */
  37. time_t srv_start_time; /* start time */
  38. int job_fifo_size; /* job fifo size */
  39. int n_threads; /* number of configured threads */
  40. } srv_state;
  41. void snac_log(snac *user, xs_str *str);
  42. #define snac_debug(user, level, str) do { if (dbglevel >= (level)) \
  43. { snac_log((user), (str)); } } while (0)
  44. int srv_open(char *basedir, int auto_upgrade);
  45. void srv_free(void);
  46. int user_open(snac *snac, const char *uid);
  47. void user_free(snac *snac);
  48. xs_list *user_list(void);
  49. int user_open_by_md5(snac *snac, const char *md5);
  50. int validate_uid(const char *uid);
  51. xs_str *hash_password(const char *uid, const char *passwd, const char *nonce);
  52. int check_password(const char *uid, const char *passwd, const char *hash);
  53. void srv_archive(const char *direction, const char *url, xs_dict *req,
  54. const char *payload, int p_size,
  55. int status, xs_dict *headers,
  56. const char *body, int b_size);
  57. void srv_archive_error(const char *prefix, const xs_str *err,
  58. const xs_dict *req, const xs_val *data);
  59. void srv_archive_qitem(char *prefix, xs_dict *q_item);
  60. double mtime_nl(const char *fn, int *n_link);
  61. #define mtime(fn) mtime_nl(fn, NULL)
  62. double f_ctime(const char *fn);
  63. int index_add_md5(const char *fn, const char *md5);
  64. int index_add(const char *fn, const char *id);
  65. int index_gc(const char *fn);
  66. int index_first(const char *fn, char *buf, int size);
  67. int index_len(const char *fn);
  68. xs_list *index_list(const char *fn, int max);
  69. xs_list *index_list_desc(const char *fn, int skip, int show);
  70. int object_add(const char *id, const xs_dict *obj);
  71. int object_add_ow(const char *id, const xs_dict *obj);
  72. int object_here_by_md5(const char *id);
  73. int object_here(const char *id);
  74. int object_get_by_md5(const char *md5, xs_dict **obj);
  75. int object_get(const char *id, xs_dict **obj);
  76. int object_del(const char *id);
  77. int object_del_if_unref(const char *id);
  78. double object_ctime_by_md5(const char *md5);
  79. double object_ctime(const char *id);
  80. int object_admire(const char *id, const char *actor, int like);
  81. int object_unadmire(const char *id, const char *actor, int like);
  82. int object_likes_len(const char *id);
  83. int object_announces_len(const char *id);
  84. xs_list *object_children(const char *id);
  85. xs_list *object_likes(const char *id);
  86. xs_list *object_announces(const char *id);
  87. int object_parent(const char *id, char *buf, int size);
  88. int object_user_cache_add(snac *snac, const char *id, const char *cachedir);
  89. int object_user_cache_del(snac *snac, const char *id, const char *cachedir);
  90. int follower_add(snac *snac, const char *actor);
  91. int follower_del(snac *snac, const char *actor);
  92. int follower_check(snac *snac, const char *actor);
  93. xs_list *follower_list(snac *snac);
  94. double timeline_mtime(snac *snac);
  95. int timeline_touch(snac *snac);
  96. int timeline_here(snac *snac, const char *md5);
  97. int timeline_get_by_md5(snac *snac, const char *md5, xs_dict **msg);
  98. int timeline_del(snac *snac, char *id);
  99. xs_list *timeline_simple_list(snac *snac, const char *idx_name, int skip, int show);
  100. xs_list *timeline_list(snac *snac, const char *idx_name, int skip, int show);
  101. int timeline_add(snac *snac, const char *id, const xs_dict *o_msg);
  102. void timeline_admire(snac *snac, const char *id, const char *admirer, int like);
  103. xs_list *timeline_top_level(snac *snac, xs_list *list);
  104. xs_list *local_list(snac *snac, int max);
  105. xs_list *timeline_instance_list(int skip, int show);
  106. int following_add(snac *snac, const char *actor, const xs_dict *msg);
  107. int following_del(snac *snac, const char *actor);
  108. int following_check(snac *snac, const char *actor);
  109. int following_get(snac *snac, const char *actor, xs_dict **data);
  110. xs_list *following_list(snac *snac);
  111. void mute(snac *snac, const char *actor);
  112. void unmute(snac *snac, const char *actor);
  113. int is_muted(snac *snac, const char *actor);
  114. int pin(snac *user, const char *id);
  115. int unpin(snac *user, const char *id);
  116. int is_pinned(snac *user, const char *id);
  117. int is_pinned_by_md5(snac *user, const char *md5);
  118. xs_list *pinned_list(snac *user);
  119. int limited(snac *user, const char *id, int cmd);
  120. #define is_limited(user, id) limited((user), (id), 0)
  121. #define limit(user, id) limited((user), (id), 1)
  122. #define unlimit(user, id) limited((user), (id), 2)
  123. void hide(snac *snac, const char *id);
  124. int is_hidden(snac *snac, const char *id);
  125. void tag_index(const char *id, const xs_dict *obj);
  126. xs_list *tag_search(char *tag, int skip, int show);
  127. int actor_add(const char *actor, xs_dict *msg);
  128. int actor_get(const char *actor, xs_dict **data);
  129. int static_get(snac *snac, const char *id, xs_val **data, int *size, const char *inm, xs_str **etag);
  130. void static_put(snac *snac, const char *id, const char *data, int size);
  131. void static_put_meta(snac *snac, const char *id, const char *str);
  132. xs_str *static_get_meta(snac *snac, const char *id);
  133. double history_mtime(snac *snac, const char *id);
  134. void history_add(snac *snac, const char *id, const char *content, int size,
  135. xs_str **etag);
  136. int history_get(snac *snac, const char *id, xs_str **content, int *size,
  137. const char *inm, xs_str **etag);
  138. int history_del(snac *snac, const char *id);
  139. xs_list *history_list(snac *snac);
  140. void lastlog_write(snac *snac, const char *source);
  141. xs_str *notify_check_time(snac *snac, int reset);
  142. void notify_add(snac *snac, const char *type, const char *utype,
  143. const char *actor, const char *objid);
  144. xs_dict *notify_get(snac *snac, const char *id);
  145. xs_list *notify_list(snac *snac, int new_only);
  146. void notify_clear(snac *snac);
  147. void inbox_add(const char *inbox);
  148. void inbox_add_by_actor(const xs_dict *actor);
  149. xs_list *inbox_list(void);
  150. int is_instance_blocked(const char *instance);
  151. int instance_block(const char *instance);
  152. int instance_unblock(const char *instance);
  153. void enqueue_input(snac *snac, const xs_dict *msg, const xs_dict *req, int retries);
  154. void enqueue_shared_input(const xs_dict *msg, const xs_dict *req, int retries);
  155. void enqueue_output_raw(const char *keyid, const char *seckey,
  156. xs_dict *msg, xs_str *inbox, int retries, int p_status);
  157. void enqueue_output(snac *snac, xs_dict *msg, xs_str *inbox, int retries, int p_status);
  158. void enqueue_output_by_actor(snac *snac, xs_dict *msg, const xs_str *actor, int retries);
  159. void enqueue_email(xs_str *msg, int retries);
  160. void enqueue_telegram(const xs_str *msg, const char *bot, const char *chat_id);
  161. void enqueue_message(snac *snac, const xs_dict *msg);
  162. void enqueue_close_question(snac *user, const char *id, int end_secs);
  163. void enqueue_request_replies(snac *user, const char *id);
  164. int was_question_voted(snac *user, const char *id);
  165. xs_list *user_queue(snac *snac);
  166. xs_list *queue(void);
  167. xs_dict *queue_get(const char *fn);
  168. xs_dict *dequeue(const char *fn);
  169. void purge(snac *snac);
  170. void purge_all(void);
  171. xs_dict *http_signed_request_raw(const char *keyid, const char *seckey,
  172. const char *method, const char *url,
  173. xs_dict *headers,
  174. const char *body, int b_size,
  175. int *status, xs_str **payload, int *p_size,
  176. int timeout);
  177. xs_dict *http_signed_request(snac *snac, const char *method, const char *url,
  178. xs_dict *headers,
  179. const char *body, int b_size,
  180. int *status, xs_str **payload, int *p_size,
  181. int timeout);
  182. int check_signature(xs_dict *req, xs_str **err);
  183. void httpd(void);
  184. int webfinger_request_signed(snac *snac, const char *qs, char **actor, char **user);
  185. int webfinger_request(const char *qs, char **actor, char **user);
  186. int webfinger_get_handler(xs_dict *req, char *q_path,
  187. char **body, int *b_size, char **ctype);
  188. const char *default_avatar_base64(void);
  189. xs_str *process_tags(snac *snac, const char *content, xs_list **tag);
  190. xs_dict *msg_admiration(snac *snac, char *object, char *type);
  191. xs_dict *msg_create(snac *snac, const xs_dict *object);
  192. xs_dict *msg_follow(snac *snac, const char *actor);
  193. xs_dict *msg_note(snac *snac, const xs_str *content, const xs_val *rcpts,
  194. xs_str *in_reply_to, xs_list *attach, int priv);
  195. xs_dict *msg_undo(snac *snac, char *object);
  196. xs_dict *msg_delete(snac *snac, char *id);
  197. xs_dict *msg_actor(snac *snac);
  198. xs_dict *msg_update(snac *snac, xs_dict *object);
  199. xs_dict *msg_ping(snac *user, const char *rcpt);
  200. xs_dict *msg_pong(snac *user, const char *rcpt, const char *object);
  201. xs_dict *msg_question(snac *user, const char *content, xs_list *attach,
  202. const xs_list *opts, int multiple, int end_secs);
  203. int activitypub_request(snac *snac, const char *url, xs_dict **data);
  204. int actor_request(snac *user, const char *actor, xs_dict **data);
  205. void timeline_request_replies(snac *user, const char *id);
  206. int send_to_inbox_raw(const char *keyid, const char *seckey,
  207. const xs_str *inbox, const xs_dict *msg,
  208. xs_val **payload, int *p_size, int timeout);
  209. int send_to_inbox(snac *snac, const xs_str *inbox, const xs_dict *msg,
  210. xs_val **payload, int *p_size, int timeout);
  211. xs_str *get_actor_inbox(const char *actor);
  212. int send_to_actor(snac *snac, const char *actor, const xs_dict *msg,
  213. xs_val **payload, int *p_size, int timeout);
  214. int is_msg_public(const xs_dict *msg);
  215. int is_msg_for_me(snac *snac, const xs_dict *msg);
  216. int process_user_queue(snac *snac);
  217. void process_queue_item(xs_dict *q_item);
  218. int process_queue(void);
  219. int activitypub_get_handler(const xs_dict *req, const char *q_path,
  220. char **body, int *b_size, char **ctype);
  221. int activitypub_post_handler(const xs_dict *req, const char *q_path,
  222. char *payload, int p_size,
  223. char **body, int *b_size, char **ctype);
  224. xs_str *not_really_markdown(const char *content, xs_list **attach);
  225. xs_str *sanitize(const char *content);
  226. xs_str *encode_html(const char *str);
  227. xs_str *html_timeline(snac *user, const xs_list *list, int local,
  228. int skip, int show, int show_more, char *tag);
  229. int html_get_handler(const xs_dict *req, const char *q_path,
  230. char **body, int *b_size, char **ctype, xs_str **etag);
  231. int html_post_handler(const xs_dict *req, const char *q_path,
  232. char *payload, int p_size,
  233. char **body, int *b_size, char **ctype);
  234. int snac_init(const char *_basedir);
  235. int adduser(const char *uid);
  236. int resetpwd(snac *snac);
  237. int deluser(snac *user);
  238. extern const char *snac_blurb;
  239. void job_post(const xs_val *job, int urgent);
  240. void job_wait(xs_val **job);
  241. int oauth_get_handler(const xs_dict *req, const char *q_path,
  242. char **body, int *b_size, char **ctype);
  243. int oauth_post_handler(const xs_dict *req, const char *q_path,
  244. const char *payload, int p_size,
  245. char **body, int *b_size, char **ctype);
  246. int mastoapi_get_handler(const xs_dict *req, const char *q_path,
  247. char **body, int *b_size, char **ctype);
  248. int mastoapi_post_handler(const xs_dict *req, const char *q_path,
  249. const char *payload, int p_size,
  250. char **body, int *b_size, char **ctype);
  251. int mastoapi_put_handler(const xs_dict *req, const char *q_path,
  252. const char *payload, int p_size,
  253. char **body, int *b_size, char **ctype);
  254. void mastoapi_purge(void);