@meith/plugin-dues 0.2.0 → 0.3.0

package/README.md

@@ -16,6 +16,14 @@ every guarantee that capability makes applies here. The load-bearing one:
 stop, or Stripe closes the account, every sold membership drains away at its
 own boundary and the board is left correct.
 
+**A purchase makes the plan's group the member's primary group**, and the group
+they were in — Registered, on most boards — becomes a secondary membership
+alongside it. So a member who buys shows as what they bought: its title, its
+colour, its badge. When the membership lapses or is revoked, the board hands
+the old primary group straight back. A member who would rather be shown as
+something else can pick any group they are in under UserCP → Profile; the
+choice is theirs, and it drops away with the membership it names.
+
 **Try it before you read any of this**: [demo.meith.dev](https://demo.meith.dev)
 runs this plugin against a Stripe that is not Stripe — a shop with a year of
 history behind it, and a checkout a visitor can actually go through. See
@@ -26,8 +34,9 @@ history behind it, and a checkout a visitor can actually go through. See
 1. **Register the plugin** where plugins are registered:
 
    ```ts
-   // apps/community/community.plugins.ts (this repository's board uses
-   // DUES_TEST_BOARD=1 to switch a test-shaped version of this on)
+   // apps/community/community.plugins.ts (this repository's own demo and
+   // test boards register their versions in community.demo.plugins.ts,
+   // behind DEMO_MODE and DUES_TEST_BOARD)
    import { dues } from '@meith/plugin-dues'
 
    export const INSTALLED_PLUGINS = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meith/plugin-dues",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Membership dues for a Meith board: Stripe-backed subscriptions as a contained plugin.",
   "license": "LGPL-3.0-or-later",
   "repository": {
@@ -20,7 +20,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@meith/plugin-kit": "^0.2.0"
+    "@meith/plugin-kit": "^0.3.0"
   },
   "peerDependencies": {
     "react": "^19.2.0"

package/src/entitlement.ts

@@ -121,6 +121,7 @@ export async function settlePaidOrder(
       groupKey: order.groupKey,
       until: clampGrantUntil(graceUntil, now),
       reason: grantReason(order),
+      primary: true,
     })
   } catch (error) {
     const reason = error instanceof Error ? error.message : String(error)
@@ -255,6 +256,7 @@ export async function applyInternalEvent(
           groupKey: membership.groupKey,
           until: clampGrantUntil(graceUntil, deps.now()),
           reason: `dues renewal of subscription ${event.subscriptionId}`,
+          primary: true,
         })
       } catch (error) {
         const reason = error instanceof Error ? error.message : String(error)