@meith/plugin-dues 0.2.0 → 0.3.1

package/README.md

@@ -16,6 +16,20 @@ 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.
+
+**Staff are the exception, and they are meant to be.** A moderator or
+administrator who buys gets the group and everything it carries, as a secondary
+membership — but their standing does not move, and they are still shown as
+staff. Selling a badge is fine; selling somebody out of the one that says who
+answers for the board is not.
+
 **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 +40,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.1",
   "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.1"
   },
   "peerDependencies": {
     "react": "^19.2.0"

package/src/definition.tsx

@@ -39,7 +39,7 @@ export function dues(input: DuesConfigInput): PluginDefinition {
   return definePlugin({
     key: 'dues',
     name: 'Dues',
-    version: '0.1.0',
+    version: '0.3.1',
     description:
       `Sells ${config.label.toLowerCase()} — time-limited membership of a group — ` +
       'through Stripe, for yourself or as a gift.',

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)

package/src/ui/admin.tsx

@@ -19,7 +19,12 @@ import {
 } from '../store'
 import { SUBSCRIBED_EVENT_TYPES } from '../stripe/events'
 
-const CARD = 'flex flex-col gap-3 rounded-lg border border-border p-4'
+const QUIET_PANEL =
+  'rounded-lg border border-border bg-card p-4 text-sm text-muted-foreground'
+
+const CARD =
+  'flex flex-col gap-3 rounded-lg border border-border bg-card p-4 text-card-foreground ' +
+  'shadow-elevation'
 const TH = 'px-2 py-1.5 text-left text-xs font-medium text-muted-foreground'
 const TD = 'px-2 py-1.5 align-top'
 const INPUT =
@@ -352,7 +357,7 @@ export async function MembersPage({ context }: { context: PluginAdminPageContext
         its own.
       </p>
       {memberships.length === 0 ? (
-        <p className="rounded-lg border border-border p-4 text-sm text-muted-foreground">
+        <p className={QUIET_PANEL}>
           Nothing sold yet.
         </p>
       ) : (

package/src/ui/pages.tsx

@@ -14,7 +14,12 @@ import {
   type PlanRow,
 } from '../store'
 
-const CARD = 'flex flex-col gap-3 rounded-lg border border-border p-4'
+const QUIET_PANEL =
+  'rounded-lg border border-border bg-card p-4 text-sm text-muted-foreground'
+
+const CARD =
+  'flex flex-col gap-3 rounded-lg border border-border bg-card p-4 text-card-foreground ' +
+  'shadow-elevation'
 const INPUT =
   'w-full rounded-md border border-border bg-background px-3 py-2 text-sm ' +
   'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring'
@@ -263,7 +268,7 @@ export async function PlansPage({
       <Notice query={context.query} />
       <HeldCard memberships={memberships} />
       {plans.length === 0 && (
-        <p className="rounded-lg border border-border p-4 text-sm text-muted-foreground">
+        <p className={QUIET_PANEL}>
           Nothing is on sale just now.
         </p>
       )}
@@ -311,7 +316,7 @@ export function GoPage({
 
   if (!allowed) {
     return (
-      <p className="rounded-lg border border-border p-4 text-sm text-muted-foreground">
+      <p className={QUIET_PANEL}>
         That is not somewhere this board sends people.{' '}
         <a href="/plugins/dues" className="font-medium underline underline-offset-2">
           Back to safety.
@@ -356,7 +361,7 @@ export async function ReturnPage({
     (order.buyerUserId !== viewerId && order.recipientUserId !== viewerId)
   ) {
     return (
-      <p className="rounded-lg border border-border p-4 text-sm text-muted-foreground">
+      <p className={QUIET_PANEL}>
         There is no order of yours here.{' '}
         <a href="/plugins/dues" className="font-medium underline underline-offset-2">
           Back to {config.label.toLowerCase()}
@@ -489,7 +494,7 @@ export async function ManagePage({
       )}
 
       {memberships.length === 0 ? (
-        <p className="rounded-lg border border-border p-4 text-sm text-muted-foreground">
+        <p className={QUIET_PANEL}>
           You hold no {config.label.toLowerCase()} yet.{' '}
           <a href="/plugins/dues" className="font-medium underline underline-offset-2">
             The plans are here.