{% extends "base.html" %}
{% block title %}
    Dataset
{% endblock title %}
{% block content %}
    <main>
        <h1>Dataset Backups</h1>
        <section>
            <h2>About this dataset</h2>
            <p>This site tracks and publishes open Twitch and Kick drop campaign data.</p>
            <p>
                Campaign metadata in the downloadable datasets and public JSON API is released under
                <strong>CC0</strong> so you can reuse it freely. The underlying source data is scraped from Twitch/Kick
                APIs and pages, so we do not control the upstream content and cannot guarantee upstream accuracy or
                permanence. Linked third-party images, logos, and trademarks may remain subject to separate rights.
            </p>
            <p>Note that some drops has missing or incomplete data due to Twitch API limitations.</p>
            <p>
                Reward campaign data is sourced from
                <a href="https://github.com/SunkwiBOT/twitch-drops-api">SunkwiBOT/twitch-drops-api</a>.
                Raw JSON exports are available in the repository:
                <a href="https://github.com/SunkwiBOT/twitch-drops-api/blob/main/drops.json">drops.json</a>
                and
                <a href="https://github.com/SunkwiBOT/twitch-drops-api/blob/main/rewards.json">rewards.json</a>.
            </p>
            <p>
                Need a special format for your workflow or research pipeline?
                <a href="https://github.com/TheLovinator1/ttvdrops/issues">Contact me via GitHub issues</a>
                and describe what you need.
            </p>
        </section>
        <section>
            <h2>Kick JSON API</h2>
            <p>
                Fully imported Kick campaigns are also available through the public, paginated
                <a href="{% url 'kick:campaign_api_list' %}">Kick campaign JSON API</a>.
                Responses include campaign dates, game and organization metadata, rewards, and the complete
                channel list stored for each campaign.
            </p>
            <p>
                Use <code>page</code> and <code>page_size</code> for pagination. Filter by Kick category ID with
                <code>game</code>, or by the computed campaign state with
                <code>status=active</code>, <code>status=upcoming</code>, or <code>status=expired</code>.
                Page numbers and page sizes have a minimum of 1, and the maximum page size is 500.
            </p>
            <pre><code>{
  "total": 1,
  "page": 1,
  "page_size": 100,
  "items": [{
    "kick_id": "...",
    "name": "...",
    "status": "active",
    "starts_at": "2026-07-01T00:00:00Z",
    "ends_at": "2026-08-01T00:00:00Z",
    "category": { "kick_id": 123, "name": "..." },
    "organization": { "kick_id": "...", "name": "..." },
    "channels": [],
    "rewards": [{ "name": "...", "required_minutes_watched": 30 }]
  }]
}</code></pre>
            <p>
                Timestamps use ISO 8601 in UTC and may be <code>null</code> when the source lacks a date. Campaigns with
                incomplete dates have the computed status <code>unknown</code> and are not returned by a status filter.
                Each item includes every stored channel and raw reward without RSS truncation or reward-name merging.
                Consumers can stop pagination when <code>items</code> is empty or when
                <code>page * page_size &gt;= total</code>.
            </p>
            <p>
                An empty <code>channels</code> list means that no channel restriction data is stored. It does not,
                by itself, guarantee that a campaign is available on every channel.
            </p>
        </section>
        {% if datasets %}
            <table>
                <thead>
                    <tr>
                        <th>Name</th>
                        <th>Size</th>
                        <th>Updated</th>
                    </tr>
                </thead>
                <tbody>
                    {% for dataset in datasets %}
                        <tr>
                            <td>
                                <a href="{% url 'core:dataset_backup_download' dataset.download_path %}">{{ dataset.name }}</a>
                            </td>
                            <td>{{ dataset.size }}</td>
                            <td>
                                <time datetime="{{ dataset.updated_at|date:'c' }}"
                                      title="{{ dataset.updated_at|date:'DATETIME_FORMAT' }}">
                                    {{ dataset.updated_at|timesince }} ago ({{ dataset.updated_at|date:'M d, Y H:i' }})
                                </time>
                            </td>
                        </tr>
                    {% endfor %}
                </tbody>
            </table>
            <p>Found {{ dataset_count }} datasets.</p>
        {% else %}
            <p>No dataset backups found.</p>
        {% endif %}
    </main>
{% endblock content %}