@softure-ai/billing 0.0.0-stage → 0.1.6

package/dist/next/pages.js

@@ -0,0 +1,166 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// Pages ready to mount with one line each:
+// `export { PaymentPage as default } from "@softure-ai/billing/next"` at `routes.payment`, and
+// `export { BillingAdminPage as default } from "@softure-ai/billing/next"` at `routes.admin`.
+// Server components: they read the config and the session, and render the forms from `../ui`.
+import { requireRole, requireUser } from "@softure-ai/auth/next";
+import { formatMessage } from "@softure-ai/core";
+import { getSoftureConfig } from "@softure-ai/core/next";
+import { ButtonLink, Card, EmptyState } from "@softure-ai/ui";
+import { ACCOUNT_PARAM, CHECKOUT_PARAM, CHECKOUT_RESULTS, PLAN_FIELD } from "../fields.js";
+import { findPlan, getLocalizedText } from "../plans.js";
+import { formatPrice } from "../price.js";
+import { getEntitlement } from "../server/entitlements.js";
+import { getAccountHistory } from "../server/grants.js";
+import { getBillingMessages, getBillingOptions, getBillingRoutes } from "../server/options.js";
+import { findAccountById, getBillingPlans, getPaymentProvider } from "../server/plans.js";
+import { listOpenRequests } from "../server/requests.js";
+import { AccessBadge } from "../ui/access-badge.js";
+import { formatDay, formatLastDay, formatPeriod } from "../ui/format.js";
+import { GrantForm } from "../ui/grant-form.js";
+import { AccountLookup, GrantHistory } from "../ui/grant-history.js";
+import { PaymentForm } from "../ui/payment-form.js";
+import { PaymentRequestList } from "../ui/payment-requests.js";
+import { PricingTiles } from "../ui/pricing-tiles.js";
+import { CurrentAccessBadge } from "./access.js";
+import { dismissRequestAction, findAccountAction, grantPlanAction, grantRequestAction, revokeGrantAction, startPaymentAction } from "./actions.js";
+import { getBillingContext } from "./context.js";
+import { getCurrentEntitlement } from "./current-entitlement.js";
+import { getPlanPaymentHref } from "./pricing.js";
+const LAYOUT_CLASS = "sft:mx-auto sft:box-border sft:flex sft:w-full sft:flex-col sft:gap-4 sft:sm:max-w-md sft:px-4 sft:py-4";
+const STACK_CLASS = "sft:flex sft:flex-col sft:gap-4";
+const LEAD_CLASS = "sft:m-0 sft:font-sans sft:text-sm sft:text-muted";
+const NOTICE_CLASS = "sft:m-0 sft:rounded-control sft:border sft:border-border-strong sft:bg-surface-raised sft:px-4 sft:py-2.5 sft:font-sans sft:text-sm sft:text-foreground";
+async function readParam(searchParams, name) {
+    const value = (await searchParams)?.[name];
+    return Array.isArray(value) ? value[0] : value;
+}
+function isCheckoutResult(value) {
+    return CHECKOUT_RESULTS.some((result) => result === value);
+}
+/**
+ * The plans and, with `?plan=<id>`, the order: the plan's price and the provider's form (the
+ * invoice request of the manual adapter, a checkout button of a hosted provider). Without a session
+ * it sends the visitor to log in and back. A read-only account reaches it too: it is where to pay.
+ * A hosted checkout comes back with `?checkout=success` or `?checkout=cancelled`, shown as a notice
+ * (the access itself changes when the provider's webhook confirms the payment).
+ */
+export async function PaymentPage({ searchParams }) {
+    const config = getSoftureConfig();
+    const route = getBillingRoutes(config).payment;
+    const planId = await readParam(searchParams, PLAN_FIELD);
+    const checkout = await readParam(searchParams, CHECKOUT_PARAM);
+    const user = await requireUser({ next: planId === undefined ? route : getPlanPaymentHref(route, planId), searchParams: await searchParams });
+    const provider = getPaymentProvider(config);
+    const messages = getBillingMessages(config);
+    const copy = messages.payment;
+    const plans = getBillingPlans(config);
+    const plan = planId === undefined ? undefined : findPlan(plans, planId);
+    const planName = plan === undefined ? "" : getLocalizedText(plan.name, config.locale);
+    const checkoutNotice = isCheckoutResult(checkout) ? (checkout === "success" ? copy.checkoutSuccess : copy.checkoutCancelled) : null;
+    const entitlement = await getCurrentEntitlement();
+    // Lifetime access leaves nothing to pay for: no order form (startPayment refuses it too).
+    const hasLifetime = entitlement?.status === "paid" && entitlement.endsAt === null;
+    return (_jsxs("main", { className: LAYOUT_CLASS, children: [_jsx(Card, { title: copy.title, subtitle: copy.lead, children: _jsxs("div", { className: STACK_CLASS, children: [checkoutNotice === null ? null : (_jsx("p", { role: "status", className: NOTICE_CLASS, "data-checkout": checkout, children: checkoutNotice })), _jsx("div", { children: _jsx(CurrentAccessBadge, {}) }), hasLifetime ? (_jsx("p", { role: "status", className: NOTICE_CLASS, "data-lifetime": "true", children: copy.lifetime })) : null, _jsx(PricingTiles, { plans: plans, messages: messages, locale: config.locale, getPlanHref: (candidate) => getPlanPaymentHref(route, candidate.id), selectedPlanId: plan?.id, label: copy.plansLabel })] }) }), plan === undefined || hasLifetime ? null : (_jsx(Card, { title: copy.orderTitle, subtitle: formatMessage(copy.orderLead, { plan: planName, price: formatPrice(plan.price, config.locale), period: formatPeriod(plan.period, config.locale, messages) }), children: _jsxs("div", { className: STACK_CLASS, children: [provider.collectsInvoiceDetails ? _jsx("p", { className: LEAD_CLASS, children: formatMessage(copy.invoiceLead, { email: user.email }) }) : null, _jsx(PaymentForm, { action: startPaymentAction, planId: plan.id, planName: planName, email: user.email, collectsInvoiceDetails: provider.collectsInvoiceDetails, messages: messages, locale: config.locale }), _jsx("div", { children: _jsx(ButtonLink, { href: route, variant: "ghost", size: "sm", children: copy.changePlan }) })] }) }))] }));
+}
+/** The plan's name in the app's locale, or its id when the config no longer has it. */
+function getPlanName(plans, planId, locale) {
+    const plan = findPlan(plans, planId);
+    return plan === undefined ? planId : getLocalizedText(plan.name, locale);
+}
+function getHistoryHref(config, userId) {
+    return `${getBillingRoutes(config).admin}?${new URLSearchParams({ [ACCOUNT_PARAM]: userId }).toString()}`;
+}
+function toRequestRow(request, { config, messages, plans }) {
+    const copy = messages.admin.requests;
+    const values = { email: request.email, plan: getPlanName(plans, request.planId, config.locale) };
+    const { invoice } = request;
+    const details = [formatMessage(copy.requestedOn, { date: formatDay(request.requestedAt, config.locale, config.timezone) })];
+    if (request.price !== null)
+        details.push(formatMessage(copy.price, { price: formatPrice(request.price, config.locale) }));
+    if (invoice === null)
+        details.push(copy.noInvoice);
+    else {
+        details.push(formatMessage(copy.invoice, { name: invoice.name, address: invoice.address }));
+        if (invoice.taxId !== null)
+            details.push(formatMessage(copy.taxId, { taxId: invoice.taxId }));
+    }
+    return {
+        id: request.id,
+        title: formatMessage(copy.line, values),
+        details,
+        historyHref: getHistoryHref(config, request.userId),
+        grantLabel: formatMessage(copy.grantLabel, values),
+        dismissLabel: formatMessage(copy.dismissLabel, values),
+    };
+}
+function describeGrant(grant, { config, messages }) {
+    const copy = messages.admin.history;
+    if (grant === null)
+        return copy.noGrant;
+    if (grant.kind === "lifetime")
+        return copy.lifetime;
+    return formatMessage(copy.period, { from: formatDay(grant.from, config.locale, config.timezone), to: formatLastDay(grant.until, config.locale, config.timezone) });
+}
+function toHistoryRow(entry, context) {
+    const { config, messages, plans } = context;
+    const copy = messages.admin.history;
+    const plan = getPlanName(plans, entry.planId, config.locale);
+    const formatDate = (date) => formatDay(date, config.locale, config.timezone);
+    if (entry.source === "manual") {
+        const isActive = entry.status === "active";
+        return {
+            id: entry.id,
+            title: formatMessage(entry.isFromRequest ? copy.fromRequest : copy.manual, { plan }),
+            statusText: isActive || entry.revokedAt === null ? copy.active : formatMessage(copy.revokedOn, { date: formatDate(entry.revokedAt) }),
+            isCurrent: isActive,
+            details: [
+                entry.price === null
+                    ? formatMessage(copy.grantedOn, { date: formatDate(entry.at) })
+                    : formatMessage(copy.grantedFor, { amount: formatPrice(entry.price, config.locale), date: formatDate(entry.at) }),
+                describeGrant(entry.grant, context),
+            ],
+            revokeLabel: isActive ? formatMessage(copy.revokeLabel, { plan, date: formatDate(entry.at) }) : null,
+        };
+    }
+    const isPaid = entry.status === "paid";
+    const formatAmount = (amount) => formatPrice({ amount, currency: entry.currency }, config.locale);
+    let statusText = copy.paid;
+    if (!isPaid && entry.refundedAt !== null)
+        statusText = formatMessage(copy.refundedOn, { date: formatDate(entry.refundedAt) });
+    else if (entry.refundedAmount > 0)
+        statusText = formatMessage(copy.partlyRefunded, { amount: formatAmount(entry.refundedAmount) });
+    return {
+        id: entry.id,
+        title: formatMessage(copy.provider, { plan, provider: entry.provider }),
+        statusText,
+        isCurrent: isPaid,
+        details: [
+            formatMessage(copy.paidOn, { amount: formatAmount(entry.amount), date: formatDate(entry.at) }),
+            describeGrant(entry.grant, context),
+        ],
+        revokeLabel: null,
+    };
+}
+/**
+ * The admin page of manual payments: the open invoice requests (grant or dismiss each), the grant
+ * form, and an account's history (`?account=<id>`, reached by the email lookup or a request's
+ * link) with its access and a revoke button on each active manual grant. Anyone without the role
+ * of `billing({ adminRole })`, signed in or not, gets Next's "not found".
+ */
+export async function BillingAdminPage({ searchParams }) {
+    const config = getSoftureConfig();
+    await requireRole(getBillingOptions(config).adminRole);
+    const messages = getBillingMessages(config);
+    const plans = getBillingPlans(config);
+    const context = { config, messages, plans };
+    const ctx = await getBillingContext(config);
+    const requests = (await listOpenRequests(ctx)).map((request) => toRequestRow(request, context));
+    const accountId = await readParam(searchParams, ACCOUNT_PARAM);
+    const account = accountId === undefined ? null : await findAccountById(ctx, accountId);
+    const entitlement = account === null ? null : await getEntitlement(ctx, account.id);
+    const history = account === null ? [] : (await getAccountHistory(ctx, account.id)).map((entry) => toHistoryRow(entry, context));
+    const planOptions = plans.map((plan) => ({ value: plan.id, label: getLocalizedText(plan.name, config.locale) }));
+    return (_jsxs("main", { className: LAYOUT_CLASS, children: [_jsx(Card, { title: messages.admin.requests.title, subtitle: messages.admin.requests.lead, children: _jsx(PaymentRequestList, { requests: requests, grantAction: grantRequestAction, dismissAction: dismissRequestAction, messages: messages }) }), _jsx(Card, { title: messages.admin.title, subtitle: messages.admin.lead, children: planOptions.length === 0 ? (_jsx(EmptyState, { title: messages.admin.noPlans })) : (_jsx(GrantForm, { action: grantPlanAction, plans: planOptions, messages: messages, locale: config.locale })) }), _jsx(Card, { title: messages.admin.history.title, subtitle: messages.admin.history.lead, children: _jsxs("div", { className: STACK_CLASS, children: [_jsx(AccountLookup, { action: findAccountAction, messages: messages, locale: config.locale }), account === null ? null : (_jsxs("section", { className: STACK_CLASS, "aria-label": formatMessage(messages.admin.history.accountTitle, { email: account.email }), children: [_jsx("p", { className: LEAD_CLASS, children: formatMessage(messages.admin.history.accountTitle, { email: account.email }) }), entitlement === null ? null : (_jsx("div", { children: _jsx(AccessBadge, { entitlement: entitlement, messages: messages, locale: config.locale, timezone: config.timezone }) })), _jsx(GrantHistory, { rows: history, revokeAction: revokeGrantAction, messages: messages })] }))] }) })] }));
+}
+//# sourceMappingURL=pages.js.map

