@mj-biz-apps/orders-core-entities-server 5.27.0 → 5.29.0

package/dist/CheckCoverageOverlapOperation.js

@@ -0,0 +1,70 @@
+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;
+};
+/**
+ * @fileoverview `Orders.CheckCoverageOverlap` — would confirming this draft create coverage that
+ * overlaps another band the holder already has (golive #276)?
+ *
+ * WHY THIS IS AN OPERATION AND NOT A CLIENT QUERY. Who a line's subscriber is (ship-to falling back
+ * to the header, an organization inferred from the person's affiliation), which axes define a
+ * duplicate (the type's BenefitModel), and what the term's dates will be (the type's start and end
+ * rules) are all decided on the server at confirm. A notice computed from its own queries would be
+ * a second copy of those rules, and it would disagree with the refusal the first time either
+ * changed. So the editor asks the same code confirm refuses with.
+ *
+ * READ-ONLY: it loads the order and runs the confirm-time decision pass in preview, which writes
+ * nothing.
+ *
+ * CONNECTS TO:
+ *   CODE: OrderEntityServer.PreviewCoverageOverlaps, SubscriptionBehavior.DecideCoverageOverlap
+ *   UI:   the order lines editor's coverage notice
+ *
+ * @module @mj-biz-apps/orders-core-entities-server
+ */
+import { BaseRemotableOperation } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { OrdersCheckCoverageOverlapOperation as OrdersCheckCoverageOverlapOperationBase, } from '@mj-biz-apps/orders-entities';
+import { RequireUUID } from './sql-guards.js';
+const ORDER_ENTITY = 'MJ_BizApps_Orders: Order Headers';
+const day = (d) => d.toISOString().slice(0, 10);
+let CheckCoverageOverlapOperation = class CheckCoverageOverlapOperation extends OrdersCheckCoverageOverlapOperationBase {
+    async InternalExecute(input, provider, user) {
+        const orderID = RequireUUID(input?.OrderHeaderID, 'OrderHeaderID');
+        const order = await provider.GetEntityObject(ORDER_ENTITY, user);
+        if (!(await order.Load(orderID))) {
+            throw new Error(`Order ${orderID} does not exist, so its coverage cannot be checked.`);
+        }
+        // A booked order has already created its subscriptions; there is nothing left to warn about.
+        if (order.Status !== 'Draft')
+            return { Lines: [] };
+        const found = await order.PreviewCoverageOverlaps();
+        return {
+            Lines: found
+                .filter((f) => f.Decision.Outcome !== 'None')
+                .map((f) => ({
+                OrderLineID: f.Line.ID,
+                Outcome: f.Decision.Outcome,
+                Message: f.Decision.Message ?? '',
+                Overlaps: f.Overlaps.map((o) => ({
+                    SubscriptionID: o.SubscriptionID,
+                    SubscriptionNumber: o.SubscriptionNumber,
+                    ProductName: o.ProductName,
+                    CoverageStart: day(o.CoverageStart),
+                    CoverageEnd: day(o.CoverageEnd),
+                })),
+            })),
+        };
+    }
+};
+CheckCoverageOverlapOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'Orders.CheckCoverageOverlap')
+], CheckCoverageOverlapOperation);
+export { CheckCoverageOverlapOperation };
+/** Tree-shaking anchor — call from the server bootstrap so @RegisterClass is retained. */
+export function LoadCheckCoverageOverlapOperation() {
+    // intentionally empty
+}
+//# sourceMappingURL=CheckCoverageOverlapOperation.js.map

package/dist/CheckCoverageOverlapOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckCoverageOverlapOperation.js","sourceRoot":"","sources":["../src/CheckCoverageOverlapOperation.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,sBAAsB,EAAyC,MAAM,sBAAsB,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EACH,mCAAmC,IAAI,uCAAuC,GAGjF,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,YAAY,GAAG,kCAAkC,CAAC;AAExD,MAAM,GAAG,GAAG,CAAC,CAAO,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAG/C,IAAM,6BAA6B,GAAnC,MAAM,6BAA8B,SAAQ,uCAAuC;IAC5E,KAAK,CAAC,eAAe,CAC3B,KAAgC,EAChC,QAA2B,EAC3B,IAAc;QAEd,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;QAEnE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAoB,YAAY,EAAE,IAAI,CAAC,CAAC;QACpF,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,qDAAqD,CAAC,CAAC;QAC3F,CAAC;QACD,6FAA6F;QAC7F,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO;YAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAEnD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,uBAAuB,EAAE,CAAC;QACpD,OAAO;YACH,KAAK,EAAE,KAAK;iBACP,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,KAAK,MAAM,CAAC;iBAC5C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACT,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE;gBACtB,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAiE;gBACrF,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE;gBACjC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7B,cAAc,EAAE,CAAC,CAAC,cAAc;oBAChC,kBAAkB,EAAE,CAAC,CAAC,kBAAkB;oBACxC,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC;oBACnC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC;iBAClC,CAAC,CAAC;aACN,CAAC,CAAC;SACV,CAAC;IACN,CAAC;CACJ,CAAA;AAjCY,6BAA6B;IADzC,aAAa,CAAC,sBAAsB,EAAE,6BAA6B,CAAC;GACxD,6BAA6B,CAiCzC;;AAED,0FAA0F;AAC1F,MAAM,UAAU,iCAAiC;IAC7C,sBAAsB;AAC1B,CAAC"}

