Function api_locations

Scripts/ButSystem.py:14275–14311

api_locations. Route handler or application helper. This docstring was expanded to make future maintenance easier. Returns: Varies.

()

    {% endif %}
  </div>
  <div class="msg-meta">
    <span class="ts" data-utc="{{ m.created_at_utc }}">{{ m.created_at_local }}</span>{% if m.deleted %} • deleted{% endif %}
    {% if m.sender==me %}
      {% if m.read_at_local %} • seen <span class="ts" data-utc="{{ m.read_at_utc }}">{{ m.read_at_local }}</span>{% else %} • sent{% endif %}
    {% endif %}
  </div>
</div>
"""

_GROUP_ROW_TEMPLATE = r"""
<div class="mb-2" data-gmid="{{ m.id }}">
  <div class="bubble {{ 'me' if m.sender==me else 'them' }}">
    {% if m.kind == "text" %}
      <div class="small-muted mb-1">{{ m.sender }}</div>
      {{ m.body }}
    {% else %}
      <div class="small-muted mb-1">{{ m.sender }} • Voice</div>
      <audio controls preload="metadata" style="width:100%">
        <source src="{{ url_for('group_voice_stream', vid=m.voice_id) }}" type="{{ m.voice_mime }}">
      </audio>
    {% endif %}
  </div>
  <div class="msg-meta {{ 'text-end' if m.sender==me else '' }}"><span class="ts" data-utc="{{ m.created_at_utc }}">{{ m.created_at_local }}</span></div>
</div>
"""


def _render_dm_row_html(m: Dict[str, Any], me: str) -> str:
    """Render one DM message row to HTML for AJAX updates."""
    return render_template_string(_DM_ROW_TEMPLATE, m=m, me=me)


@app.route("/chat/<username>/send", methods=["POST"])
@login_required
def dm_send(username: str):
    """Send a DM message (text, file, GIF, and/or voice).

    Important stability notes:
      - The message and its attachments are committed atomically (single DB transaction),
        so other clients never see a "blank" placeholder that requires refresh.