forked from retoor/devplacepy
retoorandClaude Sonnet 5
572e022584
Notifications: a new "thread" type notifies every other commenter on a
post whenever anyone comments on it, disregarding reply hierarchy -
excluding the actor and whoever already got a comment/reply
notification for that same event, so no one is double-notified.
Implemented via a background-deferred fan-out mirroring the existing
mention-notification pattern.
SEO: discussion_forum_posting() now embeds up to 20 of a post's
comments as nested schema.org Comment entities (not just an aggregate
count), and a new /topics hub plus /topics/{topic} pages give the
feed's topic filter real, independently crawlable/indexable URLs -
/feed?topic=X was never indexable since its canonical strips the
query string back to bare /feed. Both are wired end to end (schemas,
Devii actions, docs API, sitemap, locustfile load-test coverage).
Quiz player: the auto-advance to the next question used to hide the
just-answered slide in the same tick as rendering the grade, so on
any multi-question quiz the Correct/Not correct feedback was never
actually visible before the view moved on. Delayed via setTimeout,
with the pending timer cleared on manual navigation and on
disconnect so it can't race or fire on a removed component.
Also includes other local changes already in progress in this
working tree before this session (messaging, push delivery,
deepsearch jobs, game economy, quiz builder) - verified by the full
suite passing (3467 tests) but not authored or individually reviewed
in this session.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VL9Xn57W5UR3HZbbuuzxdK
117 lines
4.4 KiB
Python
117 lines
4.4 KiB
Python
# retoor <retoor@molodetz.nl>
|
|
|
|
from .._shared import endpoint, field
|
|
|
|
GROUP = {
|
|
"slug": "messaging",
|
|
"title": "Messaging",
|
|
"intro": """
|
|
# Messaging
|
|
|
|
Direct messages between users. The inbox renders HTML; sending uses form fields. Look up
|
|
recipients with [Search & Lookups](/docs/lookups.html) and attach files via [Uploads](/docs/uploads.html).
|
|
|
|
Every endpoint follows the shared [Conventions & Errors](/docs/conventions.html) (auth, content
|
|
negotiation, pagination, status codes); see [Authentication](/docs/authentication.html) for the
|
|
four ways to sign requests.
|
|
""",
|
|
"endpoints": [
|
|
endpoint(
|
|
id="messages-inbox",
|
|
method="GET",
|
|
path="/messages",
|
|
title="Open the inbox",
|
|
summary="Render conversations. Returns an HTML page.",
|
|
auth="user",
|
|
interactive=True,
|
|
params=[
|
|
field(
|
|
"with_uid",
|
|
"query",
|
|
"string",
|
|
False,
|
|
"",
|
|
"Open a specific conversation by user UID.",
|
|
),
|
|
field(
|
|
"search",
|
|
"query",
|
|
"string",
|
|
False,
|
|
"",
|
|
"Jump to a conversation by username.",
|
|
),
|
|
field(
|
|
"before",
|
|
"query",
|
|
"string",
|
|
False,
|
|
"",
|
|
"ISO timestamp. When set, return the page of messages strictly older than this instant (for loading earlier history).",
|
|
),
|
|
],
|
|
),
|
|
endpoint(
|
|
id="messages-send",
|
|
method="POST",
|
|
path="/messages/send",
|
|
title="Send a message",
|
|
summary="Send a direct message to a user.",
|
|
auth="user",
|
|
encoding="form",
|
|
destructive=True,
|
|
params=[
|
|
field(
|
|
"content",
|
|
"form",
|
|
"textarea",
|
|
False,
|
|
"Hello there.",
|
|
"Body, 0-2000 characters. May be empty when at least one attachment is provided.",
|
|
),
|
|
field(
|
|
"receiver_uid",
|
|
"form",
|
|
"string",
|
|
True,
|
|
"RECEIVER_UID",
|
|
"Recipient user UID.",
|
|
),
|
|
],
|
|
),
|
|
endpoint(
|
|
id="messages-conversations",
|
|
method="GET",
|
|
path="/messages/conversations",
|
|
title="List conversations",
|
|
summary="Return the signed-in user's conversation list as JSON, for live refresh without a full page reload.",
|
|
auth="user",
|
|
interactive=False,
|
|
sample_response={
|
|
"conversations": [
|
|
{
|
|
"other_user": {"uid": "8f14e45f-...", "username": "alice_test"},
|
|
"last_message": "Hello there.",
|
|
"last_message_at": "2026-07-21T10:00:00+00:00",
|
|
"unread": True,
|
|
}
|
|
]
|
|
},
|
|
),
|
|
endpoint(
|
|
id="messages-ws-ticket",
|
|
method="POST",
|
|
path="/messages/ws-ticket",
|
|
title="Issue a WebSocket ticket",
|
|
summary="Exchange the caller's session/API-key auth for a short-lived, single-use ticket that a browser WebSocket handshake can carry as a query parameter (a native WebSocket cannot set custom auth headers).",
|
|
auth="user",
|
|
encoding="none",
|
|
interactive=False,
|
|
notes=[
|
|
"The ticket is valid for 30 seconds and can be redeemed exactly once, as `wss://.../messages/ws?ticket=<ticket>`.",
|
|
],
|
|
sample_response={"ticket": "3f9c2a...", "expires_in": 30},
|
|
),
|
|
],
|
|
}
|