package/dist/next/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../src/next/pages.tsx"],"names":[],"mappings":"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"}

package/dist/next/pricing.d.ts

@@ -0,0 +1,12 @@
+import type { ClassNames, LinkComponentType } from "@softure-ai/ui";
+import { type PricingTilesSlot } from "../ui/pricing-tiles.js";
+export interface PricingProps {
+    /** The app's link component, e.g. Next's `Link`; a plain `<a>` when omitted. */
+    readonly LinkComponent?: LinkComponentType;
+    readonly classNames?: ClassNames<PricingTilesSlot>;
+    readonly unstyled?: boolean;
+}
+/** The payment page with a plan chosen. */
+export declare function getPlanPaymentHref(paymentRoute: string, planId: string): string;
+export declare function Pricing({ LinkComponent, classNames, unstyled }: PricingProps): import("react").JSX.Element;
+//# sourceMappingURL=pricing.d.ts.map

package/dist/next/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/next/pricing.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAIpE,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE7E,MAAM,WAAW,YAAY;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAgB,OAAO,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,YAAY,+BAgB5E"}

package/dist/next/pricing.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// The pricing tiles wired to the registered config, for any server component (a landing or a
+// pricing page): `<Pricing LinkComponent={Link} />`. Each tile's button opens the payment page with
+// its plan; the page asks a visitor without a session to log in first.
+import { getSoftureConfig } from "@softure-ai/core/next";
+import { PLAN_FIELD } from "../fields.js";
+import { getBillingMessages, getBillingRoutes } from "../server/options.js";
+import { getBillingPlans } from "../server/plans.js";
+import { PricingTiles } from "../ui/pricing-tiles.js";
+/** The payment page with a plan chosen. */
+export function getPlanPaymentHref(paymentRoute, planId) {
+    return `${paymentRoute}?${PLAN_FIELD}=${encodeURIComponent(planId)}`;
+}
+export function Pricing({ LinkComponent, classNames, unstyled }) {
+    const config = getSoftureConfig();
+    const messages = getBillingMessages(config);
+    const payment = getBillingRoutes(config).payment;
+    return (_jsx(PricingTiles, { plans: getBillingPlans(config), messages: messages, locale: config.locale, getPlanHref: (plan) => getPlanPaymentHref(payment, plan.id), LinkComponent: LinkComponent, label: messages.payment.plansLabel, classNames: classNames, unstyled: unstyled }));
+}
+//# sourceMappingURL=pricing.js.map

