@meith/plugin-dues 0.7.0 → 0.9.0

package/src/messages/en.json

@@ -0,0 +1,263 @@
+{
+  "dues.admin.codes.actions": "Actions",
+  "dues.admin.codes.any": "any",
+  "dues.admin.codes.anyPlan": "Any plan",
+  "dues.admin.codes.badCode": "Codes are 3 to 32 letters, digits and hyphens. Leave the box empty to have one invented.",
+  "dues.admin.codes.badExpiry": "The expiry needs to be a date in the future, like 2027-01-31.",
+  "dues.admin.codes.badMax": "The redemption cap is a whole number, at least 1 — or empty for no cap.",
+  "dues.admin.codes.badPercent": "The discount is a whole number from 1 to 100 percent.",
+  "dues.admin.codes.badPlan": "That plan does not exist on this board.",
+  "dues.admin.codes.code": "Code",
+  "dues.admin.codes.codeHelp": "Code — leave empty to have one invented",
+  "dues.admin.codes.created": "The code is live: {code} — hand it out however you like. It is shown in full below whenever you need it again.",
+  "dues.admin.codes.duplicate": "A code by that name already exists. Every code is unique, spelt any case.",
+  "dues.admin.codes.empty": "None yet.",
+  "dues.admin.codes.every": "Every code",
+  "dues.admin.codes.expired": "expired",
+  "dues.admin.codes.expires": "Expires",
+  "dues.admin.codes.expiresHelp": "Expires at end of day (UTC) — empty for never",
+  "dues.admin.codes.intro": "A code takes a percentage off at checkout: the whole price of a pass, the first payment of a subscription — renewals bill in full. A 100% code on a pass skips Stripe entirely, which is how you comp somebody.",
+  "dues.admin.codes.live": "live",
+  "dues.admin.codes.mint": "Mint a code",
+  "dues.admin.codes.mintButton": "Mint the code",
+  "dues.admin.codes.never": "never",
+  "dues.admin.codes.noSuch": "That code could not be found.",
+  "dues.admin.codes.off": "Off",
+  "dues.admin.codes.percentHelp": "Percent off, 1–100",
+  "dues.admin.codes.plan": "Plan",
+  "dues.admin.codes.planHelp": "Which plan it works on",
+  "dues.admin.codes.redeemed": "Redeemed",
+  "dues.admin.codes.redemptionCap": "Redemption cap — empty for unlimited",
+  "dues.admin.codes.redemptions": "Redemptions count when a payment settles, not when a checkout starts. A code is never deleted — switching it off keeps the history of what it sold.",
+  "dues.admin.codes.state": "State",
+  "dues.admin.codes.switchOff": "Switch off",
+  "dues.admin.codes.switchOn": "Switch on",
+  "dues.admin.codes.switchedOff": "switched off",
+  "dues.admin.codes.toggledOff": "{code} is switched off. Anyone typing it now is told the code is not usable.",
+  "dues.admin.codes.toggledOn": "{code} is back on.",
+  "dues.admin.codes.usedUp": "used up",
+  "dues.admin.ledger.appendOnly": "Append-only, written as money moves: charges positive, refunds and chargebacks negative. Stripe’s dashboard is the authority; this is the board’s own copy in {currency}.",
+  "dues.admin.ledger.byMonth": "By month",
+  "dues.admin.ledger.charges": "Charges",
+  "dues.admin.ledger.empty": "Empty.",
+  "dues.admin.ledger.gross": "Gross",
+  "dues.admin.ledger.latest": "Latest entries",
+  "dues.admin.ledger.month": "Month",
+  "dues.admin.ledger.noMoney": "No money has moved yet.",
+  "dues.admin.ledger.refunded": "Refunded",
+  "dues.admin.members.actions": "Actions",
+  "dues.admin.members.active": "active",
+  "dues.admin.members.badDays": "Extensions are 1 to 366 days.",
+  "dues.admin.members.cancel": "Cancel renewal",
+  "dues.admin.members.cancelled": "Renewal cancelled. They keep what they paid for until the period ends.",
+  "dues.admin.members.clear": "Clear the flag",
+  "dues.admin.members.cleared": "Flag cleared.",
+  "dues.admin.members.closing": "closing",
+  "dues.admin.members.description": "Every membership this plugin has sold, flagged rows first. Extending is a grant, not a charge; revoking removes access on the spot without touching the money — refunds happen in Stripe’s dashboard, and the refund webhook revokes on its own.",
+  "dues.admin.members.expired": "expired",
+  "dues.admin.members.extend": "Extend",
+  "dues.admin.members.extendAria": "Days to extend membership {id} by",
+  "dues.admin.members.extended": "Membership extended. The member holds their group until the new date.",
+  "dues.admin.members.forGood": "for good",
+  "dues.admin.members.grace": "grace",
+  "dues.admin.members.graceUntil": "Grace until",
+  "dues.admin.members.grantRefused": "The extension was recorded, but the board refused the group grant — the row is flagged with the reason.",
+  "dues.admin.members.member": "Member",
+  "dues.admin.members.noMembership": "That membership is not live any more, so there is nothing to act on.",
+  "dues.admin.members.noRenewal": "Only a live subscription has a renewal to cancel.",
+  "dues.admin.members.none": "Nothing sold yet.",
+  "dues.admin.members.periodEnds": "Period ends",
+  "dues.admin.members.plan": "Plan",
+  "dues.admin.members.revoke": "Revoke now",
+  "dues.admin.members.revoked": "Membership revoked. Their access is gone as of now.",
+  "dues.admin.members.revokedStatus": "revoked",
+  "dues.admin.members.status": "Status",
+  "dues.admin.members.stripeError": "Stripe could not be reached. Nothing changed — try again shortly.",
+  "dues.admin.members.stripeUnconfigured": "Stripe is not configured, so the subscription cannot be reached.",
+  "dues.admin.members.subscription": "Subscription",
+  "dues.admin.plans.add": "Add a plan",
+  "dues.admin.plans.addIntro": "A pass is one payment for a fixed stretch — a day to two years. A subscription renews by itself until cancelled. Lifetime is one payment, forever. The key is the plan’s permanent name in records and cannot be changed later; everything else can.",
+  "dues.admin.plans.archived": "{key} is off sale. Everyone who holds it keeps it — archiving stops new purchases, nothing else.",
+  "dues.admin.plans.autoGift": "A subscription cannot be giftable — it would bill the buyer forever.",
+  "dues.admin.plans.badCurrency": "The currency is a three-letter ISO code, like gbp, usd or eur.",
+  "dues.admin.plans.badGroup": "That is not a valid group key.",
+  "dues.admin.plans.badInterval": "A subscription bills every month or every year.",
+  "dues.admin.plans.badKey": "Plan keys are lower-case letters, digits and hyphens, like day-pass.",
+  "dues.admin.plans.badLength": "The length is a whole number of days, weeks, months or years — at least 1.",
+  "dues.admin.plans.badMode": "Pick how the plan bills.",
+  "dues.admin.plans.badName": "The plan needs a name members will read.",
+  "dues.admin.plans.badPrice": "The price is a positive whole number of minor units — 500 is £5.00.",
+  "dues.admin.plans.badStripePrice": "A pasted Stripe price id starts with price_.",
+  "dues.admin.plans.billing": "Billing against {price}",
+  "dues.admin.plans.bills": "How it bills",
+  "dues.admin.plans.canGift": "Can be bought for another member",
+  "dues.admin.plans.created": "The plan {key} is on sale from this moment.",
+  "dues.admin.plans.currency": "Currency",
+  "dues.admin.plans.days": "days",
+  "dues.admin.plans.description": "Description — optional",
+  "dues.admin.plans.duplicate": "A plan with that key already exists. Keys are forever; pick another.",
+  "dues.admin.plans.edit": "Edit this plan",
+  "dues.admin.plans.editing": "Every purchase snapshots its plan — the name, the price, the currency, the length — so editing here never rewrites what anyone already bought. A subscription price change mints a new Stripe price: running subscriptions keep billing what they signed up for, and only the next buyer sees the new number.",
+  "dues.admin.plans.fixed": "a pass — one payment, fixed length",
+  "dues.admin.plans.footer": "Pass length and billing interval apply to the mode that uses them; the others ignore them. A subscription needs Stripe configured, or a pasted price id.",
+  "dues.admin.plans.giftGroup": "Group it grants (marked plugin-grantable under Admin → Groups)",
+  "dues.admin.plans.hidden": "Hidden from the shop",
+  "dues.admin.plans.interval": "Subscription bills every",
+  "dues.admin.plans.key": "Key — permanent",
+  "dues.admin.plans.length": "Pass length",
+  "dues.admin.plans.lifetime": "lifetime — one payment, forever",
+  "dues.admin.plans.missingPrice": "no price yet — not buyable",
+  "dues.admin.plans.month": "month",
+  "dues.admin.plans.months": "months",
+  "dues.admin.plans.name": "Name",
+  "dues.admin.plans.noSuch": "That plan could not be found.",
+  "dues.admin.plans.offSale": "off sale",
+  "dues.admin.plans.onSale": "Put it on sale",
+  "dues.admin.plans.price": "Price in minor units — 500 is £5.00",
+  "dues.admin.plans.putBack": "Put it back on sale",
+  "dues.admin.plans.restored": "{key} is back on sale.",
+  "dues.admin.plans.save": "Save the plan",
+  "dues.admin.plans.stripeError": "Stripe could not be reached. Nothing was saved — try again shortly.",
+  "dues.admin.plans.stripePrice": "Stripe price id — leave empty and one is minted to match",
+  "dues.admin.plans.stripeUnconfigured": "Stripe is not configured, so a subscription price cannot be minted. Set the secret key first, or paste a price id made in the Stripe dashboard.",
+  "dues.admin.plans.subscription": "a subscription — renews itself",
+  "dues.admin.plans.takeOffSale": "Take it off sale",
+  "dues.admin.plans.thePlans": "The plans",
+  "dues.admin.plans.tooLong": "A pass plus its grace window cannot reach past two years ({days} days) — that is the board’s cap on a plugin grant. Sell lifetime instead.",
+  "dues.admin.plans.unit": "…counted in",
+  "dues.admin.plans.updated": "{key} is updated. Existing memberships and running subscriptions keep what they bought; the change is for the next buyer.",
+  "dues.admin.plans.weeks": "weeks",
+  "dues.admin.plans.year": "year",
+  "dues.admin.plans.years": "years",
+  "dues.admin.status.attention": "{count, plural, one {# record needs attention} other {# records need attention}} — a payment that could not become a membership, or an amount that did not match its order. The members screen lists {count, plural, one {it} other {them}} first.",
+  "dues.admin.status.billing": "Billing",
+  "dues.admin.status.clear": "Clear the flag",
+  "dues.admin.status.days": "{count, plural, one {# day} other {# days}}",
+  "dues.admin.status.done": "done",
+  "dues.admin.status.events": "Latest webhook events",
+  "dues.admin.status.flagCleared": "Flag cleared.",
+  "dues.admin.status.flagMissing": "That flag could not be found — it may already be cleared.",
+  "dues.admin.status.giftable": "Giftable",
+  "dues.admin.status.grace": "Grace after a failed renewal",
+  "dues.admin.status.group": "Group",
+  "dues.admin.status.hidden": "hidden",
+  "dues.admin.status.keySet": "set",
+  "dues.admin.status.keyUnset": "not set — nothing can be bought",
+  "dues.admin.status.no": "no",
+  "dues.admin.status.none": "None yet. The first purchase, or Stripe’s “send test event” button, will put a row here — which is how you prove the endpoint works.",
+  "dues.admin.status.order": "Order {id} — {plan}, {amount}",
+  "dues.admin.status.orders": "Orders needing attention",
+  "dues.admin.status.ordersText": "Money moved but the order could not settle cleanly — most often an amount that did not match. Check the payment in Stripe’s dashboard, put it right there, then clear the flag here.",
+  "dues.admin.status.plan": "Plan",
+  "dues.admin.status.plans": "Plans on sale",
+  "dues.admin.status.plansText": "Plans are made and changed on the plans screen. Each grants membership of its group only while that group is marked “may be granted by plugins” under Admin → Groups; a purchase against a group that refuses shows up above as needing attention, with the payment kept and the reason recorded.",
+  "dues.admin.status.price": "Price",
+  "dues.admin.status.secret": "Stripe secret key",
+  "dues.admin.status.source": "Keys resolve environment-first: the settings form below this page shows which source is winning.",
+  "dues.admin.status.unprocessed": "unprocessed — the reconcile task retries it",
+  "dues.admin.status.webhook": "The webhook to create",
+  "dues.admin.status.webhookSecret": "Webhook signing secret",
+  "dues.admin.status.webhookText": "In the Stripe dashboard, add an endpoint at /api/plugins/dues/hook/stripe on this board’s public address, subscribed to exactly these events, and put its signing secret in the settings:",
+  "dues.admin.status.webhookUnset": "not set — payments cannot confirm",
+  "dues.admin.status.working": "Is it working?",
+  "dues.admin.status.yes": "yes",
+  "dues.definition.description": "Sells {label} — time-limited membership of a group — through Stripe, for yourself or as a gift.",
+  "dues.definition.go": "Over to Stripe",
+  "dues.definition.manage": "Your {label}",
+  "dues.definition.notification.gift.description": "A member bought a membership in your name. It starts the moment the payment confirms.",
+  "dues.definition.notification.gift.title": "Somebody gifts you a membership",
+  "dues.definition.notification.renewal.description": "A renewal did not go through. Access holds during the grace window while Stripe retries.",
+  "dues.definition.notification.renewal.title": "A membership payment fails",
+  "dues.definition.page.codes": "Discount codes",
+  "dues.definition.page.ledger": "Ledger",
+  "dues.definition.page.members": "Memberships",
+  "dues.definition.page.plans": "Plans",
+  "dues.definition.page.return": "Confirming your payment",
+  "dues.definition.page.status": "Status",
+  "dues.definition.setting.apiBase.description": "Only a stripe-mock or a test double ever changes this.",
+  "dues.definition.setting.apiBase.label": "Stripe API address",
+  "dues.definition.setting.apiVersion.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.",
+  "dues.definition.setting.apiVersion.label": "Stripe API version",
+  "dues.definition.setting.secret.description": "The sk_live_… or sk_test_… key from the Stripe dashboard.",
+  "dues.definition.setting.secret.label": "Stripe secret key",
+  "dues.definition.setting.webhook.description": "The whsec_… secret of the webhook endpoint. Without it, payments are taken but can never confirm.",
+  "dues.definition.setting.webhook.label": "Webhook signing secret",
+  "dues.gifts.awaitingPayment": "awaiting payment",
+  "dues.gifts.delivered": "delivered",
+  "dues.gifts.heading": "Gifts you bought",
+  "dues.go.back": "Back to safety.",
+  "dues.go.continue": "continue by hand",
+  "dues.go.heading": "Over to Stripe…",
+  "dues.go.notAllowed": "That is not somewhere this board sends people.",
+  "dues.go.paymentLead": "Payment happens on Stripe’s own page — no card number ever touches this board. You should be there already;",
+  "dues.go.paymentTail": "if not.",
+  "dues.held.heading": "What you hold",
+  "dues.held.manage": "Manage your membership",
+  "dues.manage.cancel": "Cancel renewal — keep access until {date}",
+  "dues.manage.cancel-failed": "That could not be cancelled. If it keeps failing, contact a moderator.",
+  "dues.manage.cancelled": "Renewal cancelled. You keep everything you paid for until the period ends — nothing changes before then.",
+  "dues.manage.cardHeading": "Card and receipts",
+  "dues.manage.cardText": "Cards, invoices and receipts live on Stripe, where the payment did. The portal is theirs; it comes back here when you are done.",
+  "dues.manage.empty": "You hold no {label} yet.",
+  "dues.manage.grace": "A renewal payment failed. Stripe retries on its own; updating your card below usually settles it.",
+  "dues.manage.no-customer": "Stripe has no record for your account yet — the portal exists once you have bought something.",
+  "dues.manage.openPortal": "Open the billing portal",
+  "dues.manage.plans": "The plans are here.",
+  "dues.manage.sign-in": "Sign in first.",
+  "dues.manage.stripe-error": "Stripe could not be reached. Try again shortly.",
+  "dues.manage.title": "Your {label}",
+  "dues.manage.unconfigured": "Payments are not fully set up on this board.",
+  "dues.membership.activeAuto": "renews on",
+  "dues.membership.activeFixed": "yours until",
+  "dues.membership.closing": "will not renew — yours until",
+  "dues.membership.expired": "ended on",
+  "dues.membership.grace": "payment failed — access until",
+  "dues.membership.lifetime": "yours for good",
+  "dues.membership.revoked": "refunded and ended on",
+  "dues.notice.already-forever": "You hold this membership for good already — there is nothing left to buy for it.",
+  "dues.notice.already-member": "There is already an active subscription for that membership, so a second one would just charge twice for the same thing.",
+  "dues.notice.cancel-first": "There is an active subscription for that membership. Cancel its renewal first, then buy the lifetime plan — you keep everything already paid for.",
+  "dues.notice.cancelled": "Checkout was cancelled. Nothing was charged.",
+  "dues.notice.code-disabled": "That discount code has been switched off.",
+  "dues.notice.code-exhausted": "That discount code has been used as many times as it allows.",
+  "dues.notice.code-expired": "That discount code has expired.",
+  "dues.notice.code-wrong-plan": "That discount code is for a different plan.",
+  "dues.notice.gift-not-allowed": "That plan cannot be bought for someone else. Fixed-term passes can.",
+  "dues.notice.plan-not-ready": "That plan is not finished being set up — its Stripe price is missing. An administrator needs to complete it.",
+  "dues.notice.sign-in": "Sign in first, so the membership has an account to attach to.",
+  "dues.notice.stripe-error": "Stripe could not be reached, so nothing was charged. Try again shortly.",
+  "dues.notice.try-again": "That did not go through cleanly. Nothing was charged — try once more.",
+  "dues.notice.unconfigured": "Payments are not set up on this board yet. An administrator needs to finish the Stripe configuration before anything can be bought.",
+  "dues.notice.unknown-code": "That discount code does not exist. Check the spelling.",
+  "dues.notice.unknown-plan": "That plan is not on offer. The ones below are.",
+  "dues.notice.unknown-recipient": "No member goes by that name. Check the spelling — the gift needs somewhere to go.",
+  "dues.notification.gift.body": "It starts this moment — nothing to claim, nothing to do.",
+  "dues.notification.gift.subject": "Somebody bought you {plan}",
+  "dues.notification.renewal.body": "Stripe retries on its own. Your access holds during the grace window, and updating your card from the manage page usually settles it.",
+  "dues.notification.renewal.subject": "A membership payment did not go through",
+  "dues.plan.auto": "Renews automatically. Cancel any time and keep what you paid for until the period ends.",
+  "dues.plan.buyFixed": "Buy this pass",
+  "dues.plan.buyLifetime": "Buy lifetime membership",
+  "dues.plan.buySubscription": "Subscribe",
+  "dues.plan.discountCode": "Discount code, if you have one.",
+  "dues.plan.empty": "Nothing is on sale just now.",
+  "dues.plan.gift": "Buying for another member? Their username — leave empty for yourself.",
+  "dues.plan.lifetime": "One payment, no renewal, no end date.",
+  "dues.plan.payment": "Payment is taken by Stripe on their own checkout page — no card number ever touches this board.",
+  "dues.plan.signIn": "Sign in to join",
+  "dues.return.backToPlans": "Back to the plans",
+  "dues.return.backToShop": "Back to {label}",
+  "dues.return.checkAgain": "Check again",
+  "dues.return.checkout": "This checkout {status}.",
+  "dues.return.confirming": "Confirming your payment…",
+  "dues.return.confirmingText": "Stripe is telling the board about your payment right now. This page does not grant anything by itself — the confirmation does, and it usually lands within seconds.",
+  "dues.return.failed": "did not go through",
+  "dues.return.giftPaid": "Your gift of {plan} has been delivered. They hold it from this moment.",
+  "dues.return.noOrder": "There is no order of yours here.",
+  "dues.return.nothingCharged": "Nothing was charged",
+  "dues.return.paid": "Paid, and done",
+  "dues.return.paidPlan": "{plan} is yours from this moment.",
+  "dues.return.payment": "{amount} — Stripe sends the receipt.",
+  "dues.return.seeMembership": "See your membership",
+  "dues.return.wasCancelled": "was cancelled"
+}

