@mj-biz-apps/orders-core-entities-server 5.22.0 → 5.23.0

package/dist/CheckoutSessionService.d.ts.map

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

package/dist/CheckoutSessionService.js

@@ -13,13 +13,15 @@ import { BusinessTimeZoneEngine } from '@mj-biz-apps/common-entities';
 // '@memberjunction/core-entities-server' once MJ publishes the engine.
 import { CalendarDayOrToday } from './calendar-day.js';
 import { IdentityClaimEngineServer } from './identityClaimContracts.js';
-import { LoadOrdersEngine, OrderPricingService, OrdersEngine, TodayAsDateValue, CheckAnswersAgainstQuestions, CheckCheckoutAnswers, ReadCheckoutQuestions, NormalizeCheckoutAttribution } from '@mj-biz-apps/orders-entities';
+import { LoadOrdersEngine, OrderPricingService, OrdersEngine, TodayAsDateValue, CheckAnswersAgainstQuestions, CheckCheckoutAnswers, ReadCheckoutQuestions, NormalizeCheckoutAttribution, CheckCheckoutChoices, ChoicesForStorage, ReadCheckoutChoiceGroups, CheckChoicesAgainstGroups } from '@mj-biz-apps/orders-entities';
 import { EscapeText } from './sql-guards.js';
 import { OpenPaymentIntent } from './PaymentIntentService.js';
 import { ResolvePaymentProvider } from './PaymentProviderResolver.js';
 import { CapturePaymentOperation } from './CapturePaymentOperation.js';
 import { raiseCheckoutCaptureTerminalAlert } from './checkoutCaptureAlert.js';
+import { CheckoutStepLog } from './CheckoutStepLog.js';
 import { isCaptureRefusalRetryable, isTerminalCapturePrecheck, } from './checkoutCaptureRetry.js';
+import { DescribeCheckoutSnapshot, SendOrderDescriptionToGateway } from './IntentDescription.js';
 const CHECKOUT_WIDGET_ENTITY = 'MJ_BizApps_Orders: Checkout Widgets';
 const CHECKOUT_DISTRIBUTION_ENTITY = 'MJ_BizApps_Orders: Checkout Widget Distributions';
 const CHECKOUT_SESSION_ENTITY = 'MJ_BizApps_Orders: Checkout Sessions';
@@ -166,6 +168,7 @@ export class CheckoutSessionService {
         'theme',
         'allowCoupons',
         'questions',
+        'choiceGroups',
     ]); }
     static sanitizeConfigurationForClient(configObj) {
         const sanitized = {};
@@ -513,6 +516,36 @@ export class CheckoutSessionService {
         }
         return CheckCheckoutAnswers(questions, stored);
     }
+    /** Whether a line can hold Order Line Choices. An extension-type line (IS-A) does not. */
+    static canRecordChoices(line) {
+        return !!line.Choices;
+    }
+    /**
+     * The session's stored choices, checked in full against the widget's CURRENT choice groups:
+     * every group within its min and max, every option one of the group's. Run where money moves
+     * or the order books.
+     */
+    static checkSessionChoices(widget, session) {
+        let groups;
+        if (widget.Configuration) {
+            try {
+                groups = JSON.parse(widget.Configuration).choiceGroups;
+            }
+            catch {
+                return { Choices: [], Error: 'Invalid widget configuration' };
+            }
+        }
+        let stored;
+        if (session.MetadataJSON) {
+            try {
+                stored = JSON.parse(session.MetadataJSON).Choices;
+            }
+            catch {
+                stored = undefined;
+            }
+        }
+        return CheckCheckoutChoices(groups, stored);
+    }
     /**
      * Creates an order line entity instance attached to the order's Lines collection.
      */
@@ -678,6 +711,20 @@ export class CheckoutSessionService {
         if (draftAnswers.Error) {
             return failed(draftAnswers.Error);
         }
+        // Choices likewise: a draft may hold fewer than a group's minimum, never more than its
+        // maximum or an option it does not offer. The choice is the buyer's for the one item the
+        // widget sells, so a widget with choice groups takes a single line.
+        const choiceGroups = ReadCheckoutChoiceGroups(widgetConfig.choiceGroups);
+        if (choiceGroups.Error) {
+            return failed(choiceGroups.Error);
+        }
+        if (choiceGroups.Groups.length > 0 && Array.isArray(lines) && lines.length > 1) {
+            return failed('This checkout sells one item at a time.');
+        }
+        const draftChoices = CheckChoicesAgainstGroups(choiceGroups.Groups, options?.Choices, { partial: true });
+        if (draftChoices.Error) {
+            return failed(draftChoices.Error);
+        }
         const allowedProductIds = await this.resolveAllowedProductIds(widgetConfig, contextUser);
         const allowAnyProduct = widgetConfig.allowAnyProduct === true;
         if (!allowAnyProduct && allowedProductIds.size === 0) {
@@ -794,6 +841,12 @@ export class CheckoutSessionService {
                 }
             }
         }