package/dist/next/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../src/next/pricing.tsx"],"names":[],"mappings":";AAAA,6FAA6F;AAC7F,oGAAoG;AACpG,uEAAuE;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAyB,MAAM,wBAAwB,CAAC;AAS7E,2CAA2C;AAC3C,MAAM,UAAU,kBAAkB,CAAC,YAAoB,EAAE,MAAc;IACrE,OAAO,GAAG,YAAY,IAAI,UAAU,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAgB;IAC3E,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;IACjD,OAAO,CACL,KAAC,YAAY,IACX,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,EAC9B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,EAC3D,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,EAClC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,GAClB,CACH,CAAC;AACJ,CAAC"}

package/dist/next/route.d.ts

@@ -0,0 +1,11 @@
+export declare const STRIPE_WEBHOOK_SECRET_ENV = "STRIPE_WEBHOOK_SECRET";
+/** Stripe's checkout and charge events are a few kilobytes; anything far larger is not Stripe. */
+export declare const STRIPE_WEBHOOK_MAX_BYTES: number;
+/**
+ * Handles one delivery: 200 once it is recorded (also again, and for events billing ignores), 400
+ * for a delivery that is not signed by Stripe within the tolerance, 413 for an oversized body, 500
+ * when the secret is missing or the database fails, so Stripe retries. A payment whose account or
+ * plan is gone answers 200 and is logged: a retry cannot fix it, the owner refunds it in Stripe.
+ */
+export declare function stripeWebhookRoute(request: Request): Promise<Response>;
+//# sourceMappingURL=route.d.ts.map