package/src/messages/index.ts

@@ -0,0 +1,5 @@
+import type { CatalogBundle } from '@meith/theme-kit'
+
+import en from './en.json'
+
+export const duesMessages: CatalogBundle = { en }

package/src/money.ts

@@ -1,7 +1,20 @@
-
 const ZERO_DECIMAL = new Set([
-  'bif', 'clp', 'djf', 'gnf', 'jpy', 'kmf', 'krw', 'mga',
-  'pyg', 'rwf', 'ugx', 'vnd', 'vuv', 'xaf', 'xof', 'xpf',
+  'bif',
+  'clp',
+  'djf',
+  'gnf',
+  'jpy',
+  'kmf',
+  'krw',
+  'mga',
+  'pyg',
+  'rwf',
+  'ugx',
+  'vnd',
+  'vuv',
+  'xaf',
+  'xof',
+  'xpf',
 ])
 
 export function isZeroDecimal(currency: string): boolean {
@@ -16,12 +29,12 @@ export function isValidMinorAmount(value: unknown): value is number {
   return typeof value === 'number' && Number.isSafeInteger(value) && value > 0
 }
 
-export function formatMinor(amountMinor: number, currency: string): string {
+export function formatMinor(amountMinor: number, currency: string, locale = 'en'): string {
   const upper = currency.toUpperCase()
   const amount = isZeroDecimal(currency) ? amountMinor : amountMinor / 100
 
   try {
-    return new Intl.NumberFormat('en', {
+    return new Intl.NumberFormat(locale, {
       style: 'currency',
       currency: upper,
       minimumFractionDigits: isZeroDecimal(currency) ? 0 : 2,

package/src/period.ts

@@ -1,4 +1,3 @@
-
 export interface Period {
   readonly years: number
   readonly months: number
@@ -38,9 +37,7 @@ export function addPeriod(from: Date, period: Period): Date {
     const dayOfMonth = out.getUTCDate()
     out.setUTCDate(1)
     out.setUTCMonth(out.getUTCMonth() + months)
-    const lastDay = new Date(
-      Date.UTC(out.getUTCFullYear(), out.getUTCMonth() + 1, 0),
-    ).getUTCDate()
+    const lastDay = new Date(Date.UTC(out.getUTCFullYear(), out.getUTCMonth() + 1, 0)).getUTCDate()
     out.setUTCDate(Math.min(dayOfMonth, lastDay))
   }
 

package/src/plans.ts

@@ -2,7 +2,7 @@ import type { PluginData } from '@meith/plugin-kit'
 
 import type { DuesConfig } from './config'
 import { isCurrencyCode, isValidMinorAmount } from './money'
-import { addDays, parsePeriod, periodCeilingDays, type Period } from './period'
+import { addDays, type Period, parsePeriod, periodCeilingDays } from './period'
 import {
   countPlans,
   insertPlan,
@@ -29,10 +29,7 @@ export function isLifetime(periodEnd: Date): boolean {
   return periodEnd >= LIFETIME_END
 }
 
-export async function loadPlans(
-  data: PluginData,
-  config: DuesConfig,
-): Promise<readonly PlanRow[]> {
+export async function loadPlans(data: PluginData, config: DuesConfig): Promise<readonly PlanRow[]> {
   if ((await countPlans(data)) === 0 && config.seedPlans.length > 0) {
     for (const seed of config.seedPlans) {
       await insertPlan(data, {
@@ -55,10 +52,7 @@ export async function loadPlans(
   return listPlans(data)
 }
 
-export async function shopPlans(
-  data: PluginData,
-  config: DuesConfig,
-): Promise<readonly PlanRow[]> {
+export async function shopPlans(data: PluginData, config: DuesConfig): Promise<readonly PlanRow[]> {
   return (await loadPlans(data, config)).filter((plan) => !plan.hidden && !plan.archived)
 }
 
@@ -149,7 +143,15 @@ export function parsePlanForm(form: PlanFormInput, graceDays: number): PlanParse
     const length = Number(form.length ?? '')
     const unit = form.unit ?? ''
     const letter =
-      unit === 'days' ? 'D' : unit === 'weeks' ? 'W' : unit === 'months' ? 'M' : unit === 'years' ? 'Y' : null
+      unit === 'days'
+        ? 'D'
+        : unit === 'weeks'
+          ? 'W'
+          : unit === 'months'
+            ? 'M'
+            : unit === 'years'
+              ? 'Y'
+              : null
     if (letter === null || !Number.isInteger(length) || length < 1) return bad('bad-length')
 
     periodSpec = `P${length}${letter}`

package/src/store.ts

@@ -114,7 +114,10 @@ function membershipRow(row: Record<string, unknown>): MembershipRow {
     graceUntil: asDate(row.grace_until),
     needsAttention: asNullableString(row.needs_attention),
     stripeSubscriptionId: asNullableString(row.stripe_subscription_id),
-    lastOrderId: row.last_order_id === null || row.last_order_id === undefined ? null : Number(row.last_order_id),
+    lastOrderId:
+      row.last_order_id === null || row.last_order_id === undefined
+        ? null
+        : Number(row.last_order_id),
   }
 }
 
@@ -137,7 +140,9 @@ function ledgerRow(row: Record<string, unknown>): LedgerRow {
     kind: String(row.kind) as LedgerRow['kind'],
     userId: Number(row.user_id),
     membershipId:
-      row.membership_id === null || row.membership_id === undefined ? null : Number(row.membership_id),
+      row.membership_id === null || row.membership_id === undefined
+        ? null
+        : Number(row.membership_id),
     orderId: row.order_id === null || row.order_id === undefined ? null : Number(row.order_id),
     amountMinor: Number(row.amount_minor),
     currency: String(row.currency),
@@ -329,10 +334,7 @@ export async function liveMembership(
   return row === null ? null : membershipRow(row)
 }
 
-export async function membershipById(
-  data: PluginData,
-  id: number,
-): Promise<MembershipRow | null> {
+export async function membershipById(data: PluginData, id: number): Promise<MembershipRow | null> {
   const row = await data.one('select * from plugin_dues_membership where id = $1', [id])
   return row === null ? null : membershipRow(row)
 }
@@ -448,11 +450,7 @@ export async function setMembershipStatus(
   )
 }
 
-export async function flagMembership(
-  data: PluginData,
-  id: number,
-  reason: string,
-): Promise<void> {
+export async function flagMembership(data: PluginData, id: number, reason: string): Promise<void> {
   await data.query(
     `update plugin_dues_membership set needs_attention = $2, updated_at = now() where id = $1`,
     [id, reason],
@@ -519,10 +517,9 @@ export async function recordEvent(
   )
   if (inserted !== null) return { id: Number(inserted.id), first: true }
 
-  const existing = await data.one(
-    'select id from plugin_dues_event where stripe_event_id = $1',
-    [event.stripeEventId],
-  )
+  const existing = await data.one('select id from plugin_dues_event where stripe_event_id = $1', [
+    event.stripeEventId,
+  ])
   if (existing === null) throw new Error('event insert lost a race it cannot lose')
   return { id: Number(existing.id), first: false }
 }
@@ -613,7 +610,10 @@ export interface MonthlyTotal {
   readonly charges: number
 }
 
-export async function monthlyTotals(data: PluginData, months = 12): Promise<readonly MonthlyTotal[]> {
+export async function monthlyTotals(
+  data: PluginData,
+  months = 12,
+): Promise<readonly MonthlyTotal[]> {
   const rows = await data.query(
     `select to_char(date_trunc('month', occurred_at), 'YYYY-MM') as month,
             currency,
@@ -712,10 +712,7 @@ export interface NewCode {
   readonly createdByUserId: number
 }
 
-export async function insertCode(
-  data: PluginData,
-  code: NewCode,
-): Promise<CodeRow | null> {
+export async function insertCode(data: PluginData, code: NewCode): Promise<CodeRow | null> {
   const row = await data.one(
     `insert into plugin_dues_code
        (code, percent_off, plan_key, max_redemptions, expires_at, created_by_user_id)
@@ -735,10 +732,7 @@ export async function insertCode(
 }
 
 export async function codeByCode(data: PluginData, code: string): Promise<CodeRow | null> {
-  const row = await data.one(
-    'select * from plugin_dues_code where lower(code) = lower($1)',
-    [code],
-  )
+  const row = await data.one('select * from plugin_dues_code where lower(code) = lower($1)', [code])
   return row === null ? null : codeRow(row)
 }
 
@@ -922,16 +916,14 @@ export async function setPlanArchived(
   id: number,
   archived: boolean,
 ): Promise<void> {
-  await data.query(
-    `update plugin_dues_plan set archived = $2, updated_at = now() where id = $1`,
-    [id, archived],
-  )
+  await data.query(`update plugin_dues_plan set archived = $2, updated_at = now() where id = $1`, [
+    id,
+    archived,
+  ])
 }
 
 export async function listPlans(data: PluginData): Promise<readonly PlanRow[]> {
-  const rows = await data.query(
-    `select * from plugin_dues_plan order by archived, created_at, id`,
-  )
+  const rows = await data.query(`select * from plugin_dues_plan order by archived, created_at, id`)
   return rows.map(planRow)
 }
 

package/src/stripe/client.ts

@@ -1,4 +1,3 @@
-
 export interface StripeClientOptions {
   readonly secretKey: string
   readonly apiVersion: string
@@ -31,7 +30,9 @@ export function encodeStripeForm(body: Record<string, unknown>): string {
   const walk = (prefix: string, value: unknown): void => {
     if (value === undefined || value === null) return
     if (Array.isArray(value)) {
-      value.forEach((entry, index) => walk(`${prefix}[${index}]`, entry))
+      value.forEach((entry, index) => {
+        walk(`${prefix}[${index}]`, entry)
+      })
       return
     }
     if (typeof value === 'object') {
@@ -68,7 +69,11 @@ export interface SubscriptionState {
 
 function str(value: unknown): string | null {
   if (typeof value === 'string') return value
-  if (typeof value === 'object' && value !== null && typeof (value as { id?: unknown }).id === 'string') {
+  if (
+    typeof value === 'object' &&
+    value !== null &&
+    typeof (value as { id?: unknown }).id === 'string'
+  ) {
     return (value as { id: string }).id
   }
   return null
@@ -89,7 +94,8 @@ export function sessionFromApi(body: Record<string, unknown>): CheckoutSessionSt
 }
 
 export function subscriptionFromApi(body: Record<string, unknown>): SubscriptionState {
-  let periodEnd: number | null = typeof body.current_period_end === 'number' ? body.current_period_end : null
+  let periodEnd: number | null =
+    typeof body.current_period_end === 'number' ? body.current_period_end : null
 
   if (periodEnd === null) {
     const items = (body.items as { data?: unknown } | undefined)?.data
@@ -179,9 +185,7 @@ export function createStripeClient(options: StripeClientOptions): StripeClient {
           headers: {
             authorization: `Bearer ${options.secretKey}`,
             'stripe-version': options.apiVersion,
-            ...(body === undefined
-              ? {}
-              : { 'content-type': 'application/x-www-form-urlencoded' }),
+            ...(body === undefined ? {} : { 'content-type': 'application/x-www-form-urlencoded' }),
             ...(idempotencyKey === undefined ? {} : { 'idempotency-key': idempotencyKey }),
           },
           ...(body === undefined ? {} : { body: encodeStripeForm(body) }),

package/src/stripe/events.ts

@@ -1,4 +1,3 @@
-
 export interface StripeEventEnvelope {
   readonly id: string
   readonly type: string
@@ -68,9 +67,7 @@ function invoiceSubscriptionId(invoice: Record<string, unknown>): string | null
   const direct = idOf(invoice.subscription)
   if (direct !== null) return direct
 
-  const parent = invoice.parent as
-    | { subscription_details?: { subscription?: unknown } }
-    | undefined
+  const parent = invoice.parent as { subscription_details?: { subscription?: unknown } } | undefined
   return idOf(parent?.subscription_details?.subscription)
 }
 
@@ -79,7 +76,7 @@ function invoicePeriodEnd(invoice: Record<string, unknown>): Date | null {
   let latest: number | null = null
   if (Array.isArray(lines)) {
     for (const line of lines) {
-      const end = ((line as { period?: { end?: unknown } }).period ?? {}).end
+      const end = (line as { period?: { end?: unknown } }).period?.end
       if (typeof end === 'number' && (latest === null || end > latest)) latest = end
     }
   }

package/src/tasks.ts

@@ -1,12 +1,12 @@
+import { applyInternalEvent, type EntitlementDeps, settlePaidOrder } from './entitlement'
 import { addDays } from './period'
 import { clampGrantUntil, TOP_UP_WHEN_WITHIN_DAYS } from './plans'
-import { applyInternalEvent, settlePaidOrder, type EntitlementDeps } from './entitlement'
 import {
   expireDueMemberships,
   extendMembership,
   longLiveMemberships,
-  markEventProcessed,
   markEventFailed,
+  markEventProcessed,
   membershipsPastPeriod,
   pendingOrdersOlderThan,
   setMembershipStatus,