+        // A choice is recorded on the order line itself. A line of an extension type (an event
+        // line) has no collection for it, so refuse here, before the buyer pays, rather than at
+        // completion.
+        if (choiceGroups.Groups.length > 0 && order.Lines.Items.some((l) => !CheckoutSessionService.canRecordChoices(l))) {
+            return failed('This checkout is not configured correctly (its choices cannot be recorded on this item).');
+        }
         // Price the draft order in memory
         try {
             const pricingService = new OrderPricingService({
@@ -876,6 +929,7 @@ export class CheckoutSessionService {
             TotalGross: order.TotalGross,
             Answers: this.answersForStorage(draftAnswers.Answers),
             ...(attribution ? { Attribution: attribution } : {}),
+            Choices: ChoicesForStorage(draftChoices.Choices),
             UpdatedAt: new Date().toISOString()
         });
         const sessionSaved = await session.Save();
@@ -952,6 +1006,10 @@ export class CheckoutSessionService {
         if (answersCheck.Error) {
             return failed(answersCheck.Error);
         }
+        const choicesCheck = this.checkSessionChoices(widget, session);
+        if (choicesCheck.Error) {
+            return failed(choicesCheck.Error);
+        }
         let paymentProviderId;
         let currencyCode;
         if (widget.Configuration) {
@@ -971,6 +1029,8 @@ export class CheckoutSessionService {
         if (!mdProvider) {
             return failed('No metadata provider is available to open a payment intent.');
         }
+        // Products only: the order, and so its number, does not exist until completion.
+        const description = await DescribeCheckoutSnapshot(session.MetadataJSON, mdProvider, contextUser);
         const openResult = await OpenPaymentIntent({
             PaymentProviderID: paymentProviderId,
             Amount: snapshotTotal,
@@ -979,7 +1039,8 @@ export class CheckoutSessionService {
             // Stable per-session idempotency key: reopening for the same session+amount
             // returns the SAME gateway intent instead of minting a fresh one per retry.
             IdempotencyKey: `checkout-${sessionID}-${Math.round(snapshotTotal * 100)}`,
-            Metadata: { CheckoutSessionID: sessionID }
+            Metadata: { CheckoutSessionID: sessionID },
+            Description: description
         }, mdProvider, contextUser);
         if (!openResult.Success || !openResult.PaymentIntentID) {
             return failed(openResult.Reason ?? 'The payment provider refused to open an intent.');
@@ -1034,7 +1095,7 @@ export class CheckoutSessionService {
             // `payment_intent.succeeded` is the other — BookSettledCheckoutPaymentIfNeeded, including
             // on AlreadyApplied webhook deliveries so a 500 after applyEvent still converges.
             if (orderLoaded) {
-                await this.applySettledPaymentToOrder(session, existingOrder, contextUser);
+                await this.applySettledPaymentToOrder(session, existingOrder, contextUser, { Source: 'Checkout' });
             }
             return {
                 Success: true,
@@ -1074,6 +1135,8 @@ export class CheckoutSessionService {
         session.Status = 'Processing';
         // Set the moment order.Confirm() commits; controls the catch's no-revert posture.
         let confirmedOrderID = null;
+        // The Confirm step's record, begun once payment has checked out (#326).
+        let confirmStep = null;
         try {
             const widget = await md.GetEntityObject(CHECKOUT_WIDGET_ENTITY, contextUser);
             await widget.Load(session.CheckoutWidgetID);
@@ -1091,12 +1154,14 @@ export class CheckoutSessionService {
             }
             // Refused before anything is written, so an unanswered checkout creates no Person.
             const answersCheck = this.checkSessionAnswers(widget, session);
-            if (answersCheck.Error) {
+            const choicesCheck = this.checkSessionChoices(widget, session);
+            const unanswered = answersCheck.Error ?? choicesCheck.Error;
+            if (unanswered) {
                 await CheckoutSessionService.revertSessionOpenAtomic(sessionID, md, contextUser);
                 session.Status = 'Open';
                 return {
                     Success: false,
-                    ErrorMessage: answersCheck.Error,
+                    ErrorMessage: unanswered,
                     SessionID: sessionID,
                     Status: 'Open'
                 };
@@ -1242,6 +1307,21 @@ export class CheckoutSessionService {
                 row.Answer = answer.Answer;
                 row.OtherText = answer.OtherText;
             }
+            // The choices ride on each line the checkout sold (every seat, in per-unit mode), in the
+            // same graph: the entitlement walk reads them from the line to decide which conditional
+            // entitlements to grant, and a refused confirm leaves none behind.
+            for (const line of order.Lines.Items) {
+                if (choicesCheck.Choices.length > 0 && !CheckoutSessionService.canRecordChoices(line)) {
+                    throw new Error('This checkout is not configured correctly (its choices cannot be recorded on this item).');
+                }
+                for (const choice of choicesCheck.Choices) {
+                    const row = await line.Choices.Create();
+                    row.GroupKey = choice.GroupKey;
+                    row.GroupLabel = choice.GroupLabel;
+                    row.OptionValue = choice.OptionValue;
+                    row.OptionLabel = choice.OptionLabel;
+                }
+            }
             // Price lines before confirmation
             const pricingService = new OrderPricingService({
                 Provider: (order.ProviderToUse ?? md),
@@ -1290,10 +1370,16 @@ export class CheckoutSessionService {
                         Status: 'Open'
                     };
                 }
+                // Payment has checked out, so from here a failure leaves a paid checkout without
+                // an order. Record the attempt; Confirm rolls back on failure, the record does not.
+                confirmStep = await CheckoutStepLog.Begin(sessionID, 'Confirm', 'Checkout', contextUser);
             }
             // Confirm order via BaseEntity lifecycle (executes GL booking, entitlement issuance, status latching)
             await order.Confirm();
             confirmedOrderID = order.ID;
+            if (confirmStep) {
+                await CheckoutStepLog.Succeed(confirmStep);
+            }
             // The order is now COMMITTED — from this point nothing may revert the session to
             // Open, or a retry would book a second order for the same purchase. Session
             // stamping failures are logged and repaired atomically, never surfaced as a
@@ -1307,7 +1393,7 @@ export class CheckoutSessionService {
             }
             // Book the PaymentHeader + allocation now that the order exists. retrieve-on-complete
             // only stamps PaymentIntent.Status = Succeeded; AmountPaid stays 0 until CapturePayment.
-            await this.applySettledPaymentToOrder(session, order, contextUser);
+            await this.applySettledPaymentToOrder(session, order, contextUser, { Source: 'Checkout' });
             // Mint the GuestOrder identity claim for the buyer's email so a later account
             // (MJ core's IdentityClaimEngineServer) can attach the order + its entitlement
             // grants on redemption or claim-on-login. Best-effort: a claim failure must never
@@ -1354,6 +1440,9 @@ export class CheckoutSessionService {
                     Status: 'Confirmed'
                 };
             }
+            if (confirmStep) {
+                await CheckoutStepLog.Fail(confirmStep, msg);
+            }
             await CheckoutSessionService.revertSessionOpenAtomic(sessionID, md, contextUser);
             session.Status = 'Open';
             LogError(`[CheckoutSessionService] CompleteCheckout failed for session ${sessionID}: ${msg}`);
@@ -1432,7 +1521,27 @@ export class CheckoutSessionService {
         if (!(await order.Load(session.DraftOrderID))) {
             return { Attempted: false, Booked: false };
         }
-        return this.applySettledPaymentToOrder(session, order, contextUser);
+        return this.applySettledPaymentToOrder(session, order, contextUser, { Source: 'Webhook' });
+    }
+    /**
+     * Operator replay of the Capture step (`Orders.ReplayCheckoutStep`, #326). The same idempotent
+     * CapturePayment as the complete call and the webhook, recorded as a Replay by the operator.
+     * Returns a refusal message instead when the session has no confirmed order to capture against.
+     */
+    static async ReplayCapture(sessionID, contextUser, replayedByUserID) {
+        const md = new Metadata();
+        const session = await md.GetEntityObject(CHECKOUT_SESSION_ENTITY, contextUser);
+        if (!(await session.Load(sessionID))) {
+            return `Checkout session ${sessionID} not found.`;
+        }
+        if (session.Status !== 'Confirmed' || !session.DraftOrderID) {
+            return `Checkout session ${sessionID} has no confirmed order (status ${session.Status}); there is nothing to capture against.`;
+        }
+        const order = await md.GetEntityObject(ORDER_HEADER_ENTITY, contextUser);
+        if (!(await order.Load(session.DraftOrderID))) {
+            return `The order on checkout session ${sessionID} could not be read.`;
+        }
+        return this.applySettledPaymentToOrder(session, order, contextUser, { Source: 'Replay', ReplayedByUserID: replayedByUserID });
     }
     /**
      * After the order is committed, book `Orders.CapturePayment` against the session's
@@ -1442,7 +1551,7 @@ export class CheckoutSessionService {
      * Retries are CompleteCheckout replay and `BookSettledCheckoutPaymentIfNeeded`
      * from the payment_intent.succeeded webhook (including AlreadyApplied).
      */
-    static async applySettledPaymentToOrder(session, order, contextUser) {
+    static async applySettledPaymentToOrder(session, order, contextUser, trigger) {
         if (!session.PaymentIntentID) {
             return { Attempted: false, Booked: false };
         }
@@ -1451,27 +1560,36 @@ export class CheckoutSessionService {
             return { Attempted: false, Booked: false };
         }
         if (Number(order.AmountPaid ?? 0) + 0.005 >= due) {
+            // Paid, possibly by another path after an earlier capture attempt failed. A record
+            // left Failed or Running would keep the session in the review queue.
+            await CheckoutStepLog.CloseIfOpen(session.ID, 'Capture', contextUser);
             return { Attempted: false, Booked: true };
         }
         if (!contextUser) {
-            return this.captureFailed(order.ID, 'no context user', undefined, undefined, session.ID);
+            return this.captureFailed(order.ID, 'no context user', undefined, undefined, session.ID, null);
         }
+        const step = await CheckoutStepLog.Begin(session.ID, 'Capture', trigger.Source, contextUser, trigger.ReplayedByUserID);
         if (!order.BillToPersonID && !order.BillToOrganizationID) {
-            return this.captureFailed(order.ID, 'no bill-to party', undefined, contextUser, session.ID);
+            return this.captureFailed(order.ID, 'no bill-to party', undefined, contextUser, session.ID, step);
         }
         const md = new Metadata();
         const intent = await md.GetEntityObject(PAYMENT_INTENT_ENTITY, contextUser);
         if (!(await intent.Load(session.PaymentIntentID))) {
-            return this.captureFailed(order.ID, 'payment intent not found', undefined, contextUser, session.ID);
+            return this.captureFailed(order.ID, 'payment intent not found', undefined, contextUser, session.ID, step);
         }
         if (!SETTLED_INTENT_STATUSES.includes(intent.Status)) {
             await this.refreshIntentFromGateway(intent, contextUser);
         }
         if (!SETTLED_INTENT_STATUSES.includes(intent.Status)) {
-            return this.captureFailed(order.ID, `intent status is ${intent.Status}`, undefined, contextUser, session.ID);
+            return this.captureFailed(order.ID, `intent status is ${intent.Status}`, undefined, contextUser, session.ID, step);
         }
         if (!intent.OrderHeaderID) {
             intent.OrderHeaderID = order.ID;
+            // Second step of the gateway description: the intent was opened before the order existed.
+            const mdForGateway = Metadata.Provider;
+            if (mdForGateway) {
+                await SendOrderDescriptionToGateway(intent, order.ID, mdForGateway, contextUser);
+            }
         }
         if (!intent.BillToPersonID && order.BillToPersonID) {
             intent.BillToPersonID = order.BillToPersonID;
@@ -1497,7 +1615,7 @@ export class CheckoutSessionService {
         }
         const mdProvider = Metadata.Provider;
         if (!mdProvider) {
-            return this.captureFailed(order.ID, 'no metadata provider', undefined, contextUser, session.ID);
+            return this.captureFailed(order.ID, 'no metadata provider', undefined, contextUser, session.ID, step);
         }
         try {
             const op = new CapturePaymentOperation();
@@ -1525,21 +1643,27 @@ export class CheckoutSessionService {
                     ?? output?.Blockers?.map((b) => b.Message).join('; ')
                     ?? 'unknown error';
                 const codes = (output?.Blockers ?? []).map((b) => b.Code).filter((c) => Boolean(c));
-                return this.captureFailed(order.ID, detail, isCaptureRefusalRetryable(codes), contextUser, session.ID);
+                return this.captureFailed(order.ID, detail, isCaptureRefusalRetryable(codes), contextUser, session.ID, step);
             }
+            await CheckoutStepLog.Succeed(step);
             return { Attempted: true, Booked: true };
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
-            return this.captureFailed(order.ID, msg, true, contextUser, session.ID);
+            return this.captureFailed(order.ID, msg, true, contextUser, session.ID, step);
         }
     }
-    static captureFailed(orderID, message, retryable, contextUser, sessionID) {
+    static async captureFailed(orderID, message, retryable, contextUser, sessionID, step) {
         const Retryable = retryable ?? !isTerminalCapturePrecheck(message);
         LogError(`[CheckoutSessionService] CapturePayment failed for order ${orderID}: ${message}`);
-        if (!Retryable) {
+        // One Task per terminal failure, not one per replay of it: the step record says whether
+        // the last attempt already ended the same way.
+        if (!Retryable && (!step || CheckoutStepLog.IsNewTerminalFailure(step))) {
             void raiseCheckoutCaptureTerminalAlert(orderID, sessionID, message, contextUser);
         }
+        if (step) {
+            await CheckoutStepLog.Fail(step, message, Retryable);
+        }
         return { Attempted: true, Booked: false, ErrorMessage: message, Retryable };
     }
     /**