package/dist/next/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/next/route.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AACjE,kGAAkG;AAClG,eAAO,MAAM,wBAAwB,QAAa,CAAC;AAQnD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0B5E"}

package/dist/next/route.js

@@ -0,0 +1,56 @@
+// The Stripe webhook route. Mount it with a rename in app/api/billing/webhook/route.ts:
+// `export { stripeWebhookRoute as POST } from "@softure-ai/billing/next"`, and point a Stripe
+// webhook endpoint at it for `checkout.session.completed`, `checkout.session.async_payment_succeeded`
+// and `charge.refunded`.
+//
+// Stripe calls it from its own servers: no session, no cookies, so it stays outside any auth
+// guard. There is no rate limit on purpose: Stripe sends from a few addresses, and a bucket would
+// drop real payments. The body is capped and the signature checked before the database is touched.
+import { errorLogLabel } from "@softure-ai/core";
+import { readSmallBody } from "@softure-ai/security";
+import { receiveStripeWebhook } from "../server/payments.js";
+import { STRIPE_SIGNATURE_HEADER } from "../stripe-webhook.js";
+import { getBillingContext } from "./context.js";
+export const STRIPE_WEBHOOK_SECRET_ENV = "STRIPE_WEBHOOK_SECRET";
+/** Stripe's checkout and charge events are a few kilobytes; anything far larger is not Stripe. */
+export const STRIPE_WEBHOOK_MAX_BYTES = 256 * 1024;
+const NO_STORE = { "cache-control": "no-store" };
+function answer(status) {
+    return new Response(null, { status, headers: NO_STORE });
+}
+/**
+ * Handles one delivery: 200 once it is recorded (also again, and for events billing ignores), 400
+ * for a delivery that is not signed by Stripe within the tolerance, 413 for an oversized body, 500
+ * when the secret is missing or the database fails, so Stripe retries. A payment whose account or
+ * plan is gone answers 200 and is logged: a retry cannot fix it, the owner refunds it in Stripe.
+ */
+export async function stripeWebhookRoute(request) {
+    const secret = (process.env[STRIPE_WEBHOOK_SECRET_ENV] ?? "").trim();
+    if (secret === "") {
+        console.error(`@softure-ai/billing: the Stripe webhook has no secret; set ${STRIPE_WEBHOOK_SECRET_ENV}`);
+        return answer(500);
+    }
+    const body = await readSmallBody(request, { maxBytes: STRIPE_WEBHOOK_MAX_BYTES });
+    if (!body.ok)
+        return answer(body.error === "security.body_too_large" ? 413 : 400);
+    let received;
+    try {
+        received = await receiveStripeWebhook(await getBillingContext(), {
+            payload: body.value,
+            signature: request.headers.get(STRIPE_SIGNATURE_HEADER),
+            secret,
+        });
+    }
+    catch (error) {
+        console.error(`@softure-ai/billing: a Stripe webhook failed: ${errorLogLabel(error)}`);
+        return answer(500);
+    }
+    if (!received.ok)
+        return answer(400);
+    const { outcome } = received.value;
+    if (outcome.status === "refused") {
+        console.error(`@softure-ai/billing: the paid Stripe checkout ${outcome.checkoutId} granted nothing (${outcome.error}); refund it in the Stripe dashboard`);
+    }
+    return answer(200);
+}
+//# sourceMappingURL=route.js.map

