@mj-biz-apps/orders-core-entities-server 0.0.1 → 5.2.0

package/dist/StripePaymentProvider.js

@@ -0,0 +1,442 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * StripePaymentProvider — the real PaymentIntent lifecycle, and a stub that stands in for it.
+ *
+ * STUB-FIRST, per D19. The committed default in a non-live provider is a deterministic stub: it opens
+ * an intent, succeeds on capture, and reports a plausible fee, all without a network call. That is
+ * what makes the integration suite able to exercise the payment path at all — 245 checks cannot each
+ * wait on a live gateway, and a suite that mocks at the HTTP layer instead would be asserting against
+ * its own mock.
+ *
+ * The stub is chosen by `PaymentProvider.IsLiveMode = 0`, not by an environment variable. The
+ * distinction belongs to the CONFIGURED ACCOUNT: a deployment can hold a live account and a test
+ * account side by side, and the row says which is which. An env flag would make that a property of the
+ * process, so one misconfigured server would either fake real payments or really charge test ones.
+ *
+ * NO SDK DEPENDENCY. Stripe's REST API over `fetch` is stable, and the surface used here is small —
+ * three endpoints. Adding the SDK would pull a large dependency into a package that is imported by
+ * every server process for the sake of URL construction. The trade is deliberate: we write the form
+ * encoding ourselves (`ToFormBody` below), which Stripe requires and which is the one fiddly part.
+ *
+ * WHAT IS DELIBERATELY NOT HERE. Reconciliation, dispute handling, and the forensics of a partially
+ * captured intent. D19 defers those, and the seams for them are the webhook event kinds this driver
+ * already declines to handle rather than pretends to.
+ *
+ * CONNECTS TO:
+ *   PURE:   ./PaymentProviderBehavior.ts — minor units, signature, status mapping
+ *   BASE:   ./BasePaymentProvider.ts
+ *   DOC:    plans/archive/bizapps-orders-master.md D19
+ */
+import { RegisterClass } from '@memberjunction/global';
+import { LogError } from '@memberjunction/core';
+import { BasePaymentProvider, } from './BasePaymentProvider.js';
+import { FromMinorUnits, MapStripeIntentStatus, ToMinorUnits, VerifyWebhookSignature, } from './PaymentProviderBehavior.js';
+const STRIPE_API = 'https://api.stripe.com/v1';
+/** Stripe's own event names, kept as strings because they are Stripe's vocabulary and not ours. */
+const HANDLED = [
+    'payment_intent.succeeded',
+    'payment_intent.payment_failed',
+    'payment_intent.canceled',
+    'charge.refunded',
+];
+let StripePaymentProvider = class StripePaymentProvider extends BasePaymentProvider {
+    get HandledEventKinds() {
+        return HANDLED;
+    }
+    /** The stub stands in whenever the configured account is not live. */
+    get useStub() {
+        return !this.Config?.IsLiveMode;
+    }
+    // ─── Extension points ──────────────────────────────────────────────────────
+    //
+    // Three small seams, added so a SIBLING Stripe rail (bank debits, and whatever comes after) can
+    // change the parts that differ without reimplementing the parts that do not. The alternative was a
+    // second class copying `CreateIntent`, `call`, `ToFormBody` and the error handling — four places to
+    // fix the next time Stripe changes a response shape, three of which nobody would remember to look
+    // at. Everything genuinely shared stays here; a subclass overrides only what its rail changes.
+    /**
+     * The intent status the STUB reports on creation.
+     *
+     * A card intent opens waiting for an instrument. A bank debit opens already submitted, and a stub
+     * that claimed otherwise would exercise a state the real rail never passes through.
+     */
+    get StubIntentStatus() {
+        return 'RequiresPayment';
+    }
+    /**
+     * The fee the STUB reports on capture — 2.9% + 30c, Stripe's standard US card rate.
+     *
+     * See the note at the call site for why a stub must not report zero.
+     */
+    StubFeeFor(amount, _currencyCode) {
+        return amount > 0 ? Math.round((amount * 0.029 + 0.3) * 100) / 100 : 0;
+    }
+    /**
+     * Last chance to add rail-specific fields to a `POST /payment_intents` body.
+     *
+     * Mutates rather than returns, so a subclass that forgets to call `super` cannot silently discard
+     * everything the base assembled — there is nothing to discard.
+     */
+    DecorateIntentBody(_body, _request) {
+        // Cards need nothing beyond what CreateIntent already builds.
+    }
+    // ─── Intent ────────────────────────────────────────────────────────────────
+    async CreateIntent(request) {
+        if (request.Amount <= 0) {
+            return { Success: false, Reason: `Stripe cannot open an intent for ${request.Amount}.` };
+        }
+        if (this.useStub) {
+            // Deterministic from the order, so re-running a check produces the same id and a duplicate
+            // is visible as a duplicate rather than as two unrelated intents.
+            const seed = request.OrderHeaderID ?? request.IdempotencyKey ?? 'no-order';
+            return {
+                Success: true,
+                ProviderIntentID: `pi_stub_${seed.replace(/-/g, '').slice(0, 24)}`,
+                Status: this.StubIntentStatus,
+                ClientSecret: `pi_stub_${seed.slice(0, 8)}_secret_stub`,
+            };
+        }
+        const body = {
+            amount: String(ToMinorUnits(request.Amount, request.CurrencyCode)),
+            currency: request.CurrencyCode.toLowerCase(),
+            // Off-session by default: this is a back-office confirm, not a customer at a checkout.
+            // A driver charging a saved instrument must say so or Stripe expects an interactive
+            // confirmation that will never come.
+            confirm: request.ProviderInstrumentRef ? 'true' : 'false',
+        };
+        if (request.ProviderCustomerRef)
+            body.customer = request.ProviderCustomerRef;
+        if (request.ProviderInstrumentRef) {
+            body.payment_method = request.ProviderInstrumentRef;
+            body.off_session = 'true';
+        }
+        for (const [k, v] of Object.entries(request.Metadata ?? {}))
+            body[`metadata[${k}]`] = v;
+        if (request.OrderHeaderID)
+            body['metadata[OrderHeaderID]'] = request.OrderHeaderID;
+        this.DecorateIntentBody(body, request);
+        const result = await this.call('POST', '/payment_intents', body, request.IdempotencyKey);
+        if (!result.Ok)
+            return { Success: false, Reason: result.Reason };
+        return {
+            Success: true,
+            ProviderIntentID: String(result.Body.id),
+            Status: MapStripeIntentStatus(result.Body.status),
+            ClientSecret: result.Body.client_secret,
+        };
+    }
+    async RetrieveIntent(request) {
+        if (!request.ProviderIntentID) {
+            return { Success: false, Reason: 'A Stripe retrieve needs a provider intent id.' };
+        }
+        if (this.useStub) {
+            // The stub never sees a browser confirmCardPayment; it stays RequiresPayment
+            // until Capture, matching the card rail's opening state.
+            return { Success: true, Status: this.StubIntentStatus };
+        }
+        const result = await this.call('GET', `/payment_intents/${encodeURIComponent(request.ProviderIntentID)}`);
+        if (!result.Ok) {
+            return { Success: false, Reason: result.Reason };
+        }
+        const currency = (result.Body.currency ?? 'usd').toUpperCase();
+        const minor = Number(result.Body.amount_received ?? result.Body.amount ?? 0);
+        return {
+            Success: true,
+            Status: MapStripeIntentStatus(result.Body.status),
+            Amount: Number.isFinite(minor) && minor > 0 ? FromMinorUnits(minor, currency) : undefined,
+        };
+    }
+    // ─── Capture ───────────────────────────────────────────────────────────────
+    async Capture(request) {
+        if (this.useStub) {
+            const amount = request.Amount ?? 0;
+            return {
+                Success: true,
+                Amount: amount,
+                // 2.9% + 30c, Stripe's standard US card rate. A stub that reported ZERO fee would make
+                // the fee leg of the capture entry (D18) unreachable in every test, so the one thing
+                // that must be exercised would be the one thing never exercised.
+                FeeAmount: this.StubFeeFor(amount, request.CurrencyCode),
+                ProviderChargeID: `ch_stub_${request.ProviderIntentID.slice(-12)}`,
+                Status: 'Succeeded',
+            };
+        }
+        const body = {};
+        if (request.Amount != null) {
+            body.amount_to_capture = String(ToMinorUnits(request.Amount, request.CurrencyCode));
+        }
+        const captured = await this.call('POST', `/payment_intents/${encodeURIComponent(request.ProviderIntentID)}/capture`, body);
+        if (!captured.Ok) {
+            // Browser confirmCardPayment with automatic capture already captured the intent.
+            // POST /capture then returns payment_intent_unexpected_state. Treat that as
+            // success by reading the Succeeded intent — same money, not a second capture.
+            if (stripeCaptureAlreadyCollected(captured.Reason, captured.Body)) {
+                const retrieved = await this.call('GET', `/payment_intents/${encodeURIComponent(request.ProviderIntentID)}`);
+                if (retrieved.Ok) {
+                    const retrievedStatus = MapStripeIntentStatus(retrieved.Body.status);
+                    if (retrievedStatus === 'Succeeded') {
+                        return this.captureResultFromIntent(retrieved.Body, request);
+                    }
+                }
+            }
+            return { Success: false, Reason: captured.Reason };
+        }
+        const status = MapStripeIntentStatus(captured.Body.status);
+        if (status !== 'Succeeded') {
+            // A capture that did not succeed is a REFUSAL, not a fault: the card was declined, or the
+            // intent needed action. Reporting success here would book cash that never arrived.
+            return { Success: false, Reason: `Stripe reported the intent as '${captured.Body.status}' after capture.`, Status: status };
+        }
+        return this.captureResultFromIntent(captured.Body, request);
+    }
+    // ─── Refund ────────────────────────────────────────────────────────────────
+    async Refund(request) {
+        const target = request.ProviderChargeID ?? request.ProviderIntentID;
+        if (!target) {
+            return { Success: false, Reason: 'A Stripe refund needs either a charge id or an intent id.' };
+        }
+        if (this.useStub) {
+            return {
+                Success: true,
+                Amount: request.Amount ?? 0,
+                ProviderRefundID: `re_stub_${target.slice(-12)}`,
+            };
+        }
+        const body = {};
+        if (request.ProviderChargeID)
+            body.charge = request.ProviderChargeID;
+        else
+            body.payment_intent = request.ProviderIntentID;
+        if (request.Amount != null)
+            body.amount = String(ToMinorUnits(request.Amount, request.CurrencyCode));
+        if (request.Reason)
+            body.reason = 'requested_by_customer';
+        const result = await this.call('POST', '/refunds', body, request.IdempotencyKey);
+        if (!result.Ok)
+            return { Success: false, Reason: result.Reason };
+        const currency = result.Body.currency ?? request.CurrencyCode;
+        return {
+            Success: true,
+            Amount: FromMinorUnits(Number(result.Body.amount ?? 0), currency),
+            ProviderRefundID: String(result.Body.id),
+        };
+    }
+    // ─── Webhooks ──────────────────────────────────────────────────────────────
+    async VerifyWebhook(rawBody, headers) {
+        // Header names arrive in whatever case the proxy chose, so both are read.
+        const signature = headers['stripe-signature'] ?? headers['Stripe-Signature'];
+        return VerifyWebhookSignature(rawBody, signature, this.Credentials?.WebhookSecret);
+    }
+    ParseWebhookEvent(rawBody) {
+        let parsed;
+        try {
+            parsed = JSON.parse(rawBody);
+        }
+        catch {
+            return null;
+        }
+        // VALID JSON IS NOT NECESSARILY AN OBJECT. `JSON.parse` happily returns `null` for the body
+        // `null`, and a number for `42` — both of which then threw a TypeError on the first property
+        // read, from a method whose contract is "null when it is not an event we can read". The throw
+        // escaped `HandlePaymentWebhook`'s parse step, which is not wrapped, so a body that verified
+        // and was not an object crashed the route instead of answering 400.
+        //
+        // Reachable only behind signature verification, so not an open door — but the contract is the
+        // contract, and "returns null OR throws" is not a thing a caller can branch on.
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+            return null;
+        const payload = parsed;
+        const kind = payload.type;
+        const object = (payload.data?.object ?? {});
+        if (!payload.id || !kind)
+            return null;
+        const currency = (object.currency ?? 'usd').toUpperCase();
+        const event = { EventID: String(payload.id), Kind: kind, CurrencyCode: currency };
+        const created = Number(payload.created);
+        if (Number.isFinite(created) && created > 0) {
+            event.OccurredAt = new Date(created * 1000);
+        }
+        if (kind.startsWith('payment_intent.')) {
+            event.ProviderIntentID = object.id;
+            event.ProviderChargeID = this.latestCharge(object) ?? undefined;
+            const minor = Number(object.amount_received ?? object.amount ?? 0);
+            if (Number.isFinite(minor) && minor > 0)
+                event.Amount = FromMinorUnits(minor, currency);
+            event.Status =
+                kind === 'payment_intent.payment_failed'
+                    ? 'Failed'
+                    : MapStripeIntentStatus(object.status);
+            const failure = object.last_payment_error;
+            if (failure?.message)
+                event.FailureReason = String(failure.message);
+        }
+        else if (kind === 'charge.refunded') {
+            event.ProviderChargeID = object.id;
+            event.ProviderIntentID = object.payment_intent;
+            const refunded = Number(object.amount_refunded ?? 0);
+            if (Number.isFinite(refunded) && refunded > 0)
+                event.Amount = FromMinorUnits(refunded, currency);
+        }
+        return event;
+    }
+    // ─── HTTP ──────────────────────────────────────────────────────────────────
+    /**
+     * One call, with Stripe's own error shape read out of the body.
+     *
+     * A 4xx from Stripe is usually a REFUSAL — a declined card, an intent in the wrong state — and its
+     * `error.message` is written for a human. Surfacing that rather than "HTTP 402" is the difference
+     * between a support ticket somebody can answer and one they cannot.
+     *
+     * Only transport failures and 5xx throw. Those are faults; the rest are answers.
+     */
+    async call(method, path, body, idempotencyKey) {
+        const apiKey = this.Credentials?.ApiKey;
+        if (!apiKey) {
+            return {
+                Ok: false,
+                Body: {},
+                Reason: `No Stripe API key is available for provider '${this.Config?.Name ?? this.Config?.ID}'. ` +
+                    `Its CredentialsRef must resolve to a key — see PaymentProviderResolver.`,
+            };
+        }
+        const headers = {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/x-www-form-urlencoded',
+            // Pinned deliberately. Stripe changes response shapes between versions, and inheriting
+            // whatever the account defaults to means this driver's behaviour can change without a
+            // deploy.
+            'Stripe-Version': '2024-06-20',
+        };
+        if (idempotencyKey)
+            headers['Idempotency-Key'] = idempotencyKey;
+        let response;
+        try {
+            response = await fetch(`${STRIPE_API}${path}`, {
+                method,
+                headers,
+                body: body ? ToFormBody(body) : undefined,
+            });
+        }
+        catch (err) {
+            // A fault, not an answer. The caller's payment is in an UNKNOWN state, which is worse than
+            // a decline, so it must not be reported as one.
+            throw new Error(`Stripe was unreachable calling ${method} ${path}: ${err.message}`);
+        }
+        const text = await response.text();
+        let parsed = {};
+        try {
+            parsed = text ? JSON.parse(text) : {};
+        }
+        catch {
+            parsed = {};
+        }
+        if (response.ok)
+            return { Ok: true, Body: parsed };
+        if (response.status >= 500) {
+            throw new Error(`Stripe returned ${response.status} calling ${method} ${path}. The payment state is unknown.`);
+        }
+        const error = (parsed.error ?? {});
+        const reason = error.message ?? `Stripe returned ${response.status} with no message.`;
+        LogError(`Stripe ${method} ${path} refused: ${reason}`);
+        return { Ok: false, Body: parsed, Reason: reason };
+    }
+    /**
+     * Map a Succeeded Stripe PaymentIntent body onto our CaptureResult. Shared by a real
+     * POST /capture and by the already-captured retrieve fallback so both paths stamp the
+     * same charge id and fee.
+     */
+    async captureResultFromIntent(body, request) {
+        const currency = body.currency ?? request.CurrencyCode;
+        const amountMinor = Number(body.amount_received ?? body.amount ?? 0);
+        const charge = this.latestCharge(body);
+        return {
+            Success: true,
+            Amount: FromMinorUnits(amountMinor, currency),
+            // UNDEFINED rather than zero when the fee is not expanded in the response. Stripe reports
+            // it on the balance transaction, which needs a separate fetch, and "we do not know the fee"
+            // must not read as "there was no fee" — the first leaves the fee leg unbooked, the second
+            // books a wrong one.
+            FeeAmount: await this.feeFor(charge, currency),
+            ProviderChargeID: charge ?? undefined,
+            Status: 'Succeeded',
+        };
+    }
+    /** `latest_charge` is a string on modern API versions and an object on older expanded responses. */
+    latestCharge(object) {
+        const latest = object.latest_charge;
+        if (typeof latest === 'string')
+            return latest;
+        if (latest && typeof latest === 'object')
+            return latest.id ?? null;
+        const charges = object.charges;
+        const first = charges?.data?.[0];
+        return first?.id ?? null;
+    }
+    /**
+     * The gateway's cut, from the charge's balance transaction.
+     *
+     * Returns UNDEFINED when it cannot be determined, never 0 — see the note at the call site. A failed
+     * lookup here must not silently suppress the fee leg of the capture entry, and it must not fail the
+     * capture either: the money HAS moved by this point, and refusing now would leave the ledger
+     * disagreeing with the gateway.
+     */
+    async feeFor(chargeID, currency) {
+        if (!chargeID)
+            return undefined;
+        try {
+            const charge = await this.call('GET', `/charges/${encodeURIComponent(chargeID)}?expand[]=balance_transaction`);
+            if (!charge.Ok)
+                return undefined;
+            const bt = charge.Body.balance_transaction;
+            if (!bt || typeof bt === 'string')
+                return undefined;
+            const fee = Number(bt.fee ?? NaN);
+            return Number.isFinite(fee) ? FromMinorUnits(fee, currency) : undefined;
+        }
+        catch (err) {
+            LogError(`Could not read the Stripe fee for charge ${chargeID}: ${err.message}`);
+            return undefined;
+        }
+    }
+};
+StripePaymentProvider = __decorate([
+    RegisterClass(BasePaymentProvider, 'Stripe')
+], StripePaymentProvider);
+export { StripePaymentProvider };
+/**
+ * Stripe wants `application/x-www-form-urlencoded`, including for nested keys like `metadata[Foo]`.
+ *
+ * `URLSearchParams` encodes the brackets as `%5B%5D`, which Stripe accepts — so this is a thin wrapper
+ * rather than hand-rolled escaping. It exists as a named function because the temptation to build the
+ * body with template strings is exactly how an unescaped value ends up changing the request.
+ */
+export function ToFormBody(fields) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(fields)) {
+        if (value != null)
+            params.append(key, String(value));
+    }
+    return params.toString();
+}
+/**
+ * True when Stripe refused POST /capture because the intent was already captured
+ * (automatic-capture confirmCardPayment, or a retried Capture).
+ */
+export function stripeCaptureAlreadyCollected(reason, body) {
+    const error = (body?.error ?? {});
+    const code = String(error.code ?? '');
+    const msg = `${reason ?? ''} ${String(error.message ?? '')}`.toLowerCase();
+    return (code === 'payment_intent_unexpected_state' ||
+        msg.includes('already been captured') ||
+        msg.includes('already succeeded'));
+}
+/** Tree-shaking anchor — call from the server bootstrap so @RegisterClass is retained. */
+export function LoadStripePaymentProvider() {
+    // intentionally empty
+}
+//# sourceMappingURL=StripePaymentProvider.js.map

