@meith/plugin-dues 0.7.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meith/plugin-dues",
-  "version": "0.7.0",
+  "version": "0.8.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,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@meith/plugin-kit": "^0.7.0"
+    "@meith/plugin-kit": "^0.8.0",
+    "@meith/theme-kit": "^0.8.0"
   },
   "peerDependencies": {
     "react": "^19.2.0"

package/src/config.ts

@@ -1,5 +1,5 @@
 import { isCurrencyCode, isValidMinorAmount } from './money'
-import { parsePeriod, periodCeilingDays, type Period } from './period'
+import { type Period, parsePeriod, periodCeilingDays } from './period'
 
 export interface DuesPlanInput {
   readonly key: string
@@ -114,9 +114,7 @@ export function parseDuesConfig(input: DuesConfigInput): DuesConfig {
 
     const parsed = parsePeriod(plan.billing.period)
     if (parsed === null) {
-      refuse(
-        `${where}: "${plan.billing.period}" is not an ISO-8601 period like P90D, P1M or P1Y.`,
-      )
+      refuse(`${where}: "${plan.billing.period}" is not an ISO-8601 period like P90D, P1M or P1Y.`)
     }
     if (periodCeilingDays(parsed) + graceDays > MAX_GRANTABLE_DAYS) {
       refuse(

package/src/definition.tsx

@@ -1,14 +1,20 @@
-import { definePlugin, type PluginDefinition, type PluginRequest, type PluginResponse, type PluginRuntimeContext } from '@meith/plugin-kit'
+import {
+  definePlugin,
+  type PluginDefinition,
+  type PluginRequest,
+  type PluginResponse,
+  type PluginRuntimeContext,
+} from '@meith/plugin-kit'
 
-import { parseDuesConfig, type DuesConfigInput } from './config'
+import { type DuesConfigInput, parseDuesConfig } from './config'
 import {
   buildServices,
+  type DuesServices,
   entitlementDeps,
   handleCancel,
   handleCheckout,
   handlePortal,
   handleWebhook,
-  type DuesServices,
 } from './handlers'
 import {
   handleAdminCancel,
@@ -21,6 +27,7 @@ import {
   handleAdminPlanUpdate,
   handleAdminRevoke,
 } from './handlers-admin'
+import en from './messages/en.json'
 import { DUES_MIGRATIONS } from './schema'
 import { runReconcile, runSweep } from './tasks'
 import { CodesPage, LedgerPage, MembersPage, PlansAdminPage, StatusPage } from './ui/admin'
@@ -39,49 +46,53 @@ export function dues(input: DuesConfigInput): PluginDefinition {
   return definePlugin({
     key: 'dues',
     name: 'Dues',
-    version: '0.7.0',
-    description:
-      `Sells ${config.label.toLowerCase()} — time-limited membership of a group — ` +
-      'through Stripe, for yourself or as a gift.',
+    version: '0.8.0',
+    description: en['dues.definition.description'].replace('{label}', config.label.toLowerCase()),
+    descriptionKey: 'dues.definition.description',
+    descriptionArgs: { label: config.label.toLowerCase() },
     apiVersion: '0',
 
     settings: [
       {
         key: 'stripe_secret_key',
-        label: 'Stripe secret key',
+        label: en['dues.definition.setting.secret.label'],
+        labelKey: 'dues.definition.setting.secret.label',
         type: 'secret',
         env: 'DUES_STRIPE_SECRET_KEY',
         required: true,
         default: '',
-        description: 'The sk_live_… or sk_test_… key from the Stripe dashboard.',
+        description: en['dues.definition.setting.secret.description'],
+        descriptionKey: 'dues.definition.setting.secret.description',
       },
       {
         key: 'stripe_webhook_secret',
-        label: 'Webhook signing secret',
+        label: en['dues.definition.setting.webhook.label'],
+        labelKey: 'dues.definition.setting.webhook.label',
         type: 'secret',
         env: 'DUES_STRIPE_WEBHOOK_SECRET',
         required: true,
         default: '',
-        description:
-          'The whsec_… secret of the webhook endpoint. Without it, payments are taken ' +
-          'but can never confirm.',
+        description: en['dues.definition.setting.webhook.description'],
+        descriptionKey: 'dues.definition.setting.webhook.description',
       },
       {
         key: 'stripe_api_version',
-        label: 'Stripe API version',
+        label: en['dues.definition.setting.apiVersion.label'],
+        labelKey: 'dues.definition.setting.apiVersion.label',
         default: '2024-12-18.acacia',
         advanced: true,
-        description:
-          'Pinned so Stripe’s payload shapes change on a deploy, not on a Tuesday. ' +
-          'Change it only alongside a plugin upgrade that expects the new shapes.',
+        description: en['dues.definition.setting.apiVersion.description'],
+        descriptionKey: 'dues.definition.setting.apiVersion.description',
       },
       {
         key: 'stripe_api_base',
-        label: 'Stripe API address',
+        label: en['dues.definition.setting.apiBase.label'],
+        labelKey: 'dues.definition.setting.apiBase.label',
         env: 'DUES_STRIPE_API_BASE',
         default: 'https://api.stripe.com',
         advanced: true,
-        description: 'Only a stripe-mock or a test double ever changes this.',
+        description: en['dues.definition.setting.apiBase.description'],
+        descriptionKey: 'dues.definition.setting.apiBase.description',
       },
     ],
 
@@ -95,7 +106,10 @@ export function dues(input: DuesConfigInput): PluginDefinition {
           const services = buildServices(config, context)
           const result = await runReconcile(entitlementDeps(services), services.stripe)
           if (
-            result.ordersSettled + result.ordersClosed + result.eventsReplayed + result.subscriptionsCorrected >
+            result.ordersSettled +
+              result.ordersClosed +
+              result.eventsReplayed +
+              result.subscriptionsCorrected >
             0
           ) {
             context.logger.info('dues: reconciled', { ...result })
@@ -116,13 +130,17 @@ export function dues(input: DuesConfigInput): PluginDefinition {
     notifications: [
       {
         key: 'gift_received',
-        title: 'Somebody gifts you a membership',
-        description: 'A member bought a membership in your name. It starts the moment the payment confirms.',
+        title: en['dues.definition.notification.gift.title'],
+        titleKey: 'dues.definition.notification.gift.title',
+        description: en['dues.definition.notification.gift.description'],
+        descriptionKey: 'dues.definition.notification.gift.description',
       },
       {
         key: 'renewal_trouble',
-        title: 'A membership payment fails',
-        description: 'A renewal did not go through. Access holds during the grace window while Stripe retries.',
+        title: en['dues.definition.notification.renewal.title'],
+        titleKey: 'dues.definition.notification.renewal.title',
+        description: en['dues.definition.notification.renewal.description'],
+        descriptionKey: 'dues.definition.notification.renewal.description',
       },
     ],
 
@@ -221,19 +239,23 @@ export function dues(input: DuesConfigInput): PluginDefinition {
       },
       {
         path: 'return',
-        title: 'Confirming your payment',
+        title: en['dues.definition.page.return'],
+        titleKey: 'dues.definition.page.return',
         access: 'member',
         render: (context) => ReturnPage({ config, context }),
       },
       {
         path: 'manage',
-        title: `Your ${config.label.toLowerCase()}`,
+        title: en['dues.definition.manage'].replace('{label}', config.label.toLowerCase()),
+        titleKey: 'dues.definition.manage',
+        titleArgs: { label: config.label.toLowerCase() },
         access: 'member',
         render: (context) => ManagePage({ config, context }),
       },
       {
         path: 'go',
-        title: 'Over to Stripe',
+        title: en['dues.definition.go'],
+        titleKey: 'dues.definition.go',
         access: 'member',
         render: (context) =>
           GoPage({
@@ -251,27 +273,32 @@ export function dues(input: DuesConfigInput): PluginDefinition {
     adminPages: [
       {
         path: 'status',
-        title: 'Status',
+        title: en['dues.definition.page.status'],
+        titleKey: 'dues.definition.page.status',
         render: (context) => StatusPage({ config, context }),
       },
       {
         path: 'plans',
-        title: 'Plans',
+        title: en['dues.definition.page.plans'],
+        titleKey: 'dues.definition.page.plans',
         render: (context) => PlansAdminPage({ config, context }),
       },
       {
         path: 'members',
-        title: 'Memberships',
+        title: en['dues.definition.page.members'],
+        titleKey: 'dues.definition.page.members',
         render: (context) => MembersPage({ context }),
       },
       {
         path: 'codes',
-        title: 'Discount codes',
+        title: en['dues.definition.page.codes'],
+        titleKey: 'dues.definition.page.codes',
         render: (context) => CodesPage({ config, context }),
       },
       {
         path: 'ledger',
-        title: 'Ledger',
+        title: en['dues.definition.page.ledger'],
+        titleKey: 'dues.definition.page.ledger',
         render: (context) => LedgerPage({ config, context }),
       },
     ],

package/src/demo.ts

@@ -1,26 +1,26 @@
 import type { PluginData, PluginGrants, PluginNotify } from '@meith/plugin-kit'
 
 import { discountedPrice } from './codes'
-import { parseDuesConfig, type DuesConfig } from './config'
-import { applyInternalEvent, settlePaidOrder, type EntitlementDeps } from './entitlement'
+import { type DuesConfig, parseDuesConfig } from './config'
+import { applyInternalEvent, type EntitlementDeps, settlePaidOrder } from './entitlement'
 import { addDays } from './period'
 import {
   attachCheckoutSession,
+  type CodeRow,
   insertCode,
   insertOrder,
   insertPlan,
   markEventProcessed,
+  type NewPlan,
+  type OrderRow,
+  type PlanRow,
   planRowByKey,
   recordEvent,
   setCodeDisabled,
   setPlanArchived,
   settleOrder,
-  type CodeRow,
-  type NewPlan,
-  type OrderRow,
-  type PlanRow,
 } from './store'
-import { toInternalEvent, type StripeEventEnvelope } from './stripe/events'
+import { type StripeEventEnvelope, toInternalEvent } from './stripe/events'
 
 export const DUES_DEMO_GROUP = 'supporters'
 

package/src/entitlement.ts

@@ -1,4 +1,4 @@
-import type { PluginGrants, PluginData, PluginNotify } from '@meith/plugin-kit'
+import type { PluginData, PluginGrants, PluginNotify } from '@meith/plugin-kit'
 
 import type { DuesConfig } from './config'
 import { moneyMatches } from './money'
@@ -11,15 +11,15 @@ import {
   insertLedger,
   insertMembership,
   liveMembership,
+  type MembershipRow,
   membershipBySubscription,
+  type OrderRow,
   orderByPaymentIntent,
   orderBySessionId,
+  type PlanRow,
   planRowByKey,
   setMembershipStatus,
   settleOrder,
-  type MembershipRow,
-  type OrderRow,
-  type PlanRow,
 } from './store'
 import type { InternalEvent } from './stripe/events'
 
@@ -48,9 +48,7 @@ async function tryNotify(
 
 function grantReason(order: OrderRow): string {
   const gift =
-    order.buyerUserId === order.recipientUserId
-      ? ''
-      : `, a gift from user ${order.buyerUserId}`
+    order.buyerUserId === order.recipientUserId ? '' : `, a gift from user ${order.buyerUserId}`
   return `dues order ${order.id}: ${order.planName}${gift}`
 }
 
@@ -69,10 +67,15 @@ export async function settlePaidOrder(
   if (order.status === 'paid') return 'already-settled'
   if (order.status === 'failed' || order.status === 'cancelled') return `order-${order.status}`
 
-  if (!moneyMatches({ amountMinor: order.amountMinor, currency: order.currency }, {
-    amountMinor: info.amountTotal,
-    currency: info.currency,
-  })) {
+  if (
+    !moneyMatches(
+      { amountMinor: order.amountMinor, currency: order.currency },
+      {
+        amountMinor: info.amountTotal,
+        currency: info.currency,
+      },
+    )
+  ) {
     await settleOrder(deps.data, order.id, {
       status: 'pending',
       needsAttention:
@@ -160,8 +163,9 @@ export async function settlePaidOrder(
     await tryNotify(deps, {
       userId: order.recipientUserId,
       kind: 'gift_received',
-      subject: `Somebody bought you ${order.planName}`,
-      body: 'It starts this moment — nothing to claim, nothing to do.',
+      subjectKey: 'dues.notification.gift.subject',
+      subjectArgs: { plan: order.planName },
+      bodyKey: 'dues.notification.gift.body',
       href: '/plugins/dues/manage',
       dedupeKey: `gift:${order.id}`,
     })
@@ -179,7 +183,8 @@ function settledPeriodEnd(
   if (order.billingMode === 'lifetime') return LIFETIME_END
 
   if (order.billingMode === 'fixed') {
-    const base = existing !== null && existing.currentPeriodEnd > now ? existing.currentPeriodEnd : now
+    const base =
+      existing !== null && existing.currentPeriodEnd > now ? existing.currentPeriodEnd : now
     if (isLifetime(base)) return LIFETIME_END
     const parsed =
       (plan?.periodSpec !== null && plan?.periodSpec !== undefined
@@ -240,8 +245,7 @@ export async function applyInternalEvent(
       }
       if (event.billingReason === 'subscription_create') return 'covered-by-checkout'
 
-      const periodEnd =
-        event.periodEnd ?? addBillingInterval(membership.currentPeriodEnd, 'month')
+      const periodEnd = event.periodEnd ?? addBillingInterval(membership.currentPeriodEnd, 'month')
       const graceUntil = addDays(periodEnd, deps.config.graceDays)
 
       await extendMembership(deps.data, membership.id, {
@@ -287,10 +291,8 @@ export async function applyInternalEvent(
         await tryNotify(deps, {
           userId: membership.userId,
           kind: 'renewal_trouble',
-          subject: 'A membership payment did not go through',
-          body:
-            'Stripe retries on its own. Your access holds during the grace window, ' +
-            'and updating your card from the manage page usually settles it.',
+          subjectKey: 'dues.notification.renewal.subject',
+          bodyKey: 'dues.notification.renewal.body',
           href: '/plugins/dues/manage',
           dedupeKey: `grace:${membership.id}`,
         })
@@ -333,11 +335,7 @@ export async function applyInternalEvent(
       const order = await orderByPaymentIntent(deps.data, event.paymentIntentId)
       if (order === null) return 'unmatched-reversal'
 
-      const membership = await liveMembership(
-        deps.data,
-        order.recipientUserId,
-        order.groupKey,
-      )
+      const membership = await liveMembership(deps.data, order.recipientUserId, order.groupKey)
       if (membership !== null) {
         await setMembershipStatus(deps.data, membership.id, 'revoked')
         try {

package/src/handlers-admin.ts

@@ -1,9 +1,9 @@
 import type { PluginRequest, PluginResponse } from '@meith/plugin-kit'
 
 import { generateCode, normalizeCode, validCodeShape } from './codes'
-import { anyPlanByKey, clampGrantUntil, isLifetime, parsePlanForm } from './plans'
-import { addDays } from './period'
 import type { DuesServices } from './handlers'
+import { addDays } from './period'
+import { anyPlanByKey, clampGrantUntil, isLifetime, parsePlanForm } from './plans'
 import {
   clearMembershipAttention,
   clearOrderAttention,
@@ -12,6 +12,7 @@ import {
   flagMembership,
   insertCode,
   insertPlan,
+  type MembershipRow,
   membershipById,
   orderById,
   planRowById,
@@ -20,7 +21,6 @@ import {
   setPlanArchived,
   setPlanStripePrice,
   updatePlan,
-  type MembershipRow,
 } from './store'
 
 function toAdmin(

package/src/handlers.ts

@@ -1,29 +1,25 @@
-import type {
-  PluginRequest,
-  PluginResponse,
-  PluginRuntimeContext,
-} from '@meith/plugin-kit'
+import type { PluginRequest, PluginResponse, PluginRuntimeContext } from '@meith/plugin-kit'
 
 import { codeProblem, discountedPrice, normalizeCode } from './codes'
 import type { DuesConfig } from './config'
+import { applyInternalEvent, type EntitlementDeps, settlePaidOrder } from './entitlement'
 import { isLifetime, sellablePlanByKey } from './plans'
-import { applyInternalEvent, settlePaidOrder, type EntitlementDeps } from './entitlement'
 import {
   attachCheckoutSession,
+  type CodeRow,
   codeByCode,
   findStripeCustomer,
   insertOrder,
   liveMembership,
-  membershipById,
-  recordEvent,
   markEventFailed,
   markEventProcessed,
+  membershipById,
+  recordEvent,
   saveCodeCoupon,
   saveStripeCustomer,
   setMembershipStatus,
-  type CodeRow,
 } from './store'
-import { createStripeClient, StripeError, type StripeClient } from './stripe/client'
+import { createStripeClient, type StripeClient, StripeError } from './stripe/client'
 import { parseEventEnvelope, toInternalEvent } from './stripe/events'
 import { verifyStripeSignature } from './stripe/webhook'
 
@@ -151,8 +147,7 @@ export async function handleCheckout(
     if (problem !== null) return back({ error: `code-${problem}`, ...bounce })
   }
 
-  const charge =
-    code === null ? plan.priceMinor : discountedPrice(plan.priceMinor, code.percentOff)
+  const charge = code === null ? plan.priceMinor : discountedPrice(plan.priceMinor, code.percentOff)
 
   if (services.stripe === null && (plan.mode === 'auto' || charge > 0)) {
     return back({ error: 'unconfigured' })

package/src/index.ts

@@ -1,9 +1,5 @@
-export { dues } from './definition'
 export type { DuesConfigInput, DuesPlanInput } from './config'
-
-export { SUBSCRIBED_EVENT_TYPES } from './stripe/events'
-export { signStripePayload } from './stripe/webhook'
-
+export { dues } from './definition'
 export {
   DUES_DEMO_CODES,
   DUES_DEMO_CURRENCY,
@@ -11,8 +7,11 @@ export {
   DUES_DEMO_GROUP,
   DUES_DEMO_PLANS,
   DUES_DEMO_PRICES,
-  seedDuesDemo,
   type DuesDemoCast,
   type DuesDemoDeps,
   type DuesDemoSummary,
+  seedDuesDemo,
 } from './demo'
+export { duesMessages } from './messages'
+export { SUBSCRIBED_EVENT_TYPES } from './stripe/events'
+export { signStripePayload } from './stripe/webhook'