package/dist/next/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/next/route.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,8FAA8F;AAC9F,sGAAsG;AACtG,yBAAyB;AACzB,EAAE;AACF,6FAA6F;AAC7F,kGAAkG;AAClG,mGAAmG;AACnG,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AACjE,kGAAkG;AAClG,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,GAAG,IAAI,CAAC;AAEnD,MAAM,QAAQ,GAAG,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC;AAEjD,SAAS,MAAM,CAAC,MAAc;IAC5B,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAgB;IACvD,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrE,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,8DAA8D,yBAAyB,EAAE,CAAC,CAAC;QACzG,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,wBAAwB,EAAE,CAAC,CAAC;IAClF,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,yBAAyB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAElF,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,oBAAoB,CAAC,MAAM,iBAAiB,EAAE,EAAE;YAC/D,OAAO,EAAE,IAAI,CAAC,KAAK;YACnB,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;YACvD,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,iDAAiD,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC;IACnC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,iDAAiD,OAAO,CAAC,UAAU,qBAAqB,OAAO,CAAC,KAAK,sCAAsC,CAAC,CAAC;IAC7J,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC"}

package/dist/options.d.ts

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import { type PaymentProvider } from "./payment.js";
+/** The longest trial or reminder window, in days. */
+export declare const MAX_DAYS = 365;
+/** The most plans the config declares. */
+export declare const MAX_PLANS = 12;
+/** The most feature lines one plan lists. */
+export declare const MAX_FEATURES = 20;
+/** The highest price, in the currency's minor unit. */
+export declare const MAX_PRICE_AMOUNT = 100000000;
+/** The most units one period counts. */
+export declare const MAX_PERIOD_COUNT = 1000;
+/** How long an open invoice request waits by default before it expires, in days. */
+export declare const DEFAULT_REQUEST_EXPIRY_DAYS = 30;
+/**
+ * What a partial refund of a provider payment does to access: `pro_rata` takes back the refunded
+ * share of the payment's unused days, `keep_access` takes back nothing until the whole payment is
+ * refunded.
+ */
+export declare const PARTIAL_REFUND_POLICIES: readonly ["pro_rata", "keep_access"];
+export type PartialRefundPolicy = (typeof PARTIAL_REFUND_POLICIES)[number];
+export declare const billingOptionsSchema: z.ZodObject<{
+    trial: z.ZodPrefault<z.ZodObject<{
+        days: z.ZodDefault<z.ZodNumber>;
+        reminderDays: z.ZodDefault<z.ZodNumber>;
+        startsAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    paid: z.ZodPrefault<z.ZodObject<{
+        reminderDays: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    requests: z.ZodPrefault<z.ZodObject<{
+        expireAfterDays: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    plans: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodRecord<z.ZodEnum<{
+            en: "en";
+            pl: "pl";
+        }> & z.core.$partial, z.ZodString>;
+        description: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            en: "en";
+            pl: "pl";
+        }> & z.core.$partial, z.ZodString>>;
+        price: z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodString;
+        }, z.core.$strict>;
+        period: z.ZodUnion<readonly [z.ZodPipe<z.ZodEnum<{
+            year: "year";
+            month: "month";
+            day: "day";
+            lifetime: "lifetime";
+            week: "week";
+        }>, z.ZodTransform<{
+            readonly unit: import("./contract.js").PeriodUnit;
+            readonly count: number;
+        } | {
+            readonly unit: "lifetime";
+        }, "year" | "month" | "day" | "lifetime" | "week">>, z.ZodObject<{
+            unit: z.ZodEnum<{
+                year: "year";
+                month: "month";
+                day: "day";
+                week: "week";
+            }>;
+            count: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            unit: z.ZodLiteral<"lifetime">;
+        }, z.core.$strict>]>;
+        features: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodEnum<{
+            en: "en";
+            pl: "pl";
+        }> & z.core.$partial, z.ZodString>>>;
+        isFeatured: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    payment: z.ZodOptional<z.ZodCustom<PaymentProvider, PaymentProvider>>;
+    partialRefunds: z.ZodDefault<z.ZodEnum<{
+        pro_rata: "pro_rata";
+        keep_access: "keep_access";
+    }>>;
+    adminRole: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>;
+export type BillingOptionsInput = z.input<typeof billingOptionsSchema>;
+export type BillingOptions = z.output<typeof billingOptionsSchema>;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAGvE,qDAAqD;AACrD,eAAO,MAAM,QAAQ,MAAM,CAAC;AAC5B,0CAA0C;AAC1C,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,6CAA6C;AAC7C,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,YAAc,CAAC;AAC5C,wCAAwC;AACxC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,oFAAoF;AACpF,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,sCAAuC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAkC3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgE/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/options.js

@@ -0,0 +1,121 @@
+// The options an app passes to `billing({ ... })` in softure.config.ts, parsed at startup.
+import { LOCALES } from "@softure-ai/core";
+import { z } from "zod";
+import { parseDay } from "./calendar.js";
+import { PERIOD_UNITS } from "./contract.js";
+import { isPaymentProvider } from "./payment.js";
+import { isSupportedCurrency } from "./price.js";
+/** The longest trial or reminder window, in days. */
+export const MAX_DAYS = 365;
+/** The most plans the config declares. */
+export const MAX_PLANS = 12;
+/** The most feature lines one plan lists. */
+export const MAX_FEATURES = 20;
+/** The highest price, in the currency's minor unit. */
+export const MAX_PRICE_AMOUNT = 100_000_000;
+/** The most units one period counts. */
+export const MAX_PERIOD_COUNT = 1000;
+/** How long an open invoice request waits by default before it expires, in days. */
+export const DEFAULT_REQUEST_EXPIRY_DAYS = 30;
+/**
+ * What a partial refund of a provider payment does to access: `pro_rata` takes back the refunded
+ * share of the payment's unused days, `keep_access` takes back nothing until the whole payment is
+ * refunded.
+ */
+export const PARTIAL_REFUND_POLICIES = ["pro_rata", "keep_access"];
+const daysSchema = z.number().int().min(0).max(MAX_DAYS);
+/** Kebab-case, at most 64 characters. */
+const PLAN_ID_PATTERN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+/** Copy per locale; a locale without its own text falls back to `en`. */
+const localizedTextSchema = z
+    .partialRecord(z.enum(LOCALES), z.string().trim().min(1).max(500))
+    .refine((text) => text.en !== undefined, "needs at least an en text");
+const periodSchema = z.union([
+    z.enum([...PERIOD_UNITS, "lifetime"]).transform((unit) => (unit === "lifetime" ? { unit } : { unit, count: 1 })),
+    z.strictObject({ unit: z.enum(PERIOD_UNITS), count: z.number().int().min(1).max(MAX_PERIOD_COUNT).default(1) }),
+    z.strictObject({ unit: z.literal("lifetime") }),
+]);
+const planSchema = z.strictObject({
+    /** Kebab-case and unique, e.g. `monthly`; the payment page and the providers name the plan by it. */
+    id: z.string().max(64, "must be at most 64 characters").regex(PLAN_ID_PATTERN, "must be kebab-case, e.g. pro-yearly"),
+    name: localizedTextSchema,
+    description: localizedTextSchema.optional(),
+    price: z.strictObject({
+        /** In the currency's minor unit: 2900 is 29.00 PLN. */
+        amount: z.number().int().min(0).max(MAX_PRICE_AMOUNT),
+        currency: z.string().refine((code) => /^[A-Z]{3}$/.test(code) && isSupportedCurrency(code), "must be an upper-case ISO 4217 currency code billing knows, e.g. PLN"),
+    }),
+    /** `"month"`, `"year"`, `"lifetime"`, or `{ unit, count }` such as `{ unit: "month", count: 3 }`. */
+    period: periodSchema,
+    features: z.array(localizedTextSchema).max(MAX_FEATURES).default([]),
+    isFeatured: z.boolean().default(false),
+});
+export const billingOptionsSchema = z.strictObject({
+    trial: z
+        .strictObject({
+        /** Length of the trial every account starts with, the registration day included; 0 for none. */
+        days: daysSchema.default(14),
+        /** From how many days left the trial notice shows; 0 never. */
+        reminderDays: daysSchema.default(3),
+        /**
+         * The first day a trial can start, `YYYY-MM-DD` in the app's time zone: an account created
+         * before it (without an entitlement row) gets its trial from this day. For turning billing on
+         * for accounts that already exist.
+         */
+        startsAt: z
+            .string()
+            .refine((day) => parseDay(day) !== null, "must be a calendar day as YYYY-MM-DD, e.g. 2026-11-01")
+            .optional(),
+    })
+        .prefault({}),
+    paid: z
+        .strictObject({
+        /** From how many days left the renewal notice shows; 0 never. Lifetime access never ends. */
+        reminderDays: daysSchema.default(7),
+    })
+        .prefault({}),
+    requests: z
+        .strictObject({
+        /**
+         * Days an open invoice request waits for the admin, counted from the buyer's last ask:
+         * `expireStaleRequests` (run daily) then closes it as `expired` and clears its invoice
+         * details. From 1 to 365.
+         */
+        expireAfterDays: z.number().int().min(1).max(MAX_DAYS).default(DEFAULT_REQUEST_EXPIRY_DAYS),
+    })
+        .prefault({}),
+    /** The plans the pricing tiles and the payment page offer, in the order they show them. */
+    plans: z
+        .array(planSchema)
+        .max(MAX_PLANS)
+        .default([])
+        .superRefine((plans, context) => {
+        const seen = new Set();
+        plans.forEach((plan, index) => {
+            if (seen.has(plan.id))
+                context.addIssue({ code: "custom", message: `repeats the plan id "${plan.id}"`, path: [index, "id"] });
+            seen.add(plan.id);
+        });
+    }),
+    /** The payment adapter, e.g. `manual({ onRequest })`; the payment page needs one. */
+    payment: z.custom(isPaymentProvider, "must be a payment provider such as manual()").optional(),
+    /**
+     * A partial refund of a provider payment: `pro_rata` takes back the share of the payment's unused
+     * days that the refunded money is of the money not refunded before (whole days, rounded down);
+     * `keep_access` takes back nothing. Either way the refund that completes the amount acts as a
+     * full refund, and a lifetime ends only then.
+     */
+    partialRefunds: z.enum(PARTIAL_REFUND_POLICIES).default("pro_rata"),
+    /** The auth role that may grant plans in the admin page; declared in `auth({ roles })` unless `admin`. */
+    adminRole: z.string().min(1).default("admin"),
+}).superRefine((options, context) => {
+    const { payment } = options;
+    if (payment?.checkPrice === undefined)
+        return;
+    options.plans.forEach((plan, index) => {
+        const problem = payment.checkPrice?.(plan.price) ?? null;
+        if (problem !== null)
+            context.addIssue({ code: "custom", message: problem, path: ["plans", index, "price"] });
+    });
+});
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"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"}

package/dist/payment.d.ts

@@ -0,0 +1,61 @@
+import type { Err, ModuleContext, Ok } from "@softure-ai/core";
+import type { Queryable } from "@softure-ai/db";
+import type { Plan, PlanPrice } from "./contract.js";
+/** The signed-in account that pays. */
+export interface PaymentAccount {
+    readonly id: string;
+    readonly email: string;
+}
+/** What an invoice needs, as the buyer typed it (trimmed). */
+export interface InvoiceDetails {
+    /** A person's or a company's name. */
+    readonly name: string;
+    /** A tax number such as a Polish NIP or an EU VAT id; null when not given. */
+    readonly taxId: string | null;
+    readonly address: string;
+}
+export interface PaymentRequest {
+    readonly plan: Plan;
+    readonly account: PaymentAccount;
+    /** The details the payment page asked for; null when the provider collects its own. */
+    readonly invoice: InvoiceDetails | null;
+    /** The payment page as an absolute URL, where a hosted checkout sends the buyer back. */
+    readonly returnUrl: string;
+}
+/** Where the buyer goes next. */
+export type PaymentStart = 
+/** A hosted checkout (e.g. a provider's payment page); the browser is sent there. */
+{
+    readonly type: "redirect";
+    readonly url: string;
+}
+/** The request was handed over (e.g. an invoice requested); access follows once it is paid. */
+ | {
+    readonly type: "requested";
+};
+export type PaymentContext = ModuleContext<Queryable>;
+/** A payment adapter for `billing({ payment })`, e.g. `manual({ onRequest })`. */
+export interface PaymentProvider {
+    /** A short lowercase name for logs, e.g. `manual`. */
+    readonly name: string;
+    /** Whether the payment page asks for invoice details before `startPayment`. */
+    readonly collectsInvoiceDetails: boolean;
+    /**
+     * Whether `startPayment` hands a request to the owner and answers `requested` (the manual
+     * adapter) rather than sending the buyer to a checkout. Such a request is stored before the
+     * call, and the call is made once per open request: asking again only refreshes the stored one.
+     */
+    readonly handsOverRequests: boolean;
+    /**
+     * Starts paying for `request.plan`. An expected failure (the provider refused, a notification
+     * could not be sent) is `billing.payment_failed`; anything thrown is a bug or an outage.
+     */
+    startPayment(ctx: PaymentContext, request: PaymentRequest): Promise<Ok<PaymentStart> | Err<"billing.payment_failed">>;
+    /**
+     * Why the provider cannot charge `price` (e.g. a fraction of its currency's unit), or null when it
+     * can. Run for every plan when the config loads, so the deployer meets it, not the buyer.
+     */
+    checkPrice?(price: PlanPrice): string | null;
+}
+export declare function isPaymentProvider(value: unknown): value is PaymentProvider;
+//# sourceMappingURL=payment.d.ts.map

package/dist/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../src/payment.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAErD,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,uFAAuF;IACvF,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,yFAAyF;IACzF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,iCAAiC;AACjC,MAAM,MAAM,YAAY;AACtB,qFAAqF;AACnF;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AACrD,+FAA+F;GAC7F;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAEnC,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;AAEtD,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACtH;;;OAGG;IACH,UAAU,CAAC,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAW1E"}

package/dist/payment.js

@@ -0,0 +1,12 @@
+export function isPaymentProvider(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const candidate = value;
+    return (typeof candidate.name === "string" &&
+        candidate.name !== "" &&
+        typeof candidate.collectsInvoiceDetails === "boolean" &&
+        typeof candidate.handsOverRequests === "boolean" &&
+        typeof candidate.startPayment === "function" &&
+        (candidate.checkPrice === undefined || typeof candidate.checkPrice === "function"));
+}
+//# sourceMappingURL=payment.js.map

package/dist/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../src/payment.ts"],"names":[],"mappings":"AAiEA,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAAwD,CAAC;IAC3E,OAAO,CACL,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;QAClC,SAAS,CAAC,IAAI,KAAK,EAAE;QACrB,OAAO,SAAS,CAAC,sBAAsB,KAAK,SAAS;QACrD,OAAO,SAAS,CAAC,iBAAiB,KAAK,SAAS;QAChD,OAAO,SAAS,CAAC,YAAY,KAAK,UAAU;QAC5C,CAAC,SAAS,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU,CAAC,CACnF,CAAC;AACJ,CAAC"}