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

package/dist/SubscriptionBehavior.d.ts.map

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

package/dist/SubscriptionBehavior.js

@@ -0,0 +1,415 @@
+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;
+};
+/**
+ * Subscription behaviour — the rules engine over `SubscriptionType` (plan D45).
+ *
+ * PATTERN — deliberately DIFFERENT from RevenueRecognitionDriver (D43):
+ *
+ *   RevRec is BEHAVIOUR-first. The type row names a driver, and the driver computes everything,
+ *   because "how is revenue earned over time" is genuinely an algorithm.
+ *
+ *   Subscriptions are DATA-first. Anchor dates, cadences, concurrency, grace windows are
+ *   CONFIGURATION. So the `SubscriptionType` COLUMNS are the rules, this base class reads them and
+ *   implements the standard flows, and `SubscriptionType.DriverClass` is NULLABLE. Supply a driver
+ *   only when a customer needs something the columns cannot express — and it SUBCLASSES this class,
+ *   inheriting every rule it does not override:
+ *
+ *       @RegisterClass(SubscriptionBehavior, 'AcmeCalendarYear')
+ *       export class AcmeCalendarYear extends SubscriptionBehavior {
+ *           protected override ComputeProration(...) { ... }   // everything else inherited
+ *       }
+ *
+ * A driver-only model would have forced a class per permutation of anchor × cadence × concurrency.
+ *
+ * This class is PURE: it computes dates, amounts, and decisions. It never touches the database and
+ * never opens a transaction — `OrderEntityServer` persists the results inside the booking
+ * transaction, which keeps transaction management in one place (same discipline as the rev-rec
+ * drivers).
+ *
+ * CONNECTS TO:
+ *   TABLE:  __mj_BizAppsOrders.SubscriptionType
+ *   CALLER: OrderEntityServer (term creation at confirm)
+ */
+import { RegisterClass } from '@memberjunction/global';
+function money(v) {
+    return Math.round((v + Number.EPSILON) * 100) / 100;
+}
+/**
+ * Snap to UTC midnight — the ONLY safe basis for this arithmetic.
+ *
+ * Every date here is a calendar date, not an instant: `SubscriptionTerm.StartDate`/`EndDate` are
+ * SQL `DATE` columns, and a term "starts July 1" regardless of who is looking. But `OrderDate`
+ * round-trips through the database as UTC midnight while `new Date(y, m, d)` builds LOCAL midnight,
+ * so mixing the two puts them hours apart. West of Greenwich that is enough to make a term END
+ * BEFORE IT STARTS — a purchase on the anchor date resolves its "next anchor" to the SAME day it was
+ * bought, and `EndDate = anchor − 1 day` lands before the start, violating CK_SubscriptionTerm_Dates.
+ *
+ * So: normalize at the boundary, and do all shifting in UTC.
+ */
+function utcDay(d) {
+    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
+}
+function addMonths(d, n) {
+    const day = d.getUTCDate();
+    const shifted = new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + n, day));
+    // Clamp: Jan 31 + 1 month is Feb 28/29, not Mar 2/3.
+    if (shifted.getUTCDate() < day)
+        shifted.setUTCDate(0);
+    return shifted;
+}
+function addDays(d, n) {
+    return new Date(d.getTime() + n * 86400000);
+}
+function daysBetween(a, b) {
+    return Math.round((b.getTime() - a.getTime()) / 86400000);
+}
+/** Calendar date for user-facing explanations. */
+function isoDay(d) {
+    return d.toISOString().slice(0, 10);
+}
+let SubscriptionBehavior = 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) {
+        // Normalize once, here, so every protected method below is guaranteed a calendar date.
+        const ctx = {
+            ...rawContext,
+            PurchaseDate: utcDay(rawContext.PurchaseDate),
+            Existing: rawContext.Existing
+                ? { ...rawContext.Existing, LatestTermEnd: rawContext.Existing.LatestTermEnd ? utcDay(rawContext.Existing.LatestTermEnd) : null }
+                : rawContext.Existing,
+        };
+        const scopeError = this.ValidateSubscriberScope(ctx);
+        if (scopeError) {
+            return { Action: 'Reject', RejectReason: scopeError };
+        }
+        const action = this.ChooseAction(ctx);
+        if (action === 'Reject') {
+            return {
+                Action: 'Reject',
+                RejectReason: `This subscription type (${ctx.Rules.Code}) does not allow a second concurrent ` +
+                    `subscription for the same subscriber, and an active one already exists.`,
+            };
+        }
+        // An extension starts where the existing coverage ends — never overlapping it.
+        const extending = action === 'ExtendExisting';
+        const start = extending && ctx.Existing?.LatestTermEnd
+            ? addDays(ctx.Existing.LatestTermEnd, 1)
+            : utcDay(this.ComputeStartDate(ctx));
+        const end = this.ComputeEndDate(ctx, start, extending);
+        const { isProrated, factor } = this.ComputeProration(ctx, start, end, extending);
+        return {
+            Action: action,
+            SubscriptionID: action === 'CreateNew' ? undefined : ctx.Existing?.ID,
+            Term: {
+                StartDate: start,
+                EndDate: end,
+                TermNumber: (ctx.Existing?.LatestTermNumber ?? 0) + 1,
+                IsProrated: isProrated,
+                ProrationFactor: isProrated ? factor : null,
+                Amount: money(ctx.Amount * (isProrated ? factor : 1)),
+            },
+        };
+    }
+    // ─── Overridable pieces ────────────────────────────────────────────────────
+    ValidateSubscriberScope(ctx) {
+        const { SubscriberScope, BenefitModel, Code } = ctx.Rules;
+        const org = ctx.Subscriber.OrganizationID;
+        const person = ctx.Subscriber.PersonID;
+        if (!org && !person) {
+            return (`Subscription type ${Code} needs a subscriber, but neither a ship-to organization nor ` +
+                `a ship-to person is set on the order line, and the order header names no customer.`);
+        }
+        if (SubscriberScope === 'Organization' && !org) {
+            return `Subscription type ${Code} is organization-only, but no organization was resolved for this line.`;
+        }
+        if (SubscriberScope === 'Person' && !person) {
+            return `Subscription type ${Code} is individual-only, but no person was resolved for this line.`;
+        }
+        // The benefit model is the stricter of the two rules, so it is checked second.
+        if (BenefitModel === 'Organization' && !org) {
+            return (`Subscription type ${Code} benefits an organization's members, so it must be held by ` +
+                `an organization — none was resolved for this line, the order's ship-to, or its customer.`);
+        }
+        // `Holder` needs no extra check: SubscriberScope already guaranteed a holder exists, and
+        // the benefit simply follows them.
+        if (BenefitModel === 'Individual' && !person) {
+            // Note WHERE this can be satisfied from. The person is NOT required on the line: it
+            // falls back to the order's ship-to and then its customer, so a bulk order for one
+            // recipient states them once on the header. The failure only fires when no person is
+            // resolvable ANYWHERE, which genuinely leaves nobody to benefit.
+            return (`Subscription type ${Code} benefits a named person, but none was resolved from the ` +
+                `line's ship-to, the order's ship-to, or the order's customer.`);
+        }
+        return 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, subscriber) {
+        switch (rules.BenefitModel) {
+            case 'Holder':
+                // Key on whichever side holds it, so a personal membership dedupes by person and an
+                // org-held one by org — without either leaking into the other's identity.
+                return subscriber.PersonID && !subscriber.OrganizationID
+                    ? { OrganizationID: null, PersonID: subscriber.PersonID }
+                    : { OrganizationID: subscriber.OrganizationID ?? null, PersonID: null };
+            case 'Organization':
+                // The org holds ONE, however many of its people benefit — so a second purchase
+                // extends rather than duplicating.
+                return { OrganizationID: subscriber.OrganizationID, PersonID: null };
+            case 'Individual':
+                // Both sides as resolved. For a seat that is (org, person), so ten staff are ten
+                // subscriptions. For a personal membership the org is simply absent, leaving the
+                // person as the key.
+                return { OrganizationID: subscriber.OrganizationID ?? null, PersonID: subscriber.PersonID };
+        }
+    }
+    ChooseAction(ctx) {
+        const existing = ctx.Existing;
+        if (!existing)
+            return 'CreateNew';
+        // A renewal continues THIS subscription, whatever the concurrency rule says (see IsRenewal).
+        // Reactivation still applies below when the subscription has lapsed — a renewal arriving
+        // after a lapse should revive it rather than silently extend a dead one.
+        const isActive = existing.Status === 'Active' || existing.Status === 'Trialing';
+        if (ctx.IsRenewal && isActive)
+            return 'ExtendExisting';
+        if (isActive) {
+            switch (ctx.Rules.ConcurrencyMode) {
+                case 'AllowMultiple': return 'CreateNew';
+                case 'ExtendExisting': return 'ExtendExisting';
+                case 'RejectDuplicate': return 'Reject';
+            }
+        }
+        // Lapsed or canceled — reactivation policy decides.
+        switch (ctx.Rules.ReactivationMode) {
+            case 'AlwaysCreateNew':
+                return 'CreateNew';
+            case 'ReactivateExisting':
+                return 'Reactivate';
+            case 'ReactivateWithinWindow': {
+                const window = ctx.Rules.ReactivationWindowDays ?? 0;
+                const end = existing.LatestTermEnd ? new Date(existing.LatestTermEnd) : null;
+                const withinWindow = end != null && daysBetween(end, ctx.PurchaseDate) <= window;
+                return withinWindow ? 'Reactivate' : 'CreateNew';
+            }
+        }
+    }
+    /** Immediate / Deferred / snap-forward to the calendar anchor. */
+    ComputeStartDate(ctx) {
+        const purchase = ctx.PurchaseDate;
+        switch (ctx.Rules.StartMode) {
+            case 'Immediate':
+                return purchase;
+            case 'Deferred':
+                return addDays(purchase, ctx.Rules.DeferredStartDays ?? 0);
+            case 'CalendarAnchored':
+                // ExtendToNextAnchor waits for the anchor; Prorate/ChargeFull start NOW and run to
+                // the anchor, which is what makes the first term partial.
+                return ctx.Rules.PartialPeriodMode === 'ExtendToNextAnchor'
+                    ? this.NextAnchor(ctx, purchase)
+                    : purchase;
+        }
+    }
+    ComputeEndDate(ctx, start, extending) {
+        const months = ctx.Rules.DefaultTermMonths ?? this.MonthsForCadence(ctx.Rules.BillingCadence, ctx.Rules.CustomCycleDays);
+        if (ctx.Rules.StartMode === 'CalendarAnchored' && !extending) {
+            // A partial first term runs from the purchase to the day before the next anchor.
+            const anchor = this.NextAnchor(ctx, start);
+            if (ctx.Rules.PartialPeriodMode !== 'ExtendToNextAnchor' && anchor.getTime() > start.getTime()) {
+                return addDays(anchor, -1);
+            }
+        }
+        return addDays(addMonths(start, months), -1);
+    }
+    /**
+     * 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.
+     */
+    ComputeProration(ctx, start, end, extending) {
+        if (extending)
+            return { isProrated: false, factor: 1 };
+        if (ctx.Rules.StartMode !== 'CalendarAnchored')
+            return { isProrated: false, factor: 1 };
+        if (ctx.Rules.PartialPeriodMode !== 'Prorate')
+            return { isProrated: false, factor: 1 };
+        const fullMonths = ctx.Rules.DefaultTermMonths ?? 12;
+        const fullDays = daysBetween(start, addMonths(start, fullMonths));
+        const actualDays = daysBetween(start, end) + 1;
+        if (fullDays <= 0 || actualDays >= fullDays)
+            return { isProrated: false, factor: 1 };
+        return { isProrated: true, factor: Math.round((actualDays / fullDays) * 1e6) / 1e6 };
+    }
+    /** The next occurrence of AnchorMonth/AnchorDay strictly after `from`. */
+    NextAnchor(ctx, from) {
+        const month = (ctx.Rules.AnchorMonth ?? 1) - 1;
+        const day = ctx.Rules.AnchorDay ?? 1;
+        const base = utcDay(from);
+        let anchor = new Date(Date.UTC(base.getUTCFullYear(), month, day));
+        // Strictly after: buying ON the anchor date starts a FULL term at that anchor rather than
+        // a zero-length stub ending the day before itself.
+        if (anchor.getTime() <= base.getTime()) {
+            anchor = new Date(Date.UTC(base.getUTCFullYear() + 1, month, day));
+        }
+        return anchor;
+    }
+    MonthsForCadence(cadence, customDays) {
+        switch (cadence) {
+            case 'Monthly': return 1;
+            case 'Quarterly': return 3;
+            case 'Annual': return 12;
+            case 'Custom': return Math.max(1, Math.round((customDays ?? 30) / 30));
+        }
+    }
+    /** Months per recognition slice — `MatchBilling` follows the billing cadence. */
+    RecognitionMonths(rules) {
+        const cadence = rules.RecognitionCadence === 'MatchBilling' ? rules.BillingCadence : rules.RecognitionCadence;
+        return this.MonthsForCadence(cadence, rules.CustomCycleDays);
+    }
+    // ─── Cancellation (design §5) ──────────────────────────────────────────────
+    //
+    // The mechanics of a cancellation already work: a reversal order line with a negative quantity
+    // produces mirrored journal entries through the ordinary booking path (D16). What was missing is
+    // the POLICY — and the raw mechanic is terrible data entry. Amith's case: a subscription running
+    // 1/1-12/31, cancelled on 7/1, needs a line of quantity -0.5. The user should pick a DATE; the
+    // engine derives the fraction. That is what this computes.
+    /**
+     * 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) {
+        const ctx = {
+            ...rawContext,
+            RequestDate: utcDay(rawContext.RequestDate),
+            Term: {
+                ...rawContext.Term,
+                StartDate: utcDay(rawContext.Term.StartDate),
+                EndDate: utcDay(rawContext.Term.EndDate),
+            },
+        };
+        const effective = this.ClampToTerm(ctx, this.ComputeCancellationDate(ctx));
+        const { amount, explanation } = this.ComputeRefund(ctx, effective);
+        const uncapped = money(Math.min(Math.max(amount, 0), ctx.Term.Amount));
+        // Round the FRACTION to the reversal line's own precision, then derive the refund back from
+        // it — not the other way round. `OrderLine.Quantity` is DECIMAL(18,4), so a fraction with
+        // more precision than that is silently truncated on insert, and the line total recomputed
+        // from the truncated quantity no longer matches the one stored at insert. The immutability
+        // trigger sees a "changed" financial column and rejects the very next write to that line.
+        // Deriving both numbers from one rounded fraction keeps the reversed revenue and the
+        // refunded cash exactly equal, which is the invariant that actually matters.
+        const rawFraction = ctx.Term.Amount > 0 ? uncapped / ctx.Term.Amount : 0;
+        const fraction = Math.round(rawFraction * 1e4) / 1e4;
+        const refund = money(ctx.Term.Amount * fraction);
+        return {
+            EffectiveDate: effective,
+            AccessThroughDate: addDays(effective, ctx.Rules.GracePeriodDays ?? 0),
+            RefundAmount: refund,
+            ReversalFraction: fraction,
+            // Riding the term out is not a cancellation of coverage — the customer got everything
+            // they paid for. Only a cut-short term is `Canceled`.
+            TermStatus: effective.getTime() >= ctx.Term.EndDate.getTime() ? 'Completed' : 'Canceled',
+            Explanation: explanation,
+        };
+    }
+    /** When coverage ends, per `CancellationMode`. */
+    ComputeCancellationDate(ctx) {
+        switch (ctx.Rules.CancellationMode) {
+            case 'Immediate':
+                return ctx.RequestDate;
+            case 'EndOfTerm':
+                return ctx.Term.EndDate;
+            case 'EndOfBillingPeriod':
+                return this.EndOfBillingPeriod(ctx);
+        }
+    }
+    /**
+     * 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.
+     */
+    EndOfBillingPeriod(ctx) {
+        const step = this.MonthsForCadence(ctx.Rules.BillingCadence, ctx.Rules.CustomCycleDays);
+        let boundary = addMonths(ctx.Term.StartDate, step);
+        // Bounded by the term itself, so a mis-configured cadence cannot spin.
+        while (boundary.getTime() <= ctx.RequestDate.getTime() && boundary.getTime() < ctx.Term.EndDate.getTime()) {
+            boundary = addMonths(boundary, step);
+        }
+        return addDays(boundary, -1);
+    }
+    /** Cancellation never resurrects a finished term, and never ends coverage before it began. */
+    ClampToTerm(ctx, date) {
+        if (date.getTime() < ctx.Term.StartDate.getTime())
+            return ctx.Term.StartDate;
+        if (date.getTime() > ctx.Term.EndDate.getTime())
+            return ctx.Term.EndDate;
+        return date;
+    }
+    /** What to give back, per `CancellationRefundMode`. */
+    ComputeRefund(ctx, effective) {
+        const { Rules: rules, Term: term } = ctx;
+        switch (rules.CancellationRefundMode) {
+            case 'NoRefund':
+                return {
+                    amount: 0,
+                    explanation: `Coverage ends ${isoDay(effective)} (${rules.CancellationMode}). This subscription ` +
+                        `type does not refund, so nothing is reversed.`,
+                };
+            case 'FullRefundWithinWindow': {
+                const window = rules.CancellationWindowDays ?? 0;
+                const elapsed = daysBetween(term.StartDate, ctx.RequestDate);
+                if (elapsed <= window) {
+                    return {
+                        amount: term.Amount,
+                        explanation: `Cancelled ${elapsed} day(s) into the term, within the ${window}-day refund ` +
+                            `window — the full ${term.Amount} is refunded and reversed.`,
+                    };
+                }
+                return {
+                    amount: 0,
+                    explanation: `Cancelled ${elapsed} day(s) into the term, past the ${window}-day refund window. ` +
+                        `Coverage ends ${isoDay(effective)} with no refund.`,
+                };
+            }
+            case 'ProrateUnused': {
+                // Inclusive day counts on both sides, so a cancellation on the term's first day
+                // refunds the whole term rather than all-but-one-day.
+                const totalDays = daysBetween(term.StartDate, term.EndDate) + 1;
+                const unusedDays = daysBetween(effective, term.EndDate);
+                if (totalDays <= 0 || unusedDays <= 0) {
+                    return {
+                        amount: 0,
+                        explanation: `Coverage ends ${isoDay(effective)} with no unused period remaining.`,
+                    };
+                }
+                const fraction = unusedDays / totalDays;
+                return {
+                    amount: term.Amount * fraction,
+                    explanation: `Coverage ends ${isoDay(effective)}; ${unusedDays} of ${totalDays} day(s) go ` +
+                        `unused, so ${Math.round(fraction * 1000) / 10}% of the term is refunded.`,
+                };
+            }
+        }
+    }
+};
+SubscriptionBehavior = __decorate([
+    RegisterClass(SubscriptionBehavior, 'Default')
+], SubscriptionBehavior);
+export { SubscriptionBehavior };
+/** Tree-shaking anchor — the base behaviour must be registered before booking runs. */
+export function LoadSubscriptionBehavior() {
+    // intentionally empty
+}
+//# sourceMappingURL=SubscriptionBehavior.js.map