package/dist/CheckEntitlementOperation.d.ts

@@ -16,10 +16,10 @@
  *   LOAD: ./EntitlementRead.ts
  *   DOC:  plans/entitlement-read-contract.md
  */
-import { BaseRemotableOperation, type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+import { OrdersCheckEntitlementOperation as OrdersCheckEntitlementOperationBase } from '@mj-biz-apps/orders-entities';
 import { type CheckEntitlementInput, type CheckEntitlementOutput } from './EntitlementRead.js';
-export declare class CheckEntitlementOperation extends BaseRemotableOperation<CheckEntitlementInput, CheckEntitlementOutput> {
-    OperationKey: string;
+export declare class CheckEntitlementOperation extends OrdersCheckEntitlementOperationBase {
     protected InternalExecute(input: CheckEntitlementInput, provider: IMetadataProvider, user: UserInfo): Promise<CheckEntitlementOutput>;
 }
 /** Tree-shaking anchor — called from the server bootstrap so the registration is retained. */

package/dist/CheckEntitlementOperation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CheckEntitlementOperation.d.ts","sourceRoot":"","sources":["../src/CheckEntitlementOperation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,sBAAsB,EAAE,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErG,OAAO,EAEH,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC9B,MAAM,sBAAsB,CAAC;AAE9B,qBACa,yBAA0B,SAAQ,sBAAsB,CACjE,qBAAqB,EACrB,sBAAsB,CACzB;IACU,YAAY,SAA6B;cAEhC,eAAe,CAC3B,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,sBAAsB,CAAC;CAGrC;AAED,8FAA8F;AAC9F,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}
+{"version":3,"file":"CheckEntitlementOperation.d.ts","sourceRoot":"","sources":["../src/CheckEntitlementOperation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAA0B,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErG,OAAO,EAAE,+BAA+B,IAAI,mCAAmC,EAAE,MAAM,8BAA8B,CAAC;AACtH,OAAO,EAEH,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC9B,MAAM,sBAAsB,CAAC;AAE9B,qBACa,yBAA0B,SAAQ,mCAAmC;cAC9D,eAAe,CAC3B,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,sBAAsB,CAAC;CAGrC;AAED,8FAA8F;AAC9F,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

package/dist/CheckEntitlementOperation.js

@@ -24,12 +24,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
  */
 import { BaseRemotableOperation } from '@memberjunction/core';
 import { RegisterClass } from '@memberjunction/global';
+import { OrdersCheckEntitlementOperation as OrdersCheckEntitlementOperationBase } from '@mj-biz-apps/orders-entities';
 import { CheckPersonEntitlement, } from './EntitlementRead.js';
-let CheckEntitlementOperation = class CheckEntitlementOperation extends BaseRemotableOperation {
-    constructor() {
-        super(...arguments);
-        this.OperationKey = 'Orders.CheckEntitlement';
-    }
+let CheckEntitlementOperation = class CheckEntitlementOperation extends OrdersCheckEntitlementOperationBase {
     async InternalExecute(input, provider, user) {
         return CheckPersonEntitlement(input, provider, user);
     }

package/dist/CheckEntitlementOperation.js.map

@@ -1 +1 @@
-{"version":3,"file":"CheckEntitlementOperation.js","sourceRoot":"","sources":["../src/CheckEntitlementOperation.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,sBAAsB,EAAyC,MAAM,sBAAsB,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EACH,sBAAsB,GAGzB,MAAM,sBAAsB,CAAC;AAGvB,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,sBAG9C;IAHM;;QAII,iBAAY,GAAG,yBAAyB,CAAC;IASpD,CAAC;IAPa,KAAK,CAAC,eAAe,CAC3B,KAA4B,EAC5B,QAA2B,EAC3B,IAAc;QAEd,OAAO,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;CACJ,CAAA;AAbY,yBAAyB;IADrC,aAAa,CAAC,sBAAsB,EAAE,yBAAyB,CAAC;GACpD,yBAAyB,CAarC;;AAED,8FAA8F;AAC9F,MAAM,UAAU,6BAA6B;IACzC,KAAK,yBAAyB,CAAC;AACnC,CAAC"}
+{"version":3,"file":"CheckEntitlementOperation.js","sourceRoot":"","sources":["../src/CheckEntitlementOperation.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,sBAAsB,EAAyC,MAAM,sBAAsB,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,+BAA+B,IAAI,mCAAmC,EAAE,MAAM,8BAA8B,CAAC;AACtH,OAAO,EACH,sBAAsB,GAGzB,MAAM,sBAAsB,CAAC;AAGvB,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,mCAAmC;IACpE,KAAK,CAAC,eAAe,CAC3B,KAA4B,EAC5B,QAA2B,EAC3B,IAAc;QAEd,OAAO,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;CACJ,CAAA;AARY,yBAAyB;IADrC,aAAa,CAAC,sBAAsB,EAAE,yBAAyB,CAAC;GACpD,yBAAyB,CAQrC;;AAED,8FAA8F;AAC9F,MAAM,UAAU,6BAA6B;IACzC,KAAK,yBAAyB,CAAC;AACnC,CAAC"}

package/dist/CheckoutMemberDiscountResolver.d.ts

@@ -24,6 +24,10 @@
  * enter it in a checkout's code field and get the member price without a token (#358). Before a typed
  * code is priced, every registered resolver is asked `IsMemberPromotionCode`, and a code any of them
  * claims is refused — on every widget, because promotion codes are not scoped to one.
+ *
+ * A MEMBER CODE AND A TYPED CODE DO NOT STACK unless the host says so. When a buyer with a verified
+ * token also types a code, the decision's `TypedCode` says which one is priced, or `'Stack'` to price
+ * both (#358); the default is the member code alone.
  */
 import { IMetadataProvider, UserInfo } from '@memberjunction/core';
 /** What a resolver is told about the checkout the token arrived with. */
@@ -43,12 +47,30 @@ export interface CheckoutTypedPromotionCodeContext {
     CompanyID: string;
     SessionID: string;
 }
+/**
+ * Which code wins when a verified token earns a member code and the buyer also typed one.
+ * - `'Replace'` — the member code is priced and the typed code is reported as not used.
+ * - `'Yield'` — the typed code is priced and the member code is set aside.
+ * - `'Stack'` — both are priced together, and the promotions' own stacking settings decide whether
+ *   both apply. Only a host that means its member discount to combine with other offers returns it.
+ *
+ * Under `'Replace'` and `'Yield'`, when the promotion engine declines the winning code, the other one
+ * is priced instead, so the buyer is never left at full price while a usable code is in play.
+ */
+export type CheckoutTypedCodePrecedence = 'Replace' | 'Yield' | 'Stack';
+/** Used when a resolver's decision names no precedence. */
+export declare const DEFAULT_TYPED_CODE_PRECEDENCE: CheckoutTypedCodePrecedence;
 /** A resolver's verdict. */
 export interface CheckoutMemberDiscountDecision {
     /** The promotion code to price with, or null when the token earns no discount. */
     PromotionCode: string | null;
     /** Shown to the buyer when no discount applies — e.g. why the token was not accepted. */
     Message?: string;
+    /**
+     * Whether `PromotionCode` replaces a code the buyer typed or yields to it. Defaults to
+     * {@link DEFAULT_TYPED_CODE_PRECEDENCE} (`'Replace'`). Ignored when no code was typed.
+     */
+    TypedCode?: CheckoutTypedCodePrecedence;
 }
 /**
  * Base class for a host's member-token verifier. Returning `{ PromotionCode: null }` prices the

package/dist/CheckoutMemberDiscountResolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CheckoutMemberDiscountResolver.d.ts","sourceRoot":"","sources":["../src/CheckoutMemberDiscountResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGnE,yEAAyE;AACzE,MAAM,WAAW,6BAA6B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,iFAAiF;AACjF,MAAM,WAAW,iCAAiC;IAC9C,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,4BAA4B;AAC5B,MAAM,WAAW,8BAA8B;IAC3C,kFAAkF;IAClF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,8BAAsB,kCAAkC;aACpC,OAAO,CACnB,GAAG,EAAE,6BAA6B,EAClC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GAAG,SAAS,GAC3B,OAAO,CAAC,8BAA8B,CAAC;IAE1C;;;;;;;OAOG;IACU,qBAAqB,CAC9B,IAAI,EAAE,iCAAiC,EACvC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,QAAQ,GAAG,SAAS,GAC5B,OAAO,CAAC,OAAO,CAAC;CAGtB;AAED;;;;GAIG;AACH,wBAAsB,+BAA+B,CACjD,GAAG,EAAE,iCAAiC,EACtC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GAAG,SAAS,GAC3B,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED,oEAAoE;AACpE,qBAAa,wCAAyC,SAAQ,KAAK;CAAG;AAEtE;;;;GAIG;AACH,wBAAgB,qCAAqC,CAAC,GAAG,EAAE,MAAM,GAAG,kCAAkC,CAcrG"}
+{"version":3,"file":"CheckoutMemberDiscountResolver.d.ts","sourceRoot":"","sources":["../src/CheckoutMemberDiscountResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGnE,yEAAyE;AACzE,MAAM,WAAW,6BAA6B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,iFAAiF;AACjF,MAAM,WAAW,iCAAiC;IAC9C,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,2BAA2B,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAExE,2DAA2D;AAC3D,eAAO,MAAM,6BAA6B,EAAE,2BAAuC,CAAC;AAEpF,4BAA4B;AAC5B,MAAM,WAAW,8BAA8B;IAC3C,kFAAkF;IAClF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,2BAA2B,CAAC;CAC3C;AAED;;;;GAIG;AACH,8BAAsB,kCAAkC;aACpC,OAAO,CACnB,GAAG,EAAE,6BAA6B,EAClC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GAAG,SAAS,GAC3B,OAAO,CAAC,8BAA8B,CAAC;IAE1C;;;;;;;OAOG;IACU,qBAAqB,CAC9B,IAAI,EAAE,iCAAiC,EACvC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,QAAQ,GAAG,SAAS,GAC5B,OAAO,CAAC,OAAO,CAAC;CAGtB;AAED;;;;GAIG;AACH,wBAAsB,+BAA+B,CACjD,GAAG,EAAE,iCAAiC,EACtC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GAAG,SAAS,GAC3B,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED,oEAAoE;AACpE,qBAAa,wCAAyC,SAAQ,KAAK;CAAG;AAEtE;;;;GAIG;AACH,wBAAgB,qCAAqC,CAAC,GAAG,EAAE,MAAM,GAAG,kCAAkC,CAcrG"}

package/dist/CheckoutMemberDiscountResolver.js

@@ -1,4 +1,6 @@
 import { MJGlobal } from '@memberjunction/global';
+/** Used when a resolver's decision names no precedence. */
+export const DEFAULT_TYPED_CODE_PRECEDENCE = 'Replace';
 /**
  * Base class for a host's member-token verifier. Returning `{ PromotionCode: null }` prices the
  * checkout at full price; throwing is treated the same way, with a generic message, so a verifier

package/dist/CheckoutMemberDiscountResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"CheckoutMemberDiscountResolver.js","sourceRoot":"","sources":["../src/CheckoutMemberDiscountResolver.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AA6BlD;;;;GAIG;AACH,MAAM,OAAgB,kCAAkC;IAOpD;;;;;;;OAOG;IACI,KAAK,CAAC,qBAAqB,CAC9B,IAAuC,EACvC,SAA4B,EAC5B,KAA2B;QAE3B,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACjD,GAAsC,EACtC,QAA2B,EAC3B,IAA0B;IAE1B,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,mBAAmB,CAAC,kCAAkC,CAAC,CAAC;IAC7G,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACxH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,cAAc,CAC1D,kCAAkC,EAClC,GAAG,CACN,CAAC;QACF,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,KAAK,kCAAkC,EAAE,CAAC;YAC3E,SAAS;QACb,CAAC;QACD,IAAI,CAAC;YACD,IAAI,MAAM,QAAQ,CAAC,qBAAqB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC5D,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,oEAAoE;AACpE,MAAM,OAAO,wCAAyC,SAAQ,KAAK;CAAG;AAEtE;;;;GAIG;AACH,MAAM,UAAU,qCAAqC,CAAC,GAAW;IAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,cAAc,CAC1D,kCAAkC,EAClC,GAAG,CACN,CAAC;IACF,kGAAkG;IAClG,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,KAAK,kCAAkC,EAAE,CAAC;QAC3E,MAAM,IAAI,wCAAwC,CAC9C,kDAAkD,GAAG,uBAAuB;YACxE,uDAAuD,GAAG,+BAA+B;YACzF,4DAA4D,CACnE,CAAC;IACN,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC"}
+{"version":3,"file":"CheckoutMemberDiscountResolver.js","sourceRoot":"","sources":["../src/CheckoutMemberDiscountResolver.ts"],"names":[],"mappings":"AAgCA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAiClD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,6BAA6B,GAAgC,SAAS,CAAC;AAepF;;;;GAIG;AACH,MAAM,OAAgB,kCAAkC;IAOpD;;;;;;;OAOG;IACI,KAAK,CAAC,qBAAqB,CAC9B,IAAuC,EACvC,SAA4B,EAC5B,KAA2B;QAE3B,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACjD,GAAsC,EACtC,QAA2B,EAC3B,IAA0B;IAE1B,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,mBAAmB,CAAC,kCAAkC,CAAC,CAAC;IAC7G,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACxH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,cAAc,CAC1D,kCAAkC,EAClC,GAAG,CACN,CAAC;QACF,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,KAAK,kCAAkC,EAAE,CAAC;YAC3E,SAAS;QACb,CAAC;QACD,IAAI,CAAC;YACD,IAAI,MAAM,QAAQ,CAAC,qBAAqB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC5D,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,oEAAoE;AACpE,MAAM,OAAO,wCAAyC,SAAQ,KAAK;CAAG;AAEtE;;;;GAIG;AACH,MAAM,UAAU,qCAAqC,CAAC,GAAW;IAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,cAAc,CAC1D,kCAAkC,EAClC,GAAG,CACN,CAAC;IACF,kGAAkG;IAClG,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,KAAK,kCAAkC,EAAE,CAAC;QAC3E,MAAM,IAAI,wCAAwC,CAC9C,kDAAkD,GAAG,uBAAuB;YACxE,uDAAuD,GAAG,+BAA+B;YACzF,4DAA4D,CACnE,CAAC;IACN,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/CheckoutSessionService.d.ts

@@ -10,6 +10,7 @@
 import { UserInfo } from '@memberjunction/core';
 import { type CheckoutWidgetConfiguration, type CheckoutAnswersInput, type CheckoutChoicesInput } from '@mj-biz-apps/orders-entities';
 import { type CheckoutRefusal } from './CheckoutPrePurchaseCheck.js';
+import { type CheckoutTypedCodePrecedence } from './CheckoutMemberDiscountResolver.js';
 export interface InitSessionResult {
     Success: boolean;
     ErrorMessage?: string;
@@ -113,9 +114,23 @@ export declare function NormalizeCheckoutPromotionCodes(input: unknown): {
 };
 /**
  * The codes a checkout prices with: the buyer's own codes plus the code a verified member token
- * earned, de-duplicated case-insensitively. Whether they stack is the promotion engine's call.
+ * earned, de-duplicated case-insensitively. A draft snapshots both only when the resolver chose
+ * `'Stack'` (see {@link PlanCheckoutPromotionCodes}), so at `/complete` this usually passes one side
+ * through; a session drafted before that rule may still carry both, and is priced as it was drafted.
  */
 export declare function CombineCheckoutPromotionCodes(buyerCodes: string[], memberCode: string | null | undefined): string[];
+/** One set of codes to price a draft with: the buyer's typed codes and the member code. */
+export interface CheckoutPromotionCodeAttempt {
+    Buyer: string[];
+    Member: string | null;
+}
+/**
+ * The code sets a draft tries, in order, when a member code and a typed code may both be present (#358).
+ * They do not stack: the precedence picks which is priced first, and the other is the fallback when the
+ * engine declines every code in the first. `'Stack'` prices both in one attempt. With only one side
+ * present, or the same code on both, there is a single attempt.
+ */
+export declare function PlanCheckoutPromotionCodes(buyerCodes: string[], memberCode: string | null | undefined, precedence: CheckoutTypedCodePrecedence | undefined): CheckoutPromotionCodeAttempt[];
 /** Outcome of booking CapturePayment after a checkout order is already confirmed. */
 export interface BookCheckoutPaymentResult {
     /** True when CapturePayment was invoked (or would have been, but a pre-check failed). */

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":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA+E,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAU7H,OAAO,EAgBH,KAAK,2BAA2B,EAOhC,KAAK,oBAAoB,EASzB,KAAK,oBAAoB,EAC5B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAwB,KAAK,eAAe,EAA2B,MAAM,+BAA+B,CAAC;AASpH,OAAO,EAKH,KAAK,2BAA2B,EACnC,MAAM,qCAAqC,CAAC;AAsC7C,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,2BAA2B,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAElD,MAAM,WAAW,yBAAyB;IACtC,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,kFAAkF;IAClF,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,kCAAkC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvC,0CAA0C;IAC1C,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAqBD,MAAM,WAAW,mBAAmB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,mGAAmG;IACnG,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,sGAAsG;IACtG,sBAAsB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2FAA2F;IAC3F,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAClC;AAYD,6FAA6F;AAC7F,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAIlD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAmBvG;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAKnH;AAED,2FAA2F;AAC3F,MAAM,WAAW,4BAA4B;IACzC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACtC,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,UAAU,EAAE,2BAA2B,GAAG,SAAS,GACpD,4BAA4B,EAAE,CAShC;AAuBD,qFAAqF;AACrF,MAAM,WAAW,yBAAyB;IACtC,yFAAyF;IACzF,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sGAAsG;IACtG,OAAO,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,qBAAa,sBAAsB;IAC/B;;OAEG;WACiB,iBAAiB,CACjC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,EACxB,WAAW,CAAC,EAAE,QAAQ,GACvB,OAAO,CAAC,iBAAiB,CAAC;IAmG7B;;;;;;OAMG;IACH;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CA0B9C;IAEH,OAAO,CAAC,MAAM,CAAC,8BAA8B;IAU7C,OAAO,CAAC,MAAM,CAAC,QAAQ;IAOvB;;;;;OAKG;mBACkB,wBAAwB;IAwB7C,2EAA2E;WACvD,uBAAuB,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAmChG;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAarC;;;;OAIG;mBACkB,oBAAoB;IAczC;;OAEG;IACH;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,4BAA4B;mBAwCtB,uBAAuB;IAgH5C;;;;;OAKG;mBACkB,qBAAqB;IAqE1C,+EAA+E;IAC/E,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAQhC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAuBlC,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAI/B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAuBlC;;OAEG;IACH;;;;;OAKG;mBACkB,qBAAqB;IAuD1C;;;;OAIG;mBACkB,gBAAgB;mBAShB,eAAe;IAepC;;OAEG;mBACkB,oBAAoB;IAyEzC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA2BlC;;;;;;;OAOG;WACiB,WAAW,CAC3B,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,iBAAiB,EAAE,EAC1B,cAAc,EAAE,2BAA2B,GAAG,IAAI,GAAG,SAAS,EAC9D,WAAW,CAAC,EAAE,QAAQ,EACtB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;QAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GACpJ,OAAO,CAAC,iBAAiB,CAAC;IAsb7B;;;;;;;;;OASG;WACiB,2BAA2B,CAC3C,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,WAAW,CAAC,EAAE,QAAQ,EACtB,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GACzC,OAAO,CAAC,8BAA8B,CAAC;IA8J1C,oFAAoF;mBAC/D,sBAAsB;IAqB3C;;;;;;OAMG;mBACkB,yBAAyB;IA6C9C;;;OAGG;mBACkB,SAAS;IAK9B;;;;OAIG;WACiB,gBAAgB,CAChC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,WAAW,CAAC,EAAE,QAAQ,GACvB,OAAO,CAAC,sBAAsB,CAAC;IA6clC,wFAAwF;IACxF,OAAO,CAAC,MAAM,CAAC,YAAY;IAU3B,sGAAsG;IACtG,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAKtC,OAAO,CAAC,MAAM,CAAC,YAAY;IAS3B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAQ5B,OAAO,CAAC,MAAM,CAAC,UAAU;IAKzB;;;;;;;OAOG;mBACkB,oBAAoB;mBAkBpB,kBAAkB;IA8BvC;;;;;OAKG;mBACkB,oBAAoB;IAiCzC;;;;;;;;;;;OAWG;WACiB,kCAAkC,CAClD,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,QAAQ,GACtB,OAAO,CAAC,yBAAyB,CAAC;IA8BrC;;;;OAIG;WACiB,aAAa,CAC7B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,QAAQ,EACrB,gBAAgB,EAAE,MAAM,GACzB,OAAO,CAAC,yBAAyB,GAAG,MAAM,CAAC;IAgB9C;;;;;;;OAOG;mBACkB,0BAA0B;mBAqI1B,aAAa;IAqBlC;;;OAGG;mBACkB,wBAAwB;IAkC7C;;;OAGG;mBACkB,2BAA2B;IA2BhD;;;OAGG;mBACkB,4BAA4B;IA0BjD;;OAEG;mBACkB,uBAAuB;CA0B/C"}

package/dist/CheckoutSessionService.js

@@ -20,7 +20,7 @@ import { ResolvePersonByEmail } from './PersonByEmail.js';
 import { OpenPaymentIntent, SUPPORTED_PAYMENT_CURRENCY } from './PaymentIntentService.js';
 import { ResolvePaymentProvider } from './PaymentProviderResolver.js';
 import { FindReusableProviderCustomerRef, SnapshotSellsSubscription, SaveCheckoutInstrumentForRenewals, } from './CheckoutSavedInstrument.js';
-import { CheckoutMemberDiscountNotConfiguredError, IsRegisteredMemberPromotionCode, ResolveCheckoutMemberDiscountResolver, } from './CheckoutMemberDiscountResolver.js';
+import { CheckoutMemberDiscountNotConfiguredError, DEFAULT_TYPED_CODE_PRECEDENCE, IsRegisteredMemberPromotionCode, ResolveCheckoutMemberDiscountResolver, } from './CheckoutMemberDiscountResolver.js';
 import { CapturePaymentOperation } from './CapturePaymentOperation.js';
 import { raiseCheckoutCaptureTerminalAlert, raiseCheckoutSettledNotBookedAlert } from './checkoutCaptureAlert.js';
 import { CheckoutStepLog } from './CheckoutStepLog.js';
@@ -86,7 +86,9 @@ export function NormalizeCheckoutPromotionCodes(input) {
 }
 /**
  * The codes a checkout prices with: the buyer's own codes plus the code a verified member token
- * earned, de-duplicated case-insensitively. Whether they stack is the promotion engine's call.
+ * earned, de-duplicated case-insensitively. A draft snapshots both only when the resolver chose
+ * `'Stack'` (see {@link PlanCheckoutPromotionCodes}), so at `/complete` this usually passes one side
+ * through; a session drafted before that rule may still carry both, and is priced as it was drafted.
  */
 export function CombineCheckoutPromotionCodes(buyerCodes, memberCode) {
     if (!memberCode || buyerCodes.some((c) => c.toLowerCase() === memberCode.toLowerCase())) {
@@ -94,6 +96,26 @@ export function CombineCheckoutPromotionCodes(buyerCodes, memberCode) {
     }
     return [...buyerCodes, memberCode];
 }
+/**
+ * The code sets a draft tries, in order, when a member code and a typed code may both be present (#358).
+ * They do not stack: the precedence picks which is priced first, and the other is the fallback when the
+ * engine declines every code in the first. `'Stack'` prices both in one attempt. With only one side
+ * present, or the same code on both, there is a single attempt.
+ */
+export function PlanCheckoutPromotionCodes(buyerCodes, memberCode, precedence) {
+    const member = memberCode || null;
+    const contested = !!member && buyerCodes.some((c) => c.toLowerCase() !== member.toLowerCase());
+    if (!contested || precedence === 'Stack') {
+        return [{ Buyer: [...buyerCodes], Member: member }];
+    }
+    const memberOnly = { Buyer: [], Member: member };
+    const typedOnly = { Buyer: [...buyerCodes], Member: null };
+    return (precedence ?? DEFAULT_TYPED_CODE_PRECEDENCE) === 'Yield' ? [typedOnly, memberOnly] : [memberOnly, typedOnly];
+}
+/** Why a typed code did nothing when the member code replaced it. Shown as "<code> can't be used: <reason>." */
+const TYPED_CODE_REPLACED_BY_MEMBER = 'your member discount applies instead, and the two cannot be combined';
+/** Why a member code was set aside for the buyer's typed code. */
+const MEMBER_CODE_YIELDED_TO_TYPED = 'Your member discount cannot be combined with a promotion code, so the code you entered is used instead.';
 const MEMBER_DISCOUNT_UNAVAILABLE = 'Your member discount could not be verified, so this checkout is priced at the standard rate.';
 /**
  * Shown when the payment settled but the order, re-priced at completion, now costs more than was paid:
@@ -656,7 +678,10 @@ export class CheckoutSessionService {
             }, md, contextUser);
             const code = typeof decision?.PromotionCode === 'string' ? decision.PromotionCode.trim() : '';
             if (code) {
-                return { PromotionCode: code };
+                // Anything but an explicit 'Yield' or 'Stack' takes the default, so a misspelt value
+                // cannot hand the price to a typed code the host meant to override.
+                const precedence = decision.TypedCode === 'Yield' || decision.TypedCode === 'Stack' ? decision.TypedCode : DEFAULT_TYPED_CODE_PRECEDENCE;
+                return { PromotionCode: code, TypedCode: precedence };
             }
             return { PromotionCode: null, Message: decision?.Message || MEMBER_DISCOUNT_UNAVAILABLE };
         }
@@ -1032,7 +1057,7 @@ export class CheckoutSessionService {
             });
             // Nothing is saved yet, so the location is priced inline; completion prices the same
             // location from the Address row it records.
-            const priced = await pricingService.Price({
+            const priceWith = async (codes) => pricingService.Price({
                 OrderHeaderID: order.ID || null,
                 CompanyID: widget.CompanyID,
                 BillToPersonID: order.BillToPersonID ?? null,
@@ -1049,23 +1074,54 @@ export class CheckoutSessionService {
                 ShipToAddressID: null,
                 ShipToAddress: this.toTaxAddress(location),
                 Lines: [...order.Lines.Items],
-                PromotionCodes: CombineCheckoutPromotionCodes(promotionCodes, memberDiscount.PromotionCode),
+                PromotionCodes: codes,
                 ManualDiscounts: [],
                 Charges: [],
             });
-            // Only the buyer's own codes are reported as unusable; a declined member code is explained
-            // through MemberDiscountMessage below.
-            const buyerKeys = new Set(promotionCodes.map((c) => c.toLowerCase()));
-            unusableCodes = (priced?.UnusableCodes ?? []).filter((u) => buyerKeys.has(u.Code.toLowerCase()));
+            // A member code and a typed code do not stack unless the resolver says 'Stack' (#358): the
+            // resolver's precedence picks which is priced, and the other is priced only when the engine
+            // declines the first.
+            const attempts = PlanCheckoutPromotionCodes(promotionCodes, memberDiscount.PromotionCode, memberDiscount.TypedCode);
+            // Every code the engine declined on any attempt, with its reason.
+            const declinedCodes = new Map();
+            let chosen = attempts[0];
+            for (let i = 0; i < attempts.length; i++) {
+                if (i > 0) {
+                    // The pricing walk keeps a discount a line already carries, so clear the previous
+                    // attempt's before re-pricing. Draft lines carry no other discount.
+                    for (const l of order.Lines.Items)
+                        l.DiscountAmount = 0;
+                }
+                chosen = attempts[i];
+                const codes = CombineCheckoutPromotionCodes(chosen.Buyer, chosen.Member);
+                const priced = await priceWith(codes);
+                const declinedNow = new Set((priced?.UnusableCodes ?? []).map((u) => u.Code.toLowerCase()));
+                for (const u of priced?.UnusableCodes ?? [])
+                    declinedCodes.set(u.Code.toLowerCase(), u);
+                if (codes.some((c) => !declinedNow.has(c.toLowerCase())))
+                    break;
+            }
+            // Only the buyer's own codes are reported as unusable; a declined or set-aside member code
+            // is explained through MemberDiscountMessage below.
+            const pricedBuyerKeys = new Set(chosen.Buyer.map((c) => c.toLowerCase()));
+            unusableCodes = promotionCodes.flatMap((c) => {
+                const declined = declinedCodes.get(c.toLowerCase());
+                if (declined)
+                    return [declined];
+                return pricedBuyerKeys.has(c.toLowerCase()) ? [] : [{ Code: c, Reason: TYPED_CODE_REPLACED_BY_MEMBER }];
+            });
             // The engine may still decline the code (dates, limits, qualifier). Price at full rate
             // and say why, rather than snapshotting a code `/complete` would also decline.
-            const declined = memberDiscount.PromotionCode
-                ? (priced?.UnusableCodes ?? []).find((u) => u.Code.toLowerCase() === memberDiscount.PromotionCode.toLowerCase())
-                : undefined;
+            const memberCode = memberDiscount.PromotionCode;
+            const declined = memberCode ? declinedCodes.get(memberCode.toLowerCase()) : undefined;
             if (declined) {
                 memberDiscount.PromotionCode = null;
                 memberDiscount.Message = `Your member discount does not apply to this order: ${declined.Reason}.`;
             }
+            else if (memberCode && !chosen.Member) {
+                memberDiscount.PromotionCode = null;
+                memberDiscount.Message = MEMBER_CODE_YIELDED_TO_TYPED;
+            }
             await this.settleLineTotals(order);
             order.TotalGross = this.sumLineTotals(order.Lines.Items);
         }