package/dist/StripePaymentProvider.js.map

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

package/dist/SubscriptionBehavior.d.ts

@@ -0,0 +1,197 @@
+/** The rules row, as plain data. */
+export interface SubscriptionTypeRules {
+    ID: string;
+    Code: string;
+    DriverClass?: string | null;
+    SubscriberScope: 'Organization' | 'Person' | 'Either';
+    /**
+     * WHO derives the benefit — a different question from who HOLDS it, which `SubscriberScope`
+     * answers.
+     *
+     * `Holder` is NOT redundant with `Individual`, though it looks it: it means the benefit follows
+     * whoever holds the subscription, which is what a `SubscriberScope='Either'` type needs. Forcing
+     * those to `Individual` makes them demand a named person and breaks org purchases outright.
+     */
+    BenefitModel: 'Holder' | 'Individual' | 'Organization';
+    StartMode: 'Immediate' | 'Deferred' | 'CalendarAnchored';
+    DeferredStartDays?: number | null;
+    AnchorMonth?: number | null;
+    AnchorDay?: number | null;
+    PartialPeriodMode?: 'Prorate' | 'ChargeFull' | 'ExtendToNextAnchor' | null;
+    DefaultTermMonths?: number | null;
+    BillingCadence: 'Monthly' | 'Quarterly' | 'Annual' | 'Custom';
+    RecognitionCadence: 'Monthly' | 'Quarterly' | 'Annual' | 'MatchBilling';
+    CustomCycleDays?: number | null;
+    TrialDays: number;
+    ConcurrencyMode: 'AllowMultiple' | 'ExtendExisting' | 'RejectDuplicate';
+    ReactivationMode: 'ReactivateExisting' | 'AlwaysCreateNew' | 'ReactivateWithinWindow';
+    ReactivationWindowDays?: number | null;
+    AutoRenewDefault: boolean;
+    RenewalLeadDays: number;
+    CancellationMode: 'Immediate' | 'EndOfTerm' | 'EndOfBillingPeriod';
+    CancellationRefundMode: 'NoRefund' | 'ProrateUnused' | 'FullRefundWithinWindow';
+    CancellationWindowDays?: number | null;
+    GracePeriodDays: number;
+}
+/** An existing subscription this purchase might attach to. */
+export interface ExistingSubscription {
+    ID: string;
+    Status: string;
+    /** Who holds it — an explicit renewal adopts these rather than re-resolving from the line. */
+    HolderOrganizationID?: string | null;
+    BeneficiaryPersonID?: string | null;
+    /** End of the latest term, if any. */
+    LatestTermEnd?: Date | null;
+    LatestTermNumber?: number | null;
+}
+/** What the caller must do with this purchase. */
+export interface SubscriptionDecision {
+    Action: 'CreateNew' | 'ExtendExisting' | 'Reactivate' | 'Reject';
+    SubscriptionID?: string;
+    /** Term to create; absent only when Action = 'Reject'. */
+    Term?: {
+        StartDate: Date;
+        EndDate: Date;
+        TermNumber: number;
+        IsProrated: boolean;
+        ProrationFactor: number | null;
+        /** Line amount × proration — what this term actually costs. */
+        Amount: number;
+    };
+    /** Populated when Action = 'Reject'. */
+    RejectReason?: string;
+}
+/** The term being canceled, as plain data. */
+export interface CancellableTerm {
+    StartDate: Date;
+    EndDate: Date;
+    /** What was charged for this term — the ceiling on any refund. */
+    Amount: number;
+    TermNumber: number;
+}
+export interface CancellationContext {
+    Rules: SubscriptionTypeRules;
+    /** When the customer asked to cancel. */
+    RequestDate: Date;
+    /** The term whose window covers the request (or the latest one). */
+    Term: CancellableTerm;
+}
+/**
+ * What cancelling actually does. Like {@link SubscriptionDecision} this is COMPUTED ONLY — the
+ * caller performs the reversal, updates the rows, and logs the event.
+ */
+export interface CancellationDecision {
+    /** When coverage ends for revenue purposes. Never before the request, never after the term. */
+    EffectiveDate: Date;
+    /** When ACCESS ends. Equals EffectiveDate plus GracePeriodDays — grace extends access, not revenue. */
+    AccessThroughDate: Date;
+    /** What to give back. 0 under NoRefund, and never more than the term charged. */
+    RefundAmount: number;
+    /**
+     * Fraction of the term to reverse — the reversal order line's quantity is the NEGATIVE of this
+     * (plan D16). Derived from RefundAmount so the reversed revenue and the refunded cash always
+     * agree; a term cancelled with no refund reverses nothing.
+     */
+    ReversalFraction: number;
+    /**
+     * `Canceled` when coverage is cut short, `Completed` when the customer simply declines renewal
+     * and rides the term out — the difference matters for "why did this lapse" reporting.
+     */
+    TermStatus: 'Canceled' | 'Completed';
+    /** Which rules produced this, in a sentence. Surfaced to the user, so it names the policy. */
+    Explanation: string;
+}
+/**
+ * The two roles a subscription has, which `SubscriberScope` alone could not express.
+ *
+ * A trade-association company membership has an organization and no person — every employee
+ * benefits by virtue of the company holding it. An individual membership has a person. A corporate
+ * seat has both: the org holds and pays, the person benefits.
+ */
+export interface SubscriberIdentity {
+    OrganizationID?: string | null;
+    PersonID?: string | null;
+}
+export interface SubscriptionPurchaseContext {
+    Rules: SubscriptionTypeRules;
+    /** Order date — when the purchase happened. */
+    PurchaseDate: Date;
+    /** The line's net amount before proration. */
+    Amount: number;
+    /** The active/most-recent subscription for (product, subscriber), if one exists. */
+    Existing?: ExistingSubscription | null;
+    /**
+     * WHO this purchase is for, already resolved from the line's ship-to falling back to the
+     * order header. Both sides may be present: a corporate seat is held by the org and benefits a
+     * named person.
+     */
+    Subscriber: SubscriberIdentity;
+    /**
+     * True when this purchase is a RENEWAL of `Existing` rather than a fresh buy (D55).
+     *
+     * Renewals bypass `ConcurrencyMode` deliberately. That rule answers "may this subscriber hold a
+     * SECOND concurrent subscription?" — and a renewal is not a second one, it is the same one
+     * continuing. Without this, a `RejectDuplicate` type would refuse to renew itself: the engine
+     * would find an active subscription, apply the concurrency rule, and reject its own renewal
+     * order every cycle.
+     */
+    IsRenewal?: boolean;
+}
+export declare class SubscriptionBehavior {
+    /**
+     * The one entry point: given the rules and what already exists, decide what to do and compute
+     * the term. Override individual `protected` members below to customize a single aspect.
+     */
+    Decide(rawContext: SubscriptionPurchaseContext): SubscriptionDecision;
+    protected ValidateSubscriberScope(ctx: SubscriptionPurchaseContext): string | null;
+    /**
+     * The identity a duplicate is judged against — the heart of the concurrency rule.
+     *
+     * `Organization` keys on the ORG alone: a company holds ONE membership however many
+     * employees benefit, so a second purchase extends it. `Individual` keys on the PAIR, so
+     * ten seats bought for ten staff on one order are ten distinct subscriptions rather than ten
+     * collisions with each other. Getting this wrong is what made a bulk seat purchase impossible.
+     */
+    DedupeIdentity(rules: SubscriptionTypeRules, subscriber: SubscriberIdentity): SubscriberIdentity;
+    protected ChooseAction(ctx: SubscriptionPurchaseContext): SubscriptionDecision['Action'];
+    /** Immediate / Deferred / snap-forward to the calendar anchor. */
+    protected ComputeStartDate(ctx: SubscriptionPurchaseContext): Date;
+    protected ComputeEndDate(ctx: SubscriptionPurchaseContext, start: Date, extending: boolean): Date;
+    /**
+     * Only `Prorate` actually reduces the amount. `ChargeFull` deliberately charges a whole term for
+     * a partial window — the customer pays full freight to join mid-cycle — and
+     * `ExtendToNextAnchor` has no partial window at all.
+     */
+    protected ComputeProration(ctx: SubscriptionPurchaseContext, start: Date, end: Date, extending: boolean): {
+        isProrated: boolean;
+        factor: number;
+    };
+    /** The next occurrence of AnchorMonth/AnchorDay strictly after `from`. */
+    protected NextAnchor(ctx: SubscriptionPurchaseContext, from: Date): Date;
+    protected MonthsForCadence(cadence: SubscriptionTypeRules['BillingCadence'], customDays?: number | null): number;
+    /** Months per recognition slice — `MatchBilling` follows the billing cadence. */
+    RecognitionMonths(rules: SubscriptionTypeRules): number;
+    /**
+     * Apply the type's cancellation rules to a request. Pure — computes dates and amounts, touches
+     * nothing. Override any protected piece below to change one aspect.
+     */
+    DecideCancellation(rawContext: CancellationContext): CancellationDecision;
+    /** When coverage ends, per `CancellationMode`. */
+    protected ComputeCancellationDate(ctx: CancellationContext): Date;
+    /**
+     * The last day of the billing cycle the request falls in. Cycles are counted forward from the
+     * TERM START, not from the request — a monthly subscription started on the 12th bills on the
+     * 12th, and cancelling on the 20th runs to the 11th of the next month.
+     */
+    protected EndOfBillingPeriod(ctx: CancellationContext): Date;
+    /** Cancellation never resurrects a finished term, and never ends coverage before it began. */
+    protected ClampToTerm(ctx: CancellationContext, date: Date): Date;
+    /** What to give back, per `CancellationRefundMode`. */
+    protected ComputeRefund(ctx: CancellationContext, effective: Date): {
+        amount: number;
+        explanation: string;
+    };
+}
+/** Tree-shaking anchor — the base behaviour must be registered before booking runs. */
+export declare function LoadSubscriptionBehavior(): void;
+//# sourceMappingURL=SubscriptionBehavior.d.ts.map