package/dist/SubscriptionBehavior.js.map

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

package/dist/checkoutCaptureAlert.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Durable signal when a settled checkout payment will never book on retry.
+ *
+ * The log marker is the alert floor. A Tasks row is the human-visible artifact —
+ * only if bizapps-tasks is installed AND a GENERAL TaskType can be resolved by
+ * Code. TypeID is NOT NULL with no default; writing a Task without it always fails.
+ *
+ * Reads and writes go through the generated Tasks subclasses, not `.Get()` / `.Set()`.
+ */
+import { type UserInfo } from '@memberjunction/core';
+export declare const CHECKOUT_CAPTURE_TASK_ENTITY = "MJ_BizApps_Tasks: Tasks";
+export declare const CHECKOUT_CAPTURE_TASK_TYPE_ENTITY = "MJ_BizApps_Tasks: Task Types";
+/** Seeded TaskType.Code — resolved at runtime, never a hardcoded GUID. */
+export declare const CHECKOUT_CAPTURE_TASK_TYPE_CODE = "GENERAL";
+export declare function raiseCheckoutCaptureTerminalAlert(orderID: string, sessionID: string | undefined, reason: string, contextUser?: UserInfo): Promise<void>;
+//# sourceMappingURL=checkoutCaptureAlert.d.ts.map

