Chat refactor + persistent backing chat users (#1163)
* First pass at chat user registration and validation * Disable chat if the user is disabled/blocked or the server hits max connections * Handle dropping sockets if chat is disabled * Fix origin in automated chat test * Work for updated chat moderation * Chat message markdown rendering and fix tests * Put /api/chat behind a chat user access token. Closes #1085 * Reject blocked username changes * More WIP moderation * Defer configuring chat until we know if it is enabled. Closes #1135 * chat user blocking. Closes #1096 * Add tests around user access for #1096 * Add external integration chat message API + update integration auth middleware to pass along integration name. Closes #1092 * Delete old chat messages from db as to not hold on to excessive data. Closes #1152 * Add schema migration for messages. Closes #1155 * Commit updated API documentation * Add chat load test * Shared db mutex and db optimizations * Simplify past display name handling * Use a new test db for each test run * Wire up the external messages actions + add tests for them * Move access tokens to be actual users * Run message pruning at launch + fix comparison * Do not return API users in disabled users response * Fix incorrect highlighting. Closes #1160 * Consolidate user table statements * Set the max process connection limit to 70% of maximum * Fix wrong old display name being returned in name change event * Delete the old chat server files * Wire back up the webhooks * Remove unused * Invalidate user cache on changes * Do not send rendered body as RawBody * Some cleanup * Standardize names for external API users to ExternalAPIUser * Do not log token * Checkout branch when building admin for testing * Bundle in dev admin for testing * Some cleanup * Cleanup js logs * Cleanup and standardize event names * Clean up some logging * Update API spec. Closes #1133 * Commit updated API documentation * Change paths to be better named * Commit updated API documentation * Update admin bundle * Fix duplicate event name * Rename scope var * Update admin bundle * Move connected clients controller into admin package * Fix collecting usernames for autocomplete purposes * No longer generate username when it is empty * Sort clients and users by timestamp * Move file to admin controller package * Swap, so the comments stay correct Co-authored-by: Jannik <jannik@outlook.com> * Use explicit type alias Co-authored-by: Jannik <jannik@outlook.com> * Remove commented code. Co-authored-by: Jannik <jannik@outlook.com> * Cleanup test * Remove some extra logging * Add some clarity * Update dev instance of admin for testing * Consolidate lines Co-authored-by: Jannik <jannik@outlook.com> * Remove commented unused vars Co-authored-by: Jannik <jannik@outlook.com> * Until needed do not return IP address with client list * Fix typo of wrong var * Typo led to a bad test. Fix typo and fix test. * Guard against the socket reconnecting on error if previously set to shutdown * Do not log access tokens * Return success message on enable/disable user * Clean up some inactionable error messages. Sent ban message. Sort banned users. * fix styling for when chat is completely disabled * Unused * guard against nil clients * Update dev admin bundle * Do not unhide messages when unblocking user just to be safe. Send removal action from the controller * Add convinience function for getting active connections for a single user * Lock db on these mutations * Cleanup force disconnect using GetClientsForUser and capture client reference explicitly * No longer re-showing banned user messages for safety. Removing this test. * Remove no longer needed comment * Tweaks to forbidden username handling. - Standardize naming to not use "block" but "forbidden" instead. - Pass array over the wire instead of string. - Add API test - Fix default list incorrectly being appended to custom list. * Logging cleanup * Update dev admin bundle * Add an artificial delay in order to visually see message being hidden when testing * Remove the user cache as it is a premature optimization * When connected to chat let the user know their current user details to sync the username in the UI * On connected send current display name back to client. - Move name change out of chat component. - Add additional event type constants. * Fix broken workflow due to typo * Troubleshoot workflow * Bump htm from 3.0.4 to 3.1.0 in /build/javascript (#1181) * Bump htm from 3.0.4 to 3.1.0 in /build/javascript Bumps [htm](https://github.com/developit/htm) from 3.0.4 to 3.1.0. - [Release notes](https://github.com/developit/htm/releases) - [Commits](https://github.com/developit/htm/compare/3.0.4...3.1.0) --- updated-dependencies: - dependency-name: htm dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> * Run npm run build and update libraries Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Gabe Kangas <gabek@real-ity.com> * Commit updated Javascript packages * Re-send current user info when a rejected name change takes place * All socket writes should be through the send chan and not directly * Seed the random generator * Add keys and indexes to users table * a util to generate consistent emoji markup * console clean up * mod tidy * Commit updated API documentation * Handle the max payload size of a socket message. - Only close socket if x2 greater than the max size. - Send the user a message if a message is too large. - Surface the max size in bytes in the config. * Update admin bundle * Force all events to be sent in their own socket message and do not concatinate in a single message * Update chat embed to register for access token * Use a different access token for embed chat * Update the chat message bubble background color to be bolder * add base tag to open links in new window, closes #1220 * Support text input of :emoji: in chat (#1190) * Initial implementation of emoji injection * fix bookkeeping with multiple emoji * make the emoji lookup case-insensitive * try another solution for Caretposition * add title to emojis minor refactoring * bind moji injection to InputKeyUp * simplify the code replace all found emojis * inject emoji if the modifer is released earlier * more efficient emoji tag search * use json emoji.emoji as url * use createEmojiMarkup() * move emojify() to chat.js * emojify on paste * cleanup emoji titles in paste * update inputText in InputKeyup * mark emoji titles with 2*zwnj this way paste cleanup will not interfere with text which include zwnj * emoji should not change the inputText * Do not show join messages when chat is offline. Closes #1224 - Show stream starting/ending messages in chat. - When stream starts show everyone the welcome message. * Force scrolling chat to bottom after history is populated regardless of scroll position. Closes https://github.com/owncast/owncast/issues/1222 * use maxSocketPayloadSize to calculate total bytes of message payload (#1221) * utilize maxSocketPayloadSize from config; update chatInput to calculate based on that value instead of text value; remove usage of inputText for counting * add a buffer to account for entire websocket payload for message char counting; trim nbsp;'s from ends of messages when calculating count Co-authored-by: Gabe Kangas <gabek@real-ity.com> Co-authored-by: Owncast <owncast@owncast.online> Co-authored-by: Jannik <jannik@outlook.com> Co-authored-by: Ginger Wong <omqmail@gmail.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Meisam <39205857+MFTabriz@users.noreply.github.com>
This commit is contained in:
150
openapi.yaml
150
openapi.yaml
@@ -2,7 +2,7 @@ openapi: 3.0.1
|
||||
info:
|
||||
title: Owncast
|
||||
description: Owncast is a self-hosted live video and web chat server for use with existing popular broadcasting software. The following APIs represent the state in the development branch.
|
||||
version: '0.0.7'
|
||||
version: '0.0.8-develop'
|
||||
contact:
|
||||
name: Gabe Kangas
|
||||
email: gabek@real-ity.com
|
||||
@@ -27,6 +27,11 @@ components:
|
||||
items:
|
||||
$ref: "#/components/schemas/Client"
|
||||
|
||||
UserArray:
|
||||
type: array
|
||||
items:
|
||||
$ref: "#/components/schemas/User"
|
||||
|
||||
LogEntryArray:
|
||||
type: array
|
||||
items:
|
||||
@@ -58,6 +63,7 @@ components:
|
||||
userAgent:
|
||||
description: The web client used to connect to this server
|
||||
type: string
|
||||
example: "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
|
||||
ipAddress:
|
||||
description: The public IP address of this client
|
||||
type: string
|
||||
@@ -77,6 +83,8 @@ components:
|
||||
type: string
|
||||
timeZone:
|
||||
type: string
|
||||
user:
|
||||
$ref: "#/components/schemas/User"
|
||||
x-last-modified: 1602052347511
|
||||
|
||||
BasicResponse:
|
||||
@@ -242,6 +250,30 @@ components:
|
||||
format: date-time
|
||||
description: When this webhook was last used.
|
||||
|
||||
User:
|
||||
type: object
|
||||
properties:
|
||||
id:
|
||||
type: string
|
||||
description: User ID
|
||||
example: yklw5Imng
|
||||
displayName:
|
||||
type: string
|
||||
description: The user-facing disaplay name for this user.
|
||||
example: awesome-pizza
|
||||
displayColor:
|
||||
type: integer
|
||||
description: Hue value for displaying in the UI.
|
||||
example: 42
|
||||
createdAt:
|
||||
type: string
|
||||
format: date-time
|
||||
description: When this account was originally registered/created.
|
||||
previousNames:
|
||||
type: string
|
||||
description: Comma separated list of names previously used by this user.
|
||||
example: "awesome-pizza,user42"
|
||||
|
||||
securitySchemes:
|
||||
AdminBasicAuth:
|
||||
type: http
|
||||
@@ -251,8 +283,20 @@ components:
|
||||
type: http
|
||||
scheme: bearer
|
||||
description: 3rd party integration auth where a service user must provide an access token.
|
||||
UserToken:
|
||||
type: apiKey
|
||||
name: accessToken
|
||||
in: query
|
||||
description: 3rd party integration auth where a service user must provide an access token.
|
||||
|
||||
responses:
|
||||
UsersResponse:
|
||||
description: A collection of users.
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
$ref: "#/components/schemas/UserArray"
|
||||
|
||||
ClientsResponse:
|
||||
description: Successful response of an array of clients
|
||||
content:
|
||||
@@ -266,12 +310,16 @@ components:
|
||||
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36
|
||||
(KHTML, like Gecko) Chrome/84.0.4147.89 Safari/537.36
|
||||
ipAddress: "172.217.164.110"
|
||||
username: coolperson42
|
||||
clientID: 2ba20dd34f911c198df3218ddc64c740
|
||||
geo:
|
||||
countryCode: US
|
||||
regionName: California
|
||||
timeZone: America/Los_Angeles
|
||||
user:
|
||||
id: yklw5Imng
|
||||
displayName: awesome-pizza
|
||||
displayColor: 42
|
||||
createdAt: "2021-07-08T20:21:25.303402404-07:00"
|
||||
previousNames: "awesome-pizza,coolPerson23"
|
||||
|
||||
LogsResponse:
|
||||
description: Response of server log entries
|
||||
@@ -337,6 +385,15 @@ paths:
|
||||
schema:
|
||||
$ref: "#/components/schemas/InstanceDetails"
|
||||
|
||||
/api/ping:
|
||||
get:
|
||||
summary: Mark the current viewer as active.
|
||||
description: For tracking viewer count, periodically hit the ping endpoint.
|
||||
tags: ["Server"]
|
||||
responses:
|
||||
"200":
|
||||
description: "Successful ping"
|
||||
|
||||
/api/status:
|
||||
get:
|
||||
summary: Current Status
|
||||
@@ -376,11 +433,48 @@ paths:
|
||||
sessionMaxViewerCount: 12
|
||||
viewerCount: 7
|
||||
|
||||
/api/chat/register:
|
||||
post:
|
||||
summary: Register a chat user
|
||||
description: Register a user that returns an access token for accessing chat.
|
||||
tags: ["Chat"]
|
||||
security:
|
||||
- UserToken: []
|
||||
requestBody:
|
||||
required: false
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
displayName:
|
||||
type: string
|
||||
description: Optionally provide a display name you want to assign to this user when registering.
|
||||
responses:
|
||||
"200":
|
||||
description: ""
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
id:
|
||||
type: string
|
||||
description: The new user's id.
|
||||
accessToken:
|
||||
type: string
|
||||
description: The access token used for accessing chat.
|
||||
displayName:
|
||||
type: string
|
||||
description: The user-facing name displayed for this user.
|
||||
|
||||
/api/chat:
|
||||
get:
|
||||
summary: Historical Chat Messages
|
||||
description: Used to get all chat messages prior to connecting to the websocket.
|
||||
summary: Chat Messages Backlog
|
||||
description: Used to get chat messages prior to connecting to the websocket.
|
||||
tags: ["Chat"]
|
||||
security:
|
||||
- UserToken: []
|
||||
responses:
|
||||
"200":
|
||||
description: ""
|
||||
@@ -586,6 +680,17 @@ paths:
|
||||
"200":
|
||||
$ref: "#/components/responses/ClientsResponse"
|
||||
|
||||
/api/admin/users/disabled:
|
||||
get:
|
||||
summary: Return a list of currently connected clients
|
||||
description: Return a list of currently connected clients with optional geo details.
|
||||
tags: ["Admin"]
|
||||
security:
|
||||
- AdminBasicAuth: []
|
||||
responses:
|
||||
"200":
|
||||
$ref: "#/components/responses/UsersResponse"
|
||||
|
||||
/api/admin/logs:
|
||||
get:
|
||||
summary: Return recent log entries
|
||||
@@ -708,6 +813,32 @@ paths:
|
||||
"200":
|
||||
$ref: "#/components/responses/BasicResponse"
|
||||
|
||||
|
||||
/api/admin/chat/users/setenabled:
|
||||
post:
|
||||
summary: Enable or disable a single user.
|
||||
description: Enable or disable a single user. Disabling will also hide all the user's chat messages.
|
||||
requestBody:
|
||||
content:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
userId:
|
||||
type: string
|
||||
description: User ID to act upon.
|
||||
example: "yklw5Imng"
|
||||
enabled:
|
||||
type: boolean
|
||||
description: Set the enabled state of this user.
|
||||
tags: ["Admin"]
|
||||
security:
|
||||
- AdminBasicAuth: []
|
||||
responses:
|
||||
"200":
|
||||
$ref: "#/components/responses/BasicResponse"
|
||||
|
||||
|
||||
/api/admin/config/key:
|
||||
post:
|
||||
summary: Set the stream key.
|
||||
@@ -1170,10 +1301,10 @@ paths:
|
||||
value: Streaming my favorite game, Desert Bus.
|
||||
|
||||
|
||||
/api/integrations/chat/user:
|
||||
/api/integrations/chat/send:
|
||||
post:
|
||||
summary: Send a user chat message.
|
||||
description: Send a chat message on behalf of a user. Could be a bot name or a real user.
|
||||
summary: Send a chat message.
|
||||
description: Send a chat message on behalf of a 3rd party integration, bot or service.
|
||||
tags: ["Integrations"]
|
||||
security:
|
||||
- AccessToken: []
|
||||
@@ -1184,9 +1315,6 @@ paths:
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
user:
|
||||
type: string
|
||||
description: The user you want to send this message as.
|
||||
body:
|
||||
type: string
|
||||
description: The message text that will be sent as the user.
|
||||
|
||||
Reference in New Issue
Block a user