@rmdes/indiekit-endpoint-donation 0.1.0-alpha.1

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@rmdes/indiekit-endpoint-donation",
+  "version": "0.1.0-alpha.1",
+  "description": "Stripe-backed donation endpoint for Indiekit. Treats Stripe Products as campaigns, PaymentIntents/Checkout Sessions as donations, exposes admin UI + public stats API + rebuild trigger.",
+  "keywords": [
+    "indiekit",
+    "indiekit-plugin",
+    "indieweb",
+    "stripe",
+    "donations",
+    "fundraising"
+  ],
+  "homepage": "https://github.com/rmdes/indiekit-endpoint-donation",
+  "author": {
+    "name": "Ricardo Mendes",
+    "url": "https://rmendes.net"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "type": "module",
+  "main": "index.js",
+  "files": [
+    "lib",
+    "views",
+    "locales",
+    "assets",
+    "index.js"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rmdes/indiekit-endpoint-donation.git"
+  },
+  "dependencies": {
+    "@indiekit/error": "^1.0.0-beta.27",
+    "@indiekit/frontend": "^1.0.0-beta.27",
+    "@rmdes/indiekit-startup-gate": "^1.0.0",
+    "express": "^5.0.0",
+    "stripe": "^17.0.0"
+  },
+  "peerDependencies": {
+    "@indiekit/indiekit": ">=1.0.0-beta.25"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/views/donation-campaign-edit.njk

@@ -0,0 +1,33 @@
+{% extends "layouts/donation.njk" %}
+
+{% block donation %}
+  {% call section({ title: campaign.title }) %}
+    <dl>
+      <dt>Stripe Product ID</dt><dd><code>{{ campaign.stripe_product_id }}</code></dd>
+      <dt>Sous-titre</dt><dd>{{ campaign.subtitle }}</dd>
+      <dt>{{ __("donation.campaigns.goal") }}</dt><dd>{% if campaign.goal_cents %}{{ (campaign.goal_cents / 100) | round(0) }} €{% else %}—{% endif %}</dd>
+      <dt>{{ __("donation.campaigns.raised") }}</dt><dd><strong>{{ (campaign.raised_cents / 100) | round(0) }} €</strong></dd>
+      <dt>{{ __("donation.campaigns.donors") }}</dt><dd>{{ campaign.donor_count }}</dd>
+      <dt>{{ __("donation.stats.last_sync") }}</dt><dd>{{ campaign.last_synced_at | date("PPpp") }}</dd>
+    </dl>
+  {% endcall %}
+
+  {% call section({ title: "Réglages locaux" }) %}
+    <p class="hint">
+      Ces réglages restent locaux à Indiekit (non envoyés à Stripe).
+      Pour modifier le titre, l'objectif ou les dates, éditer le Produit
+      directement dans Stripe Dashboard puis cliquer « Synchroniser ».
+    </p>
+    <form method="post" action="{{ baseUrl }}/campaigns/{{ campaign.stripe_product_id }}/edit">
+      <label>
+        <input name="hidden_on_public" type="checkbox" {% if campaign.hidden_on_public %}checked{% endif %}>
+        {{ __("donation.campaigns.hidden_on_public") }}
+      </label>
+      <label>
+        Ordre d'affichage
+        <input name="display_order" type="number" value="{{ campaign.display_order or 100 }}">
+      </label>
+      {{ button({ type: "submit", text: __("donation.save") }) }}
+    </form>
+  {% endcall %}
+{% endblock %}

package/views/donation-campaigns.njk

@@ -0,0 +1,24 @@
+{% extends "layouts/donation.njk" %}
+
+{% block donation %}
+  {% call section({ title: title }) %}
+    <p class="hint">{{ __("donation.campaigns.synced_from_stripe") }}.</p>
+    <table class="donation-table">
+      <thead>
+        <tr><th>Titre</th><th>État</th><th>{{ __("donation.campaigns.raised") }}</th><th>{{ __("donation.campaigns.goal") }}</th><th>{{ __("donation.campaigns.donors") }}</th><th></th></tr>
+      </thead>
+      <tbody>
+        {% for c in campaigns %}
+        <tr>
+          <td><strong>{{ c.title }}</strong></td>
+          <td>{% if c.active %}{{ __("donation.campaigns.active") }}{% else %}{{ __("donation.campaigns.archived") }}{% endif %}</td>
+          <td>{{ (c.raised_cents / 100) | round(0) }} €</td>
+          <td>{% if c.goal_cents %}{{ (c.goal_cents / 100) | round(0) }} €{% else %}—{% endif %}</td>
+          <td>{{ c.donor_count }}</td>
+          <td>{{ button({ href: baseUrl + "/campaigns/" + c.stripe_product_id, text: __("donation.edit"), classes: "button--small" }) }}</td>
+        </tr>
+        {% endfor %}
+      </tbody>
+    </table>
+  {% endcall %}
+{% endblock %}

package/views/donation-dashboard.njk

@@ -0,0 +1,100 @@
+{% extends "layouts/donation.njk" %}
+
+{% block donation %}
+
+  {% call section({ title: __("donation.stats.title") }) %}
+    <dl class="donation-stats">
+      <div class="donation-stat">
+        <dt>{{ __("donation.stats.lifetime_total") }}</dt>
+        <dd><strong>{{ (stats.lifetime_total_cents / 100) | round(0) }} €</strong></dd>
+      </div>
+      <div class="donation-stat">
+        <dt>{{ __("donation.stats.donation_count") }}</dt>
+        <dd>{{ stats.donation_count }}</dd>
+      </div>
+      <div class="donation-stat">
+        <dt>{{ __("donation.stats.donor_count") }}</dt>
+        <dd>{{ stats.donor_count }}</dd>
+      </div>
+      <div class="donation-stat">
+        <dt>{{ __("donation.stats.active_campaigns") }}</dt>
+        <dd>{{ stats.active_campaign_count }}</dd>
+      </div>
+    </dl>
+
+    <div class="donation-actions">
+      {{ button({ href: baseUrl + "/donations", text: __("donation.donations.title"), classes: "button--secondary" }) }}
+      {{ button({ href: baseUrl + "/campaigns", text: __("donation.campaigns.title"), classes: "button--secondary" }) }}
+      {{ button({ href: baseUrl + "/manual", text: __("donation.manual.action") }) }}
+    </div>
+  {% endcall %}
+
+  {% call section({ title: __("donation.actions.title") }) %}
+    <div class="donation-actions">
+      <form method="post" action="{{ baseUrl }}/sync" style="display: inline;">
+        {{ button({ type: "submit", text: __("donation.actions.sync_stripe"), classes: "button--secondary" }) }}
+      </form>
+      <form method="post" action="{{ baseUrl }}/rebuild" style="display: inline;">
+        {{ button({ type: "submit", text: __("donation.actions.trigger_rebuild"), classes: "button--secondary" }) }}
+      </form>
+    </div>
+  {% endcall %}
+
+  {% if activeCampaigns.length > 0 %}
+  {% call section({ title: __("donation.campaigns.active") }) %}
+    <ul class="donation-campaign-list">
+      {% for c in activeCampaigns %}
+      <li class="donation-campaign-row">
+        <a href="{{ baseUrl }}/campaigns/{{ c.stripe_product_id }}">
+          <strong>{{ c.title }}</strong>
+        </a>
+        <span class="donation-campaign-row__totals">
+          {{ (c.raised_cents / 100) | round(0) }} € / {{ (c.goal_cents / 100) | round(0) }} €
+          &middot; {{ c.donor_count }} {{ __("donation.campaigns.donors") | lower }}
+        </span>
+      </li>
+      {% endfor %}
+    </ul>
+  {% endcall %}
+  {% endif %}
+
+  {% call section({ title: __("donation.donations.title") + " — récents" }) %}
+    {% if recent.length == 0 %}
+      <p>{{ __("donation.donations.empty") }}</p>
+    {% else %}
+    <table class="donation-table">
+      <thead>
+        <tr>
+          <th>Date</th>
+          <th>Montant</th>
+          <th>Donateur</th>
+          <th>Campagne</th>
+          <th>Source</th>
+          <th></th>
+        </tr>
+      </thead>
+      <tbody>
+        {% for d in recent %}
+        <tr>
+          <td>{{ d.date | date("PPpp") }}</td>
+          <td>{{ (d.amount_cents / 100) | round(0) }} {{ d.currency }}</td>
+          <td>
+            {% if d.donor.consent_public and d.donor.display %}
+              {{ d.donor.display }}
+            {% elif d.donor.consent_public %}
+              <em>Anonyme</em>
+            {% else %}
+              <em>Masqué</em>
+            {% endif %}
+          </td>
+          <td>{{ d.campaign_id }}</td>
+          <td><code>{{ d.source }}</code></td>
+          <td>{{ button({ href: baseUrl + "/donations/" + d.stripe_id, text: __("donation.edit"), classes: "button--small button--secondary" }) }}</td>
+        </tr>
+        {% endfor %}
+      </tbody>
+    </table>
+    {% endif %}
+  {% endcall %}
+
+{% endblock %}

package/views/donation-donation-edit.njk

@@ -0,0 +1,37 @@
+{% extends "layouts/donation.njk" %}
+
+{% block donation %}
+  {% call section({ title: donation.stripe_id }) %}
+    <dl>
+      <dt>Date</dt><dd>{{ donation.date | date("PPpp") }}</dd>
+      <dt>Montant</dt><dd>{{ (donation.amount_cents / 100) | round(0) }} {{ donation.currency }}</dd>
+      <dt>Campagne</dt><dd>{{ donation.campaign_id }}</dd>
+      <dt>Source</dt><dd><code>{{ donation.source }}</code></dd>
+    </dl>
+  {% endcall %}
+
+  {% call section({ title: "Donateur" }) %}
+    <form method="post" action="{{ baseUrl }}/donations/{{ donation.stripe_id }}/edit">
+      <label>
+        Nom affiché
+        <input name="display" type="text" value="{{ donation.donor.display or '' }}">
+      </label>
+      <label>
+        Message
+        <textarea name="message" rows="3">{{ donation.donor.message or '' }}</textarea>
+      </label>
+      <label>
+        <input name="consent_public" type="checkbox" {% if donation.donor.consent_public %}checked{% endif %}>
+        Afficher publiquement
+      </label>
+      {{ button({ type: "submit", text: __("donation.save") }) }}
+    </form>
+  {% endcall %}
+
+  {% call section({ title: "Actions" }) %}
+    <form method="post" action="{{ baseUrl }}/donations/{{ donation.stripe_id }}/delete"
+          onsubmit="return confirm('{{ __("donation.confirm") }}');" style="display: inline;">
+      {{ button({ type: "submit", text: __("donation.delete"), classes: "button--warning" }) }}
+    </form>
+  {% endcall %}
+{% endblock %}

package/views/donation-donations.njk

@@ -0,0 +1,29 @@
+{% extends "layouts/donation.njk" %}
+
+{% block donation %}
+  {% call section({ title: title }) %}
+    {# TODO: filter controls (campaign, source, date range) #}
+    <table class="donation-table">
+      <thead>
+        <tr>
+          <th>Date</th><th>Montant</th><th>Donateur</th><th>Campagne</th><th>Source</th><th>Consentement</th><th></th>
+        </tr>
+      </thead>
+      <tbody>
+        {% for d in donations %}
+        <tr>
+          <td>{{ d.date | date("yyyy-MM-dd HH:mm") }}</td>
+          <td>{{ (d.amount_cents / 100) | round(0) }} {{ d.currency }}</td>
+          <td>
+            {% if d.donor.display %}{{ d.donor.display }}{% else %}<em>Anonyme</em>{% endif %}
+          </td>
+          <td>{{ d.campaign_id }}</td>
+          <td><code>{{ d.source }}</code></td>
+          <td>{% if d.donor.consent_public %}{{ __("donation.consent.public") }}{% else %}{{ __("donation.consent.hidden") }}{% endif %}</td>
+          <td>{{ button({ href: baseUrl + "/donations/" + d.stripe_id, text: __("donation.edit"), classes: "button--small" }) }}</td>
+        </tr>
+        {% endfor %}
+      </tbody>
+    </table>
+  {% endcall %}
+{% endblock %}

package/views/donation-manual-error.njk

@@ -0,0 +1,8 @@
+{% extends "layouts/donation.njk" %}
+
+{% block donation %}
+  {% call section({ title: title }) %}
+    <p class="error">{{ message }}</p>
+    {{ button({ href: baseUrl + "/manual", text: __("donation.cancel"), classes: "button--secondary" }) }}
+  {% endcall %}
+{% endblock %}

package/views/donation-manual.njk

@@ -0,0 +1,45 @@
+{% extends "layouts/donation.njk" %}
+
+{% block donation %}
+  {% call section({ title: __("donation.manual.title") }) %}
+    <p class="hint">
+      Pour les dons reçus hors Stripe (virement bancaire, espèces lors d'un évènement, etc.).
+      Ces dons s'ajoutent aux statistiques publiques mais portent la source <code>manual</code>.
+    </p>
+    <form method="post" action="{{ baseUrl }}/manual">
+      <label>
+        {{ __("donation.manual.fields.amount") }}
+        <input name="amount" type="number" step="0.01" min="0.01" required>
+      </label>
+      <label>
+        {{ __("donation.manual.fields.campaign") }}
+        <select name="campaign_id" required>
+          {% for c in campaigns %}
+          <option value="{{ c.stripe_product_id }}">{{ c.title }}</option>
+          {% endfor %}
+        </select>
+      </label>
+      <label>
+        {{ __("donation.manual.fields.date") }}
+        <input name="date" type="date" required>
+      </label>
+      <label>
+        {{ __("donation.manual.fields.donor_display") }}
+        <input name="donor_display" type="text">
+      </label>
+      <label>
+        {{ __("donation.manual.fields.message") }}
+        <textarea name="message" rows="2"></textarea>
+      </label>
+      <label>
+        <input name="consent_public" type="checkbox" checked>
+        {{ __("donation.manual.fields.consent_public") }}
+      </label>
+      <label>
+        {{ __("donation.manual.fields.note") }}
+        <input name="note" type="text">
+      </label>
+      {{ button({ type: "submit", text: __("donation.manual.action") }) }}
+    </form>
+  {% endcall %}
+{% endblock %}

package/views/donation-not-found.njk

@@ -0,0 +1,8 @@
+{% extends "layouts/donation.njk" %}
+
+{% block donation %}
+  {% call section({ title: "Introuvable" }) %}
+    <p>Cette entrée n'existe pas ou a été supprimée.</p>
+    {{ button({ href: baseUrl, text: "Retour au tableau de bord", classes: "button--secondary" }) }}
+  {% endcall %}
+{% endblock %}

package/views/layouts/donation.njk

@@ -0,0 +1,14 @@
+{# Shared layout for all donation admin pages.
+   Extends indiekit's global admin layout — inheriting nav, auth chrome,
+   notification banners. The {% block donation %} child fills the body.
+#}
+{% extends "layouts/application.njk" %}
+
+{% block content %}
+  <header class="page-header">
+    <h1 class="page-header__heading">{{ title }}</h1>
+    {% if subtitle %}<p class="page-header__description">{{ subtitle }}</p>{% endif %}
+  </header>
+
+  {% block donation %}{% endblock %}
+{% endblock %}