@softure-ai/billing 0.0.0-stage → 0.1.5

package/dist/index.d.ts

@@ -0,0 +1,274 @@
+export declare const MODULE_ID = "billing";
+/**
+ * The rate limit bucket payments consume, with its default to spread into `security({ buckets })`:
+ * `billing-payment` per account (a payment page sent again and again).
+ */
+export declare const BILLING_RATE_LIMIT_BUCKETS: {
+    readonly "billing-payment": {
+        readonly limit: 5;
+        readonly windowMinutes: 60;
+    };
+};
+/**
+ * Enables entitlements, plans and payments in `softure.config.ts` (after `security` and `auth`):
+ * `billing({ trial: { days: 14 }, plans: [{ id: "monthly", name: { en: "Monthly" }, price: { amount: 2900, currency: "PLN" }, period: "month" }], payment: stripe() })`
+ * (or `manual({ onRequest })` for invoices).
+ */
+export declare const billing: import("@softure-ai/core").ModuleFactory<{
+    payment: string;
+    admin: string;
+    webhook: string;
+}, {
+    badge: {
+        trial: string;
+        paid: string;
+        lifetime: string;
+        readOnly: string;
+        daysLeft: {
+            one: string;
+            few: string;
+            many: string;
+            other: string;
+        };
+        until: string;
+    };
+    notice: {
+        trialEnding: string;
+        paidEnding: string;
+        trialEnded: string;
+        paidEnded: string;
+        choosePlan: string;
+        renew: string;
+    };
+    reminderMail: {
+        trialEnding: {
+            subject: string;
+            body: string;
+        };
+        paidEnding: {
+            subject: string;
+            body: string;
+        };
+        trialEnded: {
+            subject: string;
+            body: string;
+        };
+        paidEnded: {
+            subject: string;
+            body: string;
+        };
+    };
+    pricing: {
+        period: {
+            day: {
+                one: string;
+                few: string;
+                many: string;
+                other: string;
+            };
+            week: {
+                one: string;
+                few: string;
+                many: string;
+                other: string;
+            };
+            month: {
+                one: string;
+                few: string;
+                many: string;
+                other: string;
+            };
+            year: {
+                one: string;
+                few: string;
+                many: string;
+                other: string;
+            };
+            lifetime: string;
+        };
+        featured: string;
+        choose: string;
+        empty: string;
+    };
+    payment: {
+        title: string;
+        lead: string;
+        plansLabel: string;
+        orderTitle: string;
+        orderLead: string;
+        changePlan: string;
+        invoiceLead: string;
+        fields: {
+            name: string;
+            taxId: string;
+            address: string;
+        };
+        requestInvoice: string;
+        checkout: string;
+        pending: string;
+        requested: string;
+        checkoutSuccess: string;
+        checkoutCancelled: string;
+        lifetime: string;
+    };
+    admin: {
+        title: string;
+        lead: string;
+        email: string;
+        plan: string;
+        submit: string;
+        pending: string;
+        granted: string;
+        grantedUntil: string;
+        noPlans: string;
+        requests: {
+            title: string;
+            lead: string;
+            empty: string;
+            line: string;
+            requestedOn: string;
+            price: string;
+            invoice: string;
+            taxId: string;
+            noInvoice: string;
+            grant: string;
+            granting: string;
+            dismiss: string;
+            dismissing: string;
+            history: string;
+            grantLabel: string;
+            dismissLabel: string;
+        };
+        history: {
+            title: string;
+            lead: string;
+            email: string;
+            submit: string;
+            pending: string;
+            accountTitle: string;
+            empty: string;
+            manual: string;
+            fromRequest: string;
+            provider: string;
+            grantedOn: string;
+            grantedFor: string;
+            paidOn: string;
+            period: string;
+            lifetime: string;
+            noGrant: string;
+            active: string;
+            revokedOn: string;
+            paid: string;
+            refundedOn: string;
+            partlyRefunded: string;
+            revoke: string;
+            revoking: string;
+            revokeLabel: string;
+        };
+    };
+    errors: {
+        billing: {
+            read_only: string;
+            account_unknown: string;
+            end_not_in_future: string;
+            plan_unknown: string;
+            invoice_details_invalid: string;
+            invoice_field_required: string;
+            invoice_field_too_long: string;
+            invoice_field_control_characters: string;
+            payment_failed: string;
+            lifetime_active: string;
+            request_closed: string;
+            grant_revoked: string;
+        };
+        security: {
+            rate_limited: string;
+        };
+        auth: {
+            forbidden: string;
+        };
+        core: {
+            database_failed: string;
+            unexpected: string;
+        };
+    };
+}, import("zod").ZodObject<{
+    trial: import("zod").ZodPrefault<import("zod").ZodObject<{
+        days: import("zod").ZodDefault<import("zod").ZodNumber>;
+        reminderDays: import("zod").ZodDefault<import("zod").ZodNumber>;
+        startsAt: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strict>>;
+    paid: import("zod").ZodPrefault<import("zod").ZodObject<{
+        reminderDays: import("zod").ZodDefault<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strict>>;
+    requests: import("zod").ZodPrefault<import("zod").ZodObject<{
+        expireAfterDays: import("zod").ZodDefault<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strict>>;
+    plans: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        name: import("zod").ZodRecord<import("zod").ZodEnum<{
+            en: "en";
+            pl: "pl";
+        }> & import("zod/v4/core").$partial, import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodEnum<{
+            en: "en";
+            pl: "pl";
+        }> & import("zod/v4/core").$partial, import("zod").ZodString>>;
+        price: import("zod").ZodObject<{
+            amount: import("zod").ZodNumber;
+            currency: import("zod").ZodString;
+        }, import("zod/v4/core").$strict>;
+        period: import("zod").ZodUnion<readonly [import("zod").ZodPipe<import("zod").ZodEnum<{
+            year: "year";
+            month: "month";
+            day: "day";
+            lifetime: "lifetime";
+            week: "week";
+        }>, import("zod").ZodTransform<{
+            readonly unit: import("./contract.js").PeriodUnit;
+            readonly count: number;
+        } | {
+            readonly unit: "lifetime";
+        }, "year" | "month" | "day" | "lifetime" | "week">>, import("zod").ZodObject<{
+            unit: import("zod").ZodEnum<{
+                year: "year";
+                month: "month";
+                day: "day";
+                week: "week";
+            }>;
+            count: import("zod").ZodDefault<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+            unit: import("zod").ZodLiteral<"lifetime">;
+        }, import("zod/v4/core").$strict>]>;
+        features: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodEnum<{
+            en: "en";
+            pl: "pl";
+        }> & import("zod/v4/core").$partial, import("zod").ZodString>>>;
+        isFeatured: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$strict>>>;
+    payment: import("zod").ZodOptional<import("zod").ZodCustom<import("./payment.js").PaymentProvider, import("./payment.js").PaymentProvider>>;
+    partialRefunds: import("zod").ZodDefault<import("zod").ZodEnum<{
+        pro_rata: "pro_rata";
+        keep_access: "keep_access";
+    }>>;
+    adminRole: import("zod").ZodDefault<import("zod").ZodString>;
+}, import("zod/v4/core").$strict>>;
+export { getDayNumber, getDaysLeft, getStartOfDay, getTrialEnd, parseDay } from "./calendar.js";
+export { ENTITLEMENT_STATUSES, INITIAL_ADMIN_ACTION_STATE, INITIAL_GRANT_FORM_STATE, INITIAL_PAYMENT_FORM_STATE, PERIOD_UNITS, type AdminActionErrorCode, type AdminActionState, type AdminErrorCode, type BillingErrorCode, type BillingFormErrorCode, type Entitlement, type EntitlementEvent, type EntitlementRecord, type EntitlementStatus, type GrantFormErrorCode, type GrantFormState, type LocalizedText, type PaymentErrorCode, type PaymentFormErrorCode, type PaymentFormState, type PaymentGrant, type PeriodUnit, type Plan, type PlanPeriod, type PlanPrice, } from "./contract.js";
+export { applyEntitlementEvent, hasWriteAccess, resolveEntitlement, type EntitlementPolicy } from "./entitlement.js";
+export { CHECKOUT_PARAM, CHECKOUT_RESULTS, type CheckoutResult } from "./fields.js";
+export { invoiceDetailsSchema, type InvoiceFieldErrorCode } from "./invoice.js";
+export { manual, type ManualPaymentOptions } from "./manual.js";
+export { billingMessages, getBillingErrorMessage, type BillingMessages } from "./messages/index.js";
+export { DEFAULT_REQUEST_EXPIRY_DAYS, MAX_DAYS, MAX_FEATURES, MAX_PERIOD_COUNT, MAX_PLANS, MAX_PRICE_AMOUNT, PARTIAL_REFUND_POLICIES, type PartialRefundPolicy, type BillingOptions, type BillingOptionsInput, } from "./options.js";
+export { isPaymentProvider, type InvoiceDetails, type PaymentAccount, type PaymentContext, type PaymentProvider, type PaymentRequest, type PaymentStart, } from "./payment.js";
+export { findPlan, getLocalizedText, getPeriodEnd, getPlanGrant } from "./plans.js";
+export { getPaymentGrant, getRefundEvent, getRestoredDays, getTakenBackDays, getUnusedDays, isFullShare, moveBackByDays, moveForwardByDays, type RefundShare, type RefundTiming, type RestoredDaysInput, } from "./refund.js";
+export { ACCESS_REMINDER_KINDS, DEFAULT_CATCH_UP_DAYS, getAccessReminder, getAccessReminderScope, MAX_CATCH_UP_DAYS, type AccessReminder, type AccessReminderInput, type AccessReminderKind, } from "./reminder.js";
+export { CURRENCY_MINOR_UNIT_DIGITS } from "./currency-digits.js";
+export { formatPrice, getMinorUnitDigits, isSupportedCurrency } from "./price.js";
+export { billingSchema, entitlements, manualGrants, paymentRequests, payments } from "./schema.js";
+export { getCheckoutSessionParams, stripe, STRIPE_API_BASE, STRIPE_SECRET_KEY_ENV, STRIPE_TIMEOUT_MS, type StripeOptions } from "./stripe.js";
+export { describeStripePriceProblem, fromStripeAmount, getStripeMinorUnitDigits, STRIPE_THREE_DECIMAL_CURRENCIES, STRIPE_ZERO_DECIMAL_CURRENCIES, toStripeAmount, } from "./stripe-currency.js";
+export { parseStripeEvent, readStripeWebhook, signStripePayload, STRIPE_METADATA, STRIPE_SIGNATURE_HEADER, STRIPE_SIGNATURE_TOLERANCE_SECONDS, verifyStripeSignature, type FailedRefund, type PaidCheckout, type SignStripePayloadInput, type StripeWebhookError, type StripeWebhookEvent, type VerifyStripeSignatureInput, } from "./stripe-webhook.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,73 @@
+// Public API of @softure-ai/billing: the module factory for softure.config.ts, its rate limit bucket,
+// the manual and Stripe payment adapters, Stripe's webhook signature, the pure entitlement state
+// machine and plan periods, prices, types, messages and the tables. Reading and changing
+// entitlements, granting plans, starting payments and recording provider payments is in
+// `@softure-ai/billing/server`, the Next.js adapter (write guard, payment and admin pages, actions,
+// the Stripe webhook route, current badge and notice) in `/next`, the components in `/ui`.
+import { defineModule, resolveMigrationsDir } from "@softure-ai/core";
+import { billingMessages } from "./messages/index.js";
+import { billingOptionsSchema } from "./options.js";
+import { checkBillingTables } from "./server/health.js";
+import { billingPrivacyContributor } from "./server/privacy.js";
+export const MODULE_ID = "billing";
+/**
+ * The rate limit bucket payments consume, with its default to spread into `security({ buckets })`:
+ * `billing-payment` per account (a payment page sent again and again).
+ */
+export const BILLING_RATE_LIMIT_BUCKETS = {
+    "billing-payment": { limit: 5, windowMinutes: 60 },
+};
+/**
+ * Enables entitlements, plans and payments in `softure.config.ts` (after `security` and `auth`):
+ * `billing({ trial: { days: 14 }, plans: [{ id: "monthly", name: { en: "Monthly" }, price: { amount: 2900, currency: "PLN" }, period: "month" }], payment: stripe() })`
+ * (or `manual({ onRequest })` for invoices).
+ */
+export const billing = defineModule({
+    manifest: {
+        id: MODULE_ID,
+        version: "0.1.5",
+        dependsOn: { security: "^0.1.0", auth: "^0.1.0" },
+        dbSchema: "billing",
+        tables: ["entitlements", "payments", "payment_requests", "manual_grants"],
+        env: [
+            {
+                name: "STRIPE_SECRET_KEY",
+                required: false,
+                description: "Secret API key of the stripe() payment adapter (sk_test_... in the sandbox), read on every payment; not needed with stripe({ secretKey }) or another adapter.",
+            },
+            {
+                name: "STRIPE_WEBHOOK_SECRET",
+                required: false,
+                description: "Signing secret (whsec_...) of the Stripe webhook endpoint that points at stripeWebhookRoute; required when that route is mounted.",
+            },
+        ],
+        switches: [],
+        routes: { payment: "/payment", admin: "/admin/billing", webhook: "/api/billing/webhook" },
+        mount: [{ kind: "route-handler", path: "app/api/billing/webhook/route.ts", export: "stripeWebhookRoute" }],
+        privacy: { exports: true, deletes: true },
+    },
+    messages: billingMessages,
+    options: billingOptionsSchema,
+    migrations: { dir: resolveMigrationsDir(import.meta.url, "../migrations/") },
+    privacy: billingPrivacyContributor,
+    health: checkBillingTables,
+});
+export { getDayNumber, getDaysLeft, getStartOfDay, getTrialEnd, parseDay } from "./calendar.js";
+export { ENTITLEMENT_STATUSES, INITIAL_ADMIN_ACTION_STATE, INITIAL_GRANT_FORM_STATE, INITIAL_PAYMENT_FORM_STATE, PERIOD_UNITS, } from "./contract.js";
+export { applyEntitlementEvent, hasWriteAccess, resolveEntitlement } from "./entitlement.js";
+export { CHECKOUT_PARAM, CHECKOUT_RESULTS } from "./fields.js";
+export { invoiceDetailsSchema } from "./invoice.js";
+export { manual } from "./manual.js";
+export { billingMessages, getBillingErrorMessage } from "./messages/index.js";
+export { DEFAULT_REQUEST_EXPIRY_DAYS, MAX_DAYS, MAX_FEATURES, MAX_PERIOD_COUNT, MAX_PLANS, MAX_PRICE_AMOUNT, PARTIAL_REFUND_POLICIES, } from "./options.js";
+export { isPaymentProvider, } from "./payment.js";
+export { findPlan, getLocalizedText, getPeriodEnd, getPlanGrant } from "./plans.js";
+export { getPaymentGrant, getRefundEvent, getRestoredDays, getTakenBackDays, getUnusedDays, isFullShare, moveBackByDays, moveForwardByDays, } from "./refund.js";
+export { ACCESS_REMINDER_KINDS, DEFAULT_CATCH_UP_DAYS, getAccessReminder, getAccessReminderScope, MAX_CATCH_UP_DAYS, } from "./reminder.js";
+export { CURRENCY_MINOR_UNIT_DIGITS } from "./currency-digits.js";
+export { formatPrice, getMinorUnitDigits, isSupportedCurrency } from "./price.js";
+export { billingSchema, entitlements, manualGrants, paymentRequests, payments } from "./schema.js";
+export { getCheckoutSessionParams, stripe, STRIPE_API_BASE, STRIPE_SECRET_KEY_ENV, STRIPE_TIMEOUT_MS } from "./stripe.js";
+export { describeStripePriceProblem, fromStripeAmount, getStripeMinorUnitDigits, STRIPE_THREE_DECIMAL_CURRENCIES, STRIPE_ZERO_DECIMAL_CURRENCIES, toStripeAmount, } from "./stripe-currency.js";
+export { parseStripeEvent, readStripeWebhook, signStripePayload, STRIPE_METADATA, STRIPE_SIGNATURE_HEADER, STRIPE_SIGNATURE_TOLERANCE_SECONDS, verifyStripeSignature, } from "./stripe-webhook.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/invoice.d.ts

@@ -0,0 +1,29 @@
+import { type Err, type Ok } from "@softure-ai/core";
+import { z } from "zod";
+import { type InvoiceField } from "./fields.js";
+import type { InvoiceDetails } from "./payment.js";
+/** Invoice details as the form sent them, untrimmed. */
+export interface InvoiceInput {
+    readonly name: string;
+    readonly taxId: string;
+    readonly address: string;
+}
+/** Why one invoice field was refused. */
+export type InvoiceFieldErrorCode = 
+/** The name or the address is empty. */
+"billing.invoice_field_required"
+/** Longer than `INVOICE_LIMITS` allows the field. */
+ | "billing.invoice_field_too_long"
+/** A line break, a tab or another control character. */
+ | "billing.invoice_field_control_characters";
+export type InvoiceDetailsError = Err<"billing.invoice_details_invalid"> & {
+    readonly fieldErrors: Readonly<Partial<Record<InvoiceField, InvoiceFieldErrorCode>>>;
+};
+export declare const invoiceDetailsSchema: z.ZodObject<{
+    name: z.ZodString;
+    taxId: z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>;
+    address: z.ZodString;
+}, z.core.$strict>;
+/** Trimmed invoice details, or the first problem of each field that has one. */
+export declare function parseInvoiceDetails(input: InvoiceInput): Ok<InvoiceDetails> | InvoiceDetailsError;
+//# sourceMappingURL=invoice.d.ts.map

package/dist/invoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.d.ts","sourceRoot":"","sources":["../src/invoice.ts"],"names":[],"mappings":"AAIA,OAAO,EAAW,KAAK,GAAG,EAAE,KAAK,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,yCAAyC;AACzC,MAAM,MAAM,qBAAqB;AAC/B,wCAAwC;AACtC,gCAAgC;AAClC,qDAAqD;GACnD,gCAAgC;AAClC,wDAAwD;GACtD,0CAA0C,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAAG,GAAG,CAAC,iCAAiC,CAAC,GAAG;IACzE,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;CACtF,CAAC;AAaF,eAAO,MAAM,oBAAoB;;;;kBAI/B,CAAC;AAEH,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,EAAE,CAAC,cAAc,CAAC,GAAG,mBAAmB,CAUjG"}

package/dist/invoice.js

@@ -0,0 +1,35 @@
+// Invoice details as the payment form sends them, parsed at the boundary by a zod schema: each
+// field trimmed, the name and the address required, each within its limit, and no control
+// characters (Unicode Cc: line breaks, tabs, escapes) anywhere, so a name cannot add lines to the
+// owner's mail. Every field problem has its own code, so the form says what to fix.
+import { err, ok } from "@softure-ai/core";
+import { z } from "zod";
+import { INVOICE_FIELDS, INVOICE_LIMITS } from "./fields.js";
+const CONTROL_CHARACTER = /\p{Cc}/u;
+function createFieldSchema(limit, isRequired) {
+    return z
+        .string()
+        .trim()
+        .refine((value) => !CONTROL_CHARACTER.test(value), { message: "billing.invoice_field_control_characters", abort: true })
+        .refine((value) => !isRequired || value !== "", { message: "billing.invoice_field_required", abort: true })
+        .refine((value) => value.length <= limit, { message: "billing.invoice_field_too_long", abort: true });
+}
+export const invoiceDetailsSchema = z.strictObject({
+    name: createFieldSchema(INVOICE_LIMITS.name, true),
+    taxId: createFieldSchema(INVOICE_LIMITS.taxId, false).transform((taxId) => (taxId === "" ? null : taxId)),
+    address: createFieldSchema(INVOICE_LIMITS.address, true),
+});
+/** Trimmed invoice details, or the first problem of each field that has one. */
+export function parseInvoiceDetails(input) {
+    const parsed = invoiceDetailsSchema.safeParse({ name: input.name, taxId: input.taxId, address: input.address });
+    if (parsed.success)
+        return ok(parsed.data);
+    const fieldErrors = {};
+    for (const issue of parsed.error.issues) {
+        const key = issue.path[0];
+        // Each refinement's message is one of the codes above; the first problem of a field wins.
+        fieldErrors[INVOICE_FIELDS[key]] ??= issue.message;
+    }
+    return { ...err("billing.invoice_details_invalid"), fieldErrors };
+}
+//# sourceMappingURL=invoice.js.map

package/dist/invoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.js","sourceRoot":"","sources":["../src/invoice.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,0FAA0F;AAC1F,kGAAkG;AAClG,oFAAoF;AACpF,OAAO,EAAE,GAAG,EAAE,EAAE,EAAqB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAuBhF,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAEpC,SAAS,iBAAiB,CAAC,KAAa,EAAE,UAAmB;IAC3D,OAAO,CAAC;SACL,MAAM,EAAE;SACR,IAAI,EAAE;SACN,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SACvH,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,UAAU,IAAI,KAAK,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SAC1G,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1G,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,YAAY,CAAC;IACjD,IAAI,EAAE,iBAAiB,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC;IAClD,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACzG,OAAO,EAAE,iBAAiB,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC;CACzD,CAAC,CAAC;AAEH,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CAAC,KAAmB;IACrD,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChH,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAyD,EAAE,CAAC;IAC7E,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAgC,CAAC;QACzD,0FAA0F;QAC1F,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,OAAgC,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,GAAG,GAAG,CAAC,iCAAiC,CAAC,EAAE,WAAW,EAAE,CAAC;AACpE,CAAC"}

package/dist/mailing/index.d.ts

@@ -0,0 +1,2 @@
+export { DEFAULT_REMINDER_PAUSE_MS, renderAccessReminderMail, sendAccessReminders, type AccessReminderMail, type AccessReminderMailInput, type AccessReminderSummary, type SendAccessRemindersOptions, } from "./reminder-mail.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mailing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mailing/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,GAChC,MAAM,oBAAoB,CAAC"}

package/dist/mailing/index.js

@@ -0,0 +1,4 @@
+// The mailing adapter of @softure-ai/billing: reminder mail before and after access ends, through
+// `@softure-ai/mailing` (an optional peer dependency; only apps that import this entry need it).
+export { DEFAULT_REMINDER_PAUSE_MS, renderAccessReminderMail, sendAccessReminders, } from "./reminder-mail.js";
+//# sourceMappingURL=index.js.map

package/dist/mailing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mailing/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,iGAAiG;AACjG,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,GAKpB,MAAM,oBAAoB,CAAC"}

package/dist/mailing/reminder-mail.d.ts

@@ -0,0 +1,50 @@
+import { type ModuleContext } from "@softure-ai/core";
+import type { Queryable } from "@softure-ai/db";
+import type { OutgoingMail } from "@softure-ai/mailing";
+import type { BillingMessages } from "../messages/index.js";
+import { type AccessReminderKind } from "../reminder.js";
+import { type FindAccessRemindersOptions } from "../server/reminders.js";
+/** Pause between two mails a provider was called for: Resend allows two requests per second. */
+export declare const DEFAULT_REMINDER_PAUSE_MS = 500;
+export interface AccessReminderMailInput {
+    readonly kind: AccessReminderKind;
+    /** The last day with access, as the app's locale writes it (`formatLastDay`). */
+    readonly lastDay: string;
+    /** The payment page's absolute URL. */
+    readonly link: string;
+}
+/** The subject and bodies of a reminder mail, without the recipient. */
+export type AccessReminderMail = Pick<OutgoingMail, "subject" | "text"> & {
+    readonly html: string;
+};
+export interface SendAccessRemindersOptions extends FindAccessRemindersOptions {
+    /** Milliseconds to wait after each mail a provider was called for. Default 500; 0 never waits. */
+    readonly pauseMs?: number;
+    /** How to wait; tests pass their own. */
+    readonly sleep?: (ms: number) => Promise<void>;
+}
+export interface AccessReminderSummary {
+    /** Accounts due a reminder this run. */
+    readonly due: number;
+    /** Mails sent now. */
+    readonly sent: number;
+    /** Mails an earlier run sent (or refused), or another run is sending right now. */
+    readonly skipped: number;
+    /** Mails refused for good (an invalid address, the provider rejected it). */
+    readonly rejected: number;
+    /** Mails the provider could not take now; the next run sends them. */
+    readonly retryLater: number;
+}
+/**
+ * Renders a reminder from `messages` (one locale's dictionary, overrides applied): a plain-text body
+ * with the notice's link text and the bare link, and an HTML body with the link as an anchor.
+ */
+export declare function renderAccessReminderMail(messages: BillingMessages, input: AccessReminderMailInput): AccessReminderMail;
+/**
+ * Mails every account due a reminder (`findAccessReminders`) through mailing's delivery ledger, so
+ * each account gets one mail per kind and end however often the run repeats or overlaps. Call it
+ * on a schedule (a daily cron job running a script). Needs `mailing({ ... })` in the config; a
+ * database failure propagates (the next run resumes, and the ledger keeps it from mailing twice).
+ */
+export declare function sendAccessReminders(ctx: ModuleContext<Queryable>, options?: SendAccessRemindersOptions): Promise<AccessReminderSummary>;
+//# sourceMappingURL=reminder-mail.d.ts.map

package/dist/mailing/reminder-mail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-mail.d.ts","sourceRoot":"","sources":["../../src/mailing/reminder-mail.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAAuB,KAAK,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAG9F,gGAAgG;AAChG,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wEAAwE;AACxE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,MAAM,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG,MAAM,WAAW,0BAA2B,SAAQ,0BAA0B;IAC5E,kGAAkG;IAClG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAeD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAStH;AAMD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,OAAO,GAAE,0BAA+B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAqBjJ"}

package/dist/mailing/reminder-mail.js

@@ -0,0 +1,71 @@
+// The reminder mail: the in-app notice's four states as a mail, sent once per account, kind and
+// end through `@softure-ai/mailing`'s delivery ledger. A transactional mail (an account notice): no
+// unsubscribe link, never suppressed. The copy comes from billing's dictionary in the app's locale;
+// the link to the payment page is placed by the code, so a copy override cannot drop it.
+import { formatMessage } from "@softure-ai/core";
+import { deliverOnce } from "@softure-ai/mailing/server";
+import { getAccessReminderScope } from "../reminder.js";
+import { getBillingMessages, getBillingRoutes } from "../server/options.js";
+import { findAccessReminders } from "../server/reminders.js";
+import { formatLastDay } from "../ui/format.js";
+/** Pause between two mails a provider was called for: Resend allows two requests per second. */
+export const DEFAULT_REMINDER_PAUSE_MS = 500;
+const COPY_KEYS = {
+    "trial-ending": "trialEnding",
+    "paid-ending": "paidEnding",
+    "trial-ended": "trialEnded",
+    "paid-ended": "paidEnded",
+};
+const HTML_ESCAPES = { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" };
+function escapeHtml(value) {
+    return value.replace(/[&<>"']/g, (character) => HTML_ESCAPES[character] ?? character);
+}
+/**
+ * Renders a reminder from `messages` (one locale's dictionary, overrides applied): a plain-text body
+ * with the notice's link text and the bare link, and an HTML body with the link as an anchor.
+ */
+export function renderAccessReminderMail(messages, input) {
+    const copy = messages.reminderMail[COPY_KEYS[input.kind]];
+    const action = input.kind.startsWith("trial-") ? messages.notice.choosePlan : messages.notice.renew;
+    const values = { date: input.lastDay };
+    const subject = formatMessage(copy.subject, values);
+    const body = formatMessage(copy.body, values);
+    const text = [body, `${action}: ${input.link}`].join("\n\n");
+    const html = [`<p>${escapeHtml(body)}</p>`, `<p><a href="${escapeHtml(input.link)}">${escapeHtml(action)}</a></p>`].join("\n");
+    return { subject, text, html };
+}
+function wait(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Mails every account due a reminder (`findAccessReminders`) through mailing's delivery ledger, so
+ * each account gets one mail per kind and end however often the run repeats or overlaps. Call it
+ * on a schedule (a daily cron job running a script). Needs `mailing({ ... })` in the config; a
+ * database failure propagates (the next run resumes, and the ledger keeps it from mailing twice).
+ */
+export async function sendAccessReminders(ctx, options = {}) {
+    const { pauseMs = DEFAULT_REMINDER_PAUSE_MS, sleep = wait, ...findOptions } = options;
+    const due = await findAccessReminders(ctx, findOptions);
+    const messages = getBillingMessages(ctx.config);
+    const link = new URL(getBillingRoutes(ctx.config).payment, ctx.config.appOrigin).href;
+    const counts = { sent: 0, skipped: 0, rejected: 0, retryLater: 0 };
+    for (const reminder of due) {
+        const lastDay = formatLastDay(reminder.endsAt, ctx.config.locale, ctx.config.timezone);
+        const mail = renderAccessReminderMail(messages, { kind: reminder.kind, lastDay, link });
+        const outcome = await deliverOnce(ctx, { scope: getAccessReminderScope(reminder.kind, reminder.userId, reminder.endsAt), mail: { to: reminder.email, ...mail } });
+        if (outcome.status === "done" || outcome.status === "in-flight") {
+            counts.skipped += 1;
+            continue;
+        }
+        if (outcome.status === "sent")
+            counts.sent += 1;
+        else if (outcome.status === "rejected")
+            counts.rejected += 1;
+        else
+            counts.retryLater += 1;
+        if (pauseMs > 0)
+            await sleep(pauseMs);
+    }
+    return { due: due.length, ...counts };
+}
+//# sourceMappingURL=reminder-mail.js.map

package/dist/mailing/reminder-mail.js.map

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

package/dist/manual.d.ts

@@ -0,0 +1,12 @@
+import { type Err, type ErrorCode, type Ok } from "@softure-ai/core";
+import type { PaymentContext, PaymentProvider, PaymentRequest } from "./payment.js";
+export interface ManualPaymentOptions {
+    /**
+     * Hands a request to the owner. An `Err` tells the buyer the request did not go through
+     * (`billing.payment_failed`, its code is logged); a throw is reported as an unexpected failure.
+     */
+    readonly onRequest: (request: PaymentRequest, ctx: PaymentContext) => Promise<Ok<undefined> | Err<ErrorCode>>;
+}
+/** `billing({ payment: manual({ onRequest }) })`: invoices requested by the buyer, access granted by an admin. */
+export declare function manual(options: ManualPaymentOptions): PaymentProvider;
+//# sourceMappingURL=manual.d.ts.map

package/dist/manual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.d.ts","sourceRoot":"","sources":["../src/manual.ts"],"names":[],"mappings":"AAIA,OAAO,EAAW,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,KAAK,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;CAC/G;AAED,kHAAkH;AAClH,wBAAgB,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,eAAe,CAcrE"}

package/dist/manual.js

@@ -0,0 +1,22 @@
+// The manual payment adapter: the buyer asks for an invoice on the payment page, the app hands the
+// request to its owner (`onRequest`: a mail, a ticket), and the owner grants the plan in the admin
+// page once the invoice is paid. Nothing is charged here; `startPayment` stores the request before
+// it is handed over, so the admin page lists it, and hands an open request over once.
+import { err, ok } from "@softure-ai/core";
+/** `billing({ payment: manual({ onRequest }) })`: invoices requested by the buyer, access granted by an admin. */
+export function manual(options) {
+    return {
+        name: "manual",
+        collectsInvoiceDetails: true,
+        handsOverRequests: true,
+        async startPayment(ctx, request) {
+            const handed = await options.onRequest(request, ctx);
+            if (!handed.ok) {
+                console.error(`@softure-ai/billing: the manual payment request for plan "${request.plan.id}" was not handed over: ${handed.error}`);
+                return err("billing.payment_failed");
+            }
+            return ok({ type: "requested" });
+        },
+    };
+}
+//# sourceMappingURL=manual.js.map

package/dist/manual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.js","sourceRoot":"","sources":["../src/manual.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,mGAAmG;AACnG,mGAAmG;AACnG,sFAAsF;AACtF,OAAO,EAAE,GAAG,EAAE,EAAE,EAAqC,MAAM,kBAAkB,CAAC;AAW9E,kHAAkH;AAClH,MAAM,UAAU,MAAM,CAAC,OAA6B;IAClD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,sBAAsB,EAAE,IAAI;QAC5B,iBAAiB,EAAE,IAAI;QACvB,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO;YAC7B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACrD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,6DAA6D,OAAO,CAAC,IAAI,CAAC,EAAE,0BAA0B,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;gBACpI,OAAO,GAAG,CAAC,wBAAwB,CAAC,CAAC;YACvC,CAAC;YACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC"}