package/dist/checkoutCaptureAlert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkoutCaptureAlert.d.ts","sourceRoot":"","sources":["../src/checkoutCaptureAlert.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAA+B,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQlF,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AACtE,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAChF,0EAA0E;AAC1E,eAAO,MAAM,+BAA+B,YAAY,CAAC;AAEzD,wBAAsB,iCAAiC,CACnD,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,QAAQ,GACvB,OAAO,CAAC,IAAI,CAAC,CAkDf"}

package/dist/checkoutCaptureAlert.js

@@ -0,0 +1,55 @@
+/**
+ * Durable signal when a settled checkout payment will never book on retry.
+ *
+ * The log marker is the alert floor. A Tasks row is the human-visible artifact —
+ * only if bizapps-tasks is installed AND a GENERAL TaskType can be resolved by
+ * Code. TypeID is NOT NULL with no default; writing a Task without it always fails.
+ *
+ * Reads and writes go through the generated Tasks subclasses, not `.Get()` / `.Set()`.
+ */
+import { LogError, Metadata, RunView } from '@memberjunction/core';
+import { CHECKOUT_CAPTURE_TERMINAL_LOG_MARKER } from './checkoutCaptureRetry.js';
+import { EscapeText } from './sql-guards.js';
+export const CHECKOUT_CAPTURE_TASK_ENTITY = 'MJ_BizApps_Tasks: Tasks';
+export const CHECKOUT_CAPTURE_TASK_TYPE_ENTITY = 'MJ_BizApps_Tasks: Task Types';
+/** Seeded TaskType.Code — resolved at runtime, never a hardcoded GUID. */
+export const CHECKOUT_CAPTURE_TASK_TYPE_CODE = 'GENERAL';
+export async function raiseCheckoutCaptureTerminalAlert(orderID, sessionID, reason, contextUser) {
+    LogError(`${CHECKOUT_CAPTURE_TERMINAL_LOG_MARKER} Settled payment was not booked onto confirmed checkout order ${orderID}` +
+        `${sessionID ? ` session=${sessionID}` : ''}: ${reason}`);
+    if (!contextUser) {
+        return;
+    }
+    try {
+        const md = new Metadata();
+        if (!md.EntityByName(CHECKOUT_CAPTURE_TASK_ENTITY)) {
+            return;
+        }
+        const rv = new RunView();
+        const types = await rv.RunView({
+            EntityName: CHECKOUT_CAPTURE_TASK_TYPE_ENTITY,
+            ExtraFilter: `Code = '${EscapeText(CHECKOUT_CAPTURE_TASK_TYPE_CODE)}'`,
+            ResultType: 'entity_object',
+            MaxRows: 1,
+        }, contextUser);
+        const typeID = types.Success ? types.Results?.[0]?.ID : undefined;
+        if (!typeID) {
+            LogError(`${CHECKOUT_CAPTURE_TERMINAL_LOG_MARKER} No GENERAL TaskType — cannot raise a Task`);
+            return;
+        }
+        const task = await md.GetEntityObject(CHECKOUT_CAPTURE_TASK_ENTITY, contextUser);
+        task.NewRecord();
+        task.TypeID = typeID;
+        task.Name = `Checkout capture not booked: ${orderID}`;
+        task.Description =
+            `A Stripe payment settled and the checkout order is Confirmed, but Orders.CapturePayment was refused and will not succeed on retry.\n\nOrder: ${orderID}\nSession: ${sessionID ?? '(unknown)'}\nReason: ${reason}`;
+        task.Status = 'Open';
+        if (!(await task.Save())) {
+            LogError(`${CHECKOUT_CAPTURE_TERMINAL_LOG_MARKER} Could not raise a Task: ${task.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+    }
+    catch (err) {
+        LogError(`${CHECKOUT_CAPTURE_TERMINAL_LOG_MARKER} Could not raise a Task: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=checkoutCaptureAlert.js.map

package/dist/checkoutCaptureAlert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkoutCaptureAlert.js","sourceRoot":"","sources":["../src/checkoutCaptureAlert.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAiB,MAAM,sBAAsB,CAAC;AAKlF,OAAO,EAAE,oCAAoC,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,yBAAyB,CAAC;AACtE,MAAM,CAAC,MAAM,iCAAiC,GAAG,8BAA8B,CAAC;AAChF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,+BAA+B,GAAG,SAAS,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACnD,OAAe,EACf,SAA6B,EAC7B,MAAc,EACd,WAAsB;IAEtB,QAAQ,CACJ,GAAG,oCAAoC,iEAAiE,OAAO,EAAE;QAC7G,GAAG,SAAS,CAAC,CAAC,CAAC,YAAY,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,EAAE,CAC/D,CAAC;IACF,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,OAAO;IACX,CAAC;IACD,IAAI,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,4BAA4B,CAAC,EAAE,CAAC;YACjD,OAAO;QACX,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAC1B;YACI,UAAU,EAAE,iCAAiC;YAC7C,WAAW,EAAE,WAAW,UAAU,CAAC,+BAA+B,CAAC,GAAG;YACtE,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,CAAC;SACb,EACD,WAAW,CACd,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAClE,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,QAAQ,CAAC,GAAG,oCAAoC,4CAA4C,CAAC,CAAC;YAC9F,OAAO;QACX,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,eAAe,CACjC,4BAA4B,EAC5B,WAAW,CACd,CAAC;QACF,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,gCAAgC,OAAO,EAAE,CAAC;QACtD,IAAI,CAAC,WAAW;YACZ,gJAAgJ,OAAO,cAAc,SAAS,IAAI,WAAW,aAAa,MAAM,EAAE,CAAC;QACvN,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACvB,QAAQ,CACJ,GAAG,oCAAoC,4BAA4B,IAAI,CAAC,YAAY,EAAE,eAAe,IAAI,eAAe,EAAE,CAC7H,CAAC;QACN,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,QAAQ,CACJ,GAAG,oCAAoC,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACxH,CAAC;IACN,CAAC;AACL,CAAC"}

package/dist/checkoutCaptureRetry.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Classify a failed checkout CapturePayment as terminal vs transient so the
+ * payment webhook 500s (Stripe retries) only when a later attempt might work.
+ *
+ * Unclassified defaults to transient: convergence matters more than tidiness,
+ * and the event-age bound makes that bias affordable.
+ */
+import type { WebhookEvent } from './BasePaymentProvider.js';
+/** Stripe retries ~3 days; stop 500ing well inside that envelope. */
+export declare const CHECKOUT_CAPTURE_RETRY_WINDOW_MS: number;
+/** Grep / alert marker when a settled checkout payment will never book on retry. */
+export declare const CHECKOUT_CAPTURE_TERMINAL_LOG_MARKER = "[CHECKOUT-CAPTURE-TERMINAL]";
+/**
+ * CapturePayment `Blockers[].Code` values that will not change on replay.
+ * `CaptureFailed` is deliberately absent — it wraps a thrown save-path error.
+ */
+export declare const TERMINAL_CAPTURE_BLOCKER_CODES: ReadonlySet<string>;
+export declare const TERMINAL_CAPTURE_PRECHECKS: ReadonlySet<string>;
+export declare function isTerminalCapturePrecheck(message: string): boolean;
+/** True when a later CapturePayment might succeed. Empty / unknown codes retry. */
+export declare function isCaptureRefusalRetryable(blockerCodes: readonly string[]): boolean;
+/**
+ * Missing OccurredAt does NOT disable retries (the bound cannot be applied, and
+ * that is logged by the caller). Present-and-older-than-window → stop 500ing.
+ */
+export declare function webhookEventExceedsRetryWindow(event: Pick<WebhookEvent, 'OccurredAt'>, nowMs?: number, windowMs?: number): boolean;
+//# sourceMappingURL=checkoutCaptureRetry.d.ts.map

package/dist/checkoutCaptureRetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkoutCaptureRetry.d.ts","sourceRoot":"","sources":["../src/checkoutCaptureRetry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,qEAAqE;AACrE,eAAO,MAAM,gCAAgC,QAAsB,CAAC;AAEpE,oFAAoF;AACpF,eAAO,MAAM,oCAAoC,gCAAgC,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,WAAW,CAAC,MAAM,CAe7D,CAAC;AAEH,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAIzD,CAAC;AAEH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,mFAAmF;AACnF,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAKlF;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC1C,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,EACvC,KAAK,GAAE,MAAmB,EAC1B,QAAQ,GAAE,MAAyC,GACpD,OAAO,CAKT"}

package/dist/checkoutCaptureRetry.js

@@ -0,0 +1,50 @@
+/** Stripe retries ~3 days; stop 500ing well inside that envelope. */
+export const CHECKOUT_CAPTURE_RETRY_WINDOW_MS = 12 * 60 * 60 * 1000;
+/** Grep / alert marker when a settled checkout payment will never book on retry. */
+export const CHECKOUT_CAPTURE_TERMINAL_LOG_MARKER = '[CHECKOUT-CAPTURE-TERMINAL]';
+/**
+ * CapturePayment `Blockers[].Code` values that will not change on replay.
+ * `CaptureFailed` is deliberately absent — it wraps a thrown save-path error.
+ */
+export const TERMINAL_CAPTURE_BLOCKER_CODES = new Set([
+    'BadCompanyID',
+    'BadPaymentIntentID',
+    'BadPayerID',
+    'BadOrderID',
+    'NonPositiveAmount',
+    'NonPositiveAllocation',
+    'NoAllocations',
+    'AllocationMismatch',
+    'PayerAmbiguous',
+    'OrderNotFound',
+    'PaymentNotFound',
+    'UnknownTender',
+    'ReversalTender',
+    'OrderCompanyMismatch',
+]);
+export const TERMINAL_CAPTURE_PRECHECKS = new Set([
+    'no bill-to party',
+    'payment intent not found',
+    'no context user',
+]);
+export function isTerminalCapturePrecheck(message) {
+    return TERMINAL_CAPTURE_PRECHECKS.has(message);
+}
+/** True when a later CapturePayment might succeed. Empty / unknown codes retry. */
+export function isCaptureRefusalRetryable(blockerCodes) {
+    if (!blockerCodes.length) {
+        return true;
+    }
+    return blockerCodes.some((code) => !TERMINAL_CAPTURE_BLOCKER_CODES.has(code));
+}
+/**
+ * Missing OccurredAt does NOT disable retries (the bound cannot be applied, and
+ * that is logged by the caller). Present-and-older-than-window → stop 500ing.
+ */
+export function webhookEventExceedsRetryWindow(event, nowMs = Date.now(), windowMs = CHECKOUT_CAPTURE_RETRY_WINDOW_MS) {
+    if (!event.OccurredAt) {
+        return false;
+    }
+    return nowMs - event.OccurredAt.getTime() > windowMs;
+}
+//# sourceMappingURL=checkoutCaptureRetry.js.map

package/dist/checkoutCaptureRetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkoutCaptureRetry.js","sourceRoot":"","sources":["../src/checkoutCaptureRetry.ts"],"names":[],"mappings":"AASA,qEAAqE;AACrE,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEpE,oFAAoF;AACpF,MAAM,CAAC,MAAM,oCAAoC,GAAG,6BAA6B,CAAC;AAElF;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAwB,IAAI,GAAG,CAAC;IACvE,cAAc;IACd,oBAAoB;IACpB,YAAY;IACZ,YAAY;IACZ,mBAAmB;IACnB,uBAAuB;IACvB,eAAe;IACf,oBAAoB;IACpB,gBAAgB;IAChB,eAAe;IACf,iBAAiB;IACjB,eAAe;IACf,gBAAgB;IAChB,sBAAsB;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAwB,IAAI,GAAG,CAAC;IACnE,kBAAkB;IAClB,0BAA0B;IAC1B,iBAAiB;CACpB,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CAAC,OAAe;IACrD,OAAO,0BAA0B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,yBAAyB,CAAC,YAA+B;IACrE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,8BAA8B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC1C,KAAuC,EACvC,QAAgB,IAAI,CAAC,GAAG,EAAE,EAC1B,WAAmB,gCAAgC;IAEnD,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC;AACzD,CAAC"}

package/dist/claimDriverHelpers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Shared helper utilities for Identity Claim drivers in BizApps Orders.
+ *
+ * @module @mj-biz-apps/orders-core-entities-server/claimDriverHelpers
+ */
+import { UserInfo, IEntityDataProvider, IMetadataProvider } from '@memberjunction/core';
+/**
+ * Resolves or looks up the primary Person record associated with an authenticated UserInfo.
+ *
+ * @param user The authenticated UserInfo from the claim context
+ * @param provider Optional scoped entity/metadata provider
+ * @returns Person ID string if found, or null
+ */
+export declare function resolvePersonID(user: UserInfo, provider?: IEntityDataProvider | IMetadataProvider | null): Promise<string | null>;
+//# sourceMappingURL=claimDriverHelpers.d.ts.map

package/dist/claimDriverHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claimDriverHelpers.d.ts","sourceRoot":"","sources":["../src/claimDriverHelpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAW,QAAQ,EAAoB,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAInH;;;;;;GAMG;AACH,wBAAsB,eAAe,CACjC,IAAI,EAAE,QAAQ,EACd,QAAQ,CAAC,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,IAAI,GAC1D,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBxB"}