mirror of
https://github.com/rmdes/indiekit-endpoint-donation.git
synced 2026-08-25 03:35:11 +00:00
No description
- JavaScript 81.4%
- Nunjucks 18.6%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Ricardo
7492848232
- get blocks(): donation-campaign entry (source:api, bespoke, main region, homepage/standalone, multiple; config: campaignId picker + title) - stats.json + stats/:campaignId.json moved from admin routes to routesPublic (spec: block fetches client-side), rate-limited 60/min/IP - security-review hardening: dropped per-donation records from the public payload (aggregates only); byCampaign 404s hidden/unknown campaigns; opaque 500s instead of the stack-including core error handler; 30s in-process payload cache; trustProxy validation silenced (topology reviewed) - tests: block contract + sanitization/route-placement regressions |
||
| lib | ||
| locales | ||
| tests | ||
| views | ||
| .gitignore | ||
| CLAUDE.md | ||
| index.js | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
@rmdes/indiekit-endpoint-donation
Stripe-backed donation endpoint for Indiekit. Treats Stripe Products as campaigns, Stripe Checkout Sessions / PaymentIntents as donations, captures donor consent via Stripe Payment Link custom fields, and feeds a static Eleventy site with live JSON + rebuild triggers.
Status
Alpha. Scaffold implemented with routes, views, webhook verification, sync scheduling, and MongoDB storage. Deployed on chardonsbleus (see package.json for version). See CLAUDE.md for architecture, data model, and routes.
Maturity note: Version 0.1.0-alpha.x — API may shift before 1.0.0.
Install
npm install @rmdes/indiekit-endpoint-donation stripe
// indiekit.config.js
import DonationEndpoint from "@rmdes/indiekit-endpoint-donation";
export default {
plugins: [
"@indiekit/endpoint-auth",
new DonationEndpoint({
mountPath: "/donation",
// siteDir + rebuildTrigger usually picked up from env vars
}),
// ...
],
};
Environment
STRIPE_SECRET_KEY=sk_live_…
STRIPE_WEBHOOK_SECRET=whsec_…
INDIEKIT_DONATION_SITE_DIR=/app/data/eleventy-site
INDIEKIT_DONATION_REBUILD_TRIGGER=/app/data/eleventy-site/.rebuild-trigger
INDIEKIT_DONATION_CURRENCY=EUR
Stripe setup (one-time)
- Create a Product per campaign in Stripe Dashboard. Set product
metadata:
goal_cents,subtitle,campaign_starts,campaign_ends,display_order. - Create a Payment Link for each Product. Add 3 custom fields:
consent— dropdown: "Oui, avec mon nom" / "Oui, anonymement" / "Non, garder privé" (required)display_name— text, optional (≤60 chars)message— text, optional (≤200 chars)
- Create a Webhook endpoint in Stripe pointing at
https://yoursite.example/donation/webhook. Subscribe to:checkout.session.completedcheckout.session.async_payment_succeededinvoice.paidcharge.refunded
- Copy the webhook signing secret (
whsec_…) intoSTRIPE_WEBHOOK_SECRET.
Admin UI
/donation— dashboard (lifetime stats, recent donations, active campaigns)/donation/donations— full donation list with filters/donation/donations/:id— edit a single donation (display name, message, consent)/donation/campaigns— cached campaign list (synced from Stripe)/donation/manual— record an offline donation (cash, bank transfer)POST /donation/sync— trigger an immediate Stripe Product syncPOST /donation/rebuild— touch the rebuild trigger file
Public API
GET /donation/stats.json— full live state (campaigns + recent donations, donor names hidden if consent is false). Cache-Control: 60s.GET /donation/stats/:campaignId.json— single-campaign totals.POST /donation/webhook— Stripe webhook receiver (rejects without signature).
Plugin Origin
ORIGINAL plugin — no upstream @indiekit/* equivalent. Developed for chardonsbleus fundraising campaigns.
Registry status: Endpoints tier in indiekit-cloudron — optional, deployed only on chardonsbleus.
License
MIT