@openlup/platform 0.18.0 → 0.20.0

package/dist/pricing/index.d.ts

@@ -1,7 +1,7 @@
 export * from "./contracts/index.js";
 export { CommercePriceAuthorityError } from "./ports.js";
 export type { CommercePriceAuthorityPort } from "./ports.js";
-export { createCommercePriceAuthorityPort, selectUniqueEffectivePriceList } from "./commercePriceAuthority.js";
+export { createCommercePriceAuthorityPort, createConcurrentCommercePriceAuthorityPort, selectUniqueEffectivePriceList } from "./commercePriceAuthority.js";
 export type { CommercePriceAuthorityReadPort, TimedAuthorityValue } from "./commercePriceAuthority.js";
 export { subscriptionPricePolicySemanticsSchema, subscriptionPricePolicyCanonicalInputSchema, subscriptionPricePolicyRevisionSchema, SubscriptionPricePolicyDigestError, canonicalSubscriptionPricePolicyTuple, digestSubscriptionPricePolicy, assertSubscriptionPricePolicyDigest, deriveSubscriptionUnitPrice } from "./subscriptionPricePolicy.js";
 export { offerPolicyVersionSchema, promotionEngineVersionSchema, pricingPolicyRequestSchema, pricingPolicySnapshotSchema } from "./offerPolicySchemas.js";
@@ -49,3 +49,4 @@ export * from "./acquisitionOfferPricingSchemas.js";
 export * from "./acquisitionOfferPricing.js";
 export * from "./acquisitionOfferPricingHandler.js";
 export * from "./acquisitionReadiness.js";
+export type { QuoteShippingPromotionInput, QuoteShippingPromotionResult } from "./quoteShippingPromotions.js";

package/dist/pricing/index.js

@@ -1,6 +1,6 @@
 export * from "./contracts/index.js";
 export { CommercePriceAuthorityError } from "./ports.js";
-export { createCommercePriceAuthorityPort, selectUniqueEffectivePriceList } from "./commercePriceAuthority.js";
+export { createCommercePriceAuthorityPort, createConcurrentCommercePriceAuthorityPort, selectUniqueEffectivePriceList } from "./commercePriceAuthority.js";
 export { subscriptionPricePolicySemanticsSchema, subscriptionPricePolicyCanonicalInputSchema, subscriptionPricePolicyRevisionSchema, SubscriptionPricePolicyDigestError, canonicalSubscriptionPricePolicyTuple, digestSubscriptionPricePolicy, assertSubscriptionPricePolicyDigest, deriveSubscriptionUnitPrice } from "./subscriptionPricePolicy.js";
 export { offerPolicyVersionSchema, promotionEngineVersionSchema, pricingPolicyRequestSchema, pricingPolicySnapshotSchema } from "./offerPolicySchemas.js";
 export { createPricingPolicyToken, verifyPricingPolicyToken, resolvePricingPolicy } from "./pricingPolicyToken.js";

package/dist/pricing/offerPolicySchemas.d.ts

@@ -4,8 +4,8 @@ export declare const offerPolicyVersionSchema: z.ZodEnum<{
     "commerce.offer-policy.v2": "commerce.offer-policy.v2";
 }>;
 export declare const promotionEngineVersionSchema: z.ZodEnum<{
-    "promotion-engine.v2": "promotion-engine.v2";
     "promotion-engine.v1": "promotion-engine.v1";
+    "promotion-engine.v2": "promotion-engine.v2";
 }>;
 /** Client capability plus an opaque server-signed assignment. Never a version selector. */
 export declare const pricingPolicyRequestSchema: z.ZodObject<{
@@ -18,8 +18,8 @@ export declare const pricingPolicySnapshotSchema: z.ZodObject<{
         "commerce.offer-policy.v2": "commerce.offer-policy.v2";
     }>;
     promotionEngineVersion: z.ZodEnum<{
-        "promotion-engine.v2": "promotion-engine.v2";
         "promotion-engine.v1": "promotion-engine.v1";
+        "promotion-engine.v2": "promotion-engine.v2";
     }>;
     pricingPolicyToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;

package/dist/pricing/offerPricingSchemas.d.ts

@@ -99,8 +99,8 @@ export declare function createCommerceOfferPricingSchemas<ScopeV1 extends string
                 "commerce.offer-policy.v2": "commerce.offer-policy.v2";
             }>;
             promotionEngineVersion: z.ZodEnum<{
-                "promotion-engine.v2": "promotion-engine.v2";
                 "promotion-engine.v1": "promotion-engine.v1";
+                "promotion-engine.v2": "promotion-engine.v2";
             }>;
             pricingPolicyToken: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>;
@@ -241,8 +241,8 @@ export declare function createCommerceOfferPricingSchemas<ScopeV1 extends string
                 "commerce.offer-policy.v2": "commerce.offer-policy.v2";
             }>;
             promotionEngineVersion: z.ZodEnum<{
-                "promotion-engine.v2": "promotion-engine.v2";
                 "promotion-engine.v1": "promotion-engine.v1";
+                "promotion-engine.v2": "promotion-engine.v2";
             }>;
             pricingPolicyToken: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>;

package/dist/pricing/pricingPolicyToken.d.ts

@@ -29,11 +29,11 @@ export declare function resolvePricingPolicy(input: {
     promotionEngineVersion: PromotionEngineVersion;
 } | {
     offerPolicyVersion: "commerce.offer-policy.v1" | "commerce.offer-policy.v2";
-    promotionEngineVersion: "promotion-engine.v2" | "promotion-engine.v1";
+    promotionEngineVersion: "promotion-engine.v1" | "promotion-engine.v2";
     pricingPolicyToken?: undefined;
 } | {
     offerPolicyVersion: "commerce.offer-policy.v1" | "commerce.offer-policy.v2";
-    promotionEngineVersion: "promotion-engine.v2" | "promotion-engine.v1";
+    promotionEngineVersion: "promotion-engine.v1" | "promotion-engine.v2";
     pricingPolicyToken: string;
 };
 export {};

package/dist/pricing/quoteSchemas.d.ts

@@ -33,8 +33,8 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
     }, z.core.$strip>;
     quotePricingComponentSchema: z.ZodObject<{
         scope: z.ZodEnum<{
-            order: "order";
             line: "line";
+            order: "order";
         }>;
         componentType: z.ZodEnum<{
             bundle: "bundle";
@@ -111,8 +111,8 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
         }, z.core.$strip>;
         pricingComponents: z.ZodOptional<z.ZodArray<z.ZodObject<{
             scope: z.ZodEnum<{
-                order: "order";
                 line: "line";
+                order: "order";
             }>;
             componentType: z.ZodEnum<{
                 bundle: "bundle";
@@ -162,11 +162,11 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
     quoteCodeRejectionSchema: z.ZodObject<{
         code: z.ZodString;
         reason: z.ZodEnum<{
-            expired: "expired";
             scope_not_applicable: "scope_not_applicable";
             not_recognized: "not_recognized";
             already_used: "already_used";
             not_eligible: "not_eligible";
+            expired: "expired";
             better_price_exists: "better_price_exists";
         }>;
     }, z.core.$strict>;
@@ -206,8 +206,8 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
             }, z.core.$strip>;
             pricingComponents: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 scope: z.ZodEnum<{
-                    order: "order";
                     line: "line";
+                    order: "order";
                 }>;
                 componentType: z.ZodEnum<{
                     bundle: "bundle";
@@ -293,11 +293,11 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
         codeRejections: z.ZodOptional<z.ZodArray<z.ZodObject<{
             code: z.ZodString;
             reason: z.ZodEnum<{
-                expired: "expired";
                 scope_not_applicable: "scope_not_applicable";
                 not_recognized: "not_recognized";
                 already_used: "already_used";
                 not_eligible: "not_eligible";
+                expired: "expired";
                 better_price_exists: "better_price_exists";
             }>;
         }, z.core.$strict>>>;
@@ -322,8 +322,8 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
         }, z.core.$strict>], "reason">>>;
         pricingComponents: z.ZodOptional<z.ZodArray<z.ZodObject<{
             scope: z.ZodEnum<{
-                order: "order";
                 line: "line";
+                order: "order";
             }>;
             componentType: z.ZodEnum<{
                 bundle: "bundle";
@@ -406,8 +406,8 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
                 }, z.core.$strip>;
                 pricingComponents: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     scope: z.ZodEnum<{
-                        order: "order";
                         line: "line";
+                        order: "order";
                     }>;
                     componentType: z.ZodEnum<{
                         bundle: "bundle";
@@ -493,11 +493,11 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
             codeRejections: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 code: z.ZodString;
                 reason: z.ZodEnum<{
-                    expired: "expired";
                     scope_not_applicable: "scope_not_applicable";
                     not_recognized: "not_recognized";
                     already_used: "already_used";
                     not_eligible: "not_eligible";
+                    expired: "expired";
                     better_price_exists: "better_price_exists";
                 }>;
             }, z.core.$strict>>>;
@@ -522,8 +522,8 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
             }, z.core.$strict>], "reason">>>;
             pricingComponents: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 scope: z.ZodEnum<{
-                    order: "order";
                     line: "line";
+                    order: "order";
                 }>;
                 componentType: z.ZodEnum<{
                     bundle: "bundle";
@@ -607,8 +607,8 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
                 }, z.core.$strip>;
                 pricingComponents: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     scope: z.ZodEnum<{
-                        order: "order";
                         line: "line";
+                        order: "order";
                     }>;
                     componentType: z.ZodEnum<{
                         bundle: "bundle";
@@ -694,11 +694,11 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
             codeRejections: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 code: z.ZodString;
                 reason: z.ZodEnum<{
-                    expired: "expired";
                     scope_not_applicable: "scope_not_applicable";
                     not_recognized: "not_recognized";
                     already_used: "already_used";
                     not_eligible: "not_eligible";
+                    expired: "expired";
                     better_price_exists: "better_price_exists";
                 }>;
             }, z.core.$strict>>>;
@@ -723,8 +723,8 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
             }, z.core.$strict>], "reason">>>;
             pricingComponents: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 scope: z.ZodEnum<{
-                    order: "order";
                     line: "line";
+                    order: "order";
                 }>;
                 componentType: z.ZodEnum<{
                     bundle: "bundle";
@@ -809,8 +809,8 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
                 }, z.core.$strip>;
                 pricingComponents: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     scope: z.ZodEnum<{
-                        order: "order";
                         line: "line";
+                        order: "order";
                     }>;
                     componentType: z.ZodEnum<{
                         bundle: "bundle";
@@ -896,11 +896,11 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
             codeRejections: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 code: z.ZodString;
                 reason: z.ZodEnum<{
-                    expired: "expired";
                     scope_not_applicable: "scope_not_applicable";
                     not_recognized: "not_recognized";
                     already_used: "already_used";
                     not_eligible: "not_eligible";
+                    expired: "expired";
                     better_price_exists: "better_price_exists";
                 }>;
             }, z.core.$strict>>>;
@@ -925,8 +925,8 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
             }, z.core.$strict>], "reason">>>;
             pricingComponents: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 scope: z.ZodEnum<{
-                    order: "order";
                     line: "line";
+                    order: "order";
                 }>;
                 componentType: z.ZodEnum<{
                     bundle: "bundle";
@@ -1010,8 +1010,8 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
                 }, z.core.$strip>;
                 pricingComponents: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     scope: z.ZodEnum<{
-                        order: "order";
                         line: "line";
+                        order: "order";
                     }>;
                     componentType: z.ZodEnum<{
                         bundle: "bundle";
@@ -1097,11 +1097,11 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
             codeRejections: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 code: z.ZodString;
                 reason: z.ZodEnum<{
-                    expired: "expired";
                     scope_not_applicable: "scope_not_applicable";
                     not_recognized: "not_recognized";
                     already_used: "already_used";
                     not_eligible: "not_eligible";
+                    expired: "expired";
                     better_price_exists: "better_price_exists";
                 }>;
             }, z.core.$strict>>>;
@@ -1126,8 +1126,8 @@ export declare function createCommerceQuoteSchemas<Context extends z.ZodType>(in
             }, z.core.$strict>], "reason">>>;
             pricingComponents: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 scope: z.ZodEnum<{
-                    order: "order";
                     line: "line";
+                    order: "order";
                 }>;
                 componentType: z.ZodEnum<{
                     bundle: "bundle";

package/dist/pricing/quoteShippingPromotions.d.ts

@@ -0,0 +1,20 @@
+import type { ShippingTerms } from "../shipping/index.js";
+import type { ResolvedAcquisitionTerms } from "./contracts/acquisitionTerms.js";
+import type { CreateQuoteRequest } from "./contracts/quote.js";
+import type { CreateQuoteOptions } from "./quotePorts.js";
+import type { QuotePromotionResult } from "./dbBackedCommerceQuotePort.js";
+export interface QuoteShippingPromotionInput<Request extends CreateQuoteRequest> {
+    request: Request;
+    options?: CreateQuoteOptions;
+    regionCode: string;
+    currency: string;
+    referenceProductMinor: number;
+    subtotalGrossMinor: number;
+    atTime: string;
+}
+export interface QuoteShippingPromotionResult extends QuotePromotionResult {
+    shippingGrossMinor: number;
+    hasShipping: boolean;
+    shippingTerms?: ShippingTerms;
+    acquisitionTerms?: ResolvedAcquisitionTerms;
+}

package/dist/pricing/quoteShippingPromotions.js

@@ -0,0 +1 @@
+export {};

package/dist/promotions/adminPromotionCodesContracts.d.ts

@@ -107,8 +107,8 @@ export declare const promotionCodePreviewRequestSchema: z.ZodObject<{
         subscription_initial: "subscription_initial";
     }>>;
     promotionEngineVersion: z.ZodDefault<z.ZodEnum<{
-        "promotion-engine.v2": "promotion-engine.v2";
         "promotion-engine.v1": "promotion-engine.v1";
+        "promotion-engine.v2": "promotion-engine.v2";
     }>>;
     minimumReferenceMinor: z.ZodDefault<z.ZodNumber>;
     context: z.ZodObject<{
@@ -150,8 +150,8 @@ export declare const promotionCodePreviewResultSchema: z.ZodObject<{
 export declare const promotionCodePreviewResponseSchema: z.ZodObject<{
     contractVersion: z.ZodLiteral<"commerce.v0">;
     promotionEngineVersion: z.ZodEnum<{
-        "promotion-engine.v2": "promotion-engine.v2";
         "promotion-engine.v1": "promotion-engine.v1";
+        "promotion-engine.v2": "promotion-engine.v2";
     }>;
     previewProof: z.ZodString;
     results: z.ZodArray<z.ZodObject<{
@@ -292,8 +292,8 @@ export declare const promotionCodesListRequestSchema: z.ZodObject<{
         archived: "archived";
         all: "all";
         expired: "expired";
-        paused: "paused";
         scheduled: "scheduled";
+        paused: "paused";
         expired_or_archived: "expired_or_archived";
     }>>;
     scope: z.ZodDefault<z.ZodEnum<{
@@ -358,8 +358,8 @@ export declare const promotionCodeSummarySchema: z.ZodObject<{
         validationState: z.ZodLiteral<"unsupported_legacy_value">;
     }, z.core.$strict>]>>;
     promotionEngineVersion: z.ZodEnum<{
-        "promotion-engine.v2": "promotion-engine.v2";
         "promotion-engine.v1": "promotion-engine.v1";
+        "promotion-engine.v2": "promotion-engine.v2";
     }>;
     scopes: z.ZodArray<z.ZodEnum<{
         one_time: "one_time";
@@ -376,8 +376,8 @@ export declare const promotionCodeSummarySchema: z.ZodObject<{
         active: "active";
         archived: "archived";
         expired: "expired";
-        paused: "paused";
         scheduled: "scheduled";
+        paused: "paused";
     }>;
     validFrom: z.ZodString;
     validTo: z.ZodNullable<z.ZodString>;
@@ -444,8 +444,8 @@ export declare const promotionCodesListResponseSchema: z.ZodObject<{
             validationState: z.ZodLiteral<"unsupported_legacy_value">;
         }, z.core.$strict>]>>;
         promotionEngineVersion: z.ZodEnum<{
-            "promotion-engine.v2": "promotion-engine.v2";
             "promotion-engine.v1": "promotion-engine.v1";
+            "promotion-engine.v2": "promotion-engine.v2";
         }>;
         scopes: z.ZodArray<z.ZodEnum<{
             one_time: "one_time";
@@ -462,8 +462,8 @@ export declare const promotionCodesListResponseSchema: z.ZodObject<{
             active: "active";
             archived: "archived";
             expired: "expired";
-            paused: "paused";
             scheduled: "scheduled";
+            paused: "paused";
         }>;
         validFrom: z.ZodString;
         validTo: z.ZodNullable<z.ZodString>;

package/dist/promotions/commerceQuoteReadPreparation.d.ts

@@ -0,0 +1,3 @@
+import type { CommercePromoDataPort } from "./promoDataPort.js";
+/** Allocate inside one quote resolution; clone each evaluator's mutable raw view. */
+export declare function memoizeCommercePromoReads(inner: CommercePromoDataPort): CommercePromoDataPort;

package/dist/promotions/commerceQuoteReadPreparation.js

@@ -0,0 +1,27 @@
+/** Allocate inside one quote resolution; clone each evaluator's mutable raw view. */
+export function memoizeCommercePromoReads(inner) {
+    const definitions = memoize(() => inner.listActivePromotions());
+    const paid = memoize((id) => inner.countPaidOrders(id));
+    const modes = memoize((id) => inner.countPaidOrdersByMode(id));
+    const redemptions = memoize((id) => inner.redemptionCounts(id));
+    const device = memoize((id) => inner.deviceFirstOrderRedeemed(id));
+    return {
+        listActivePromotions: async () => structuredClone(await definitions()),
+        countPaidOrders: paid,
+        countPaidOrdersByMode: async (id) => ({ ...await modes(id) }),
+        redemptionCounts: async (id) => structuredClone(await redemptions(id)),
+        deviceFirstOrderRedeemed: device,
+    };
+}
+function memoize(read) {
+    const values = new Map();
+    return (...args) => {
+        const key = JSON.stringify(args);
+        let value = values.get(key);
+        if (!value) {
+            value = Promise.resolve().then(() => read(...args));
+            values.set(key, value);
+        }
+        return value;
+    };
+}

package/dist/promotions/index.d.ts

@@ -20,3 +20,6 @@ export * from "./promotionClaimSweepPort.js";
 export * from "./promotionClaims.js";
 export * from "./sql.js";
 export type { PromotionStatus, AdminPromotion, AdminPromotionV2Mirror, AdminPromotionSemanticBenefit, AdminPromotionsListResponse, AdminPromotionUpdatePayload, AdminPromotionUpdateRequest, AdminPromotionUpdateResponse } from "./contracts/index.js";
+export type { QuoteAcquisitionBinding } from "./quoteAcquisitionBinding.js";
+export { createQuoteShippingPromotions } from "./quoteShippingPolicy.js";
+export type { QuoteShippingPromotionsDeps } from "./quoteShippingPolicy.js";

package/dist/promotions/index.js

@@ -19,3 +19,4 @@ export * from "./adminPromotionCodesDataPort.js";
 export * from "./promotionClaimSweepPort.js";
 export * from "./promotionClaims.js";
 export * from "./sql.js";
+export { createQuoteShippingPromotions } from "./quoteShippingPolicy.js";

package/dist/promotions/promotionQuoteAcceptance.d.ts

@@ -1,3 +1,4 @@
+import type { ShippingTerms } from "../shipping/index.js";
 import type { ResolvedAcquisitionTerms } from "../pricing/index.js";
 import type { CommerceQuote } from "../pricing/index.js";
 import type { PromotionAcceptanceTelemetry } from "./promotionAcceptanceTelemetry.js";
@@ -25,6 +26,7 @@ export declare function createPromotionQuoteAcceptance<Request extends {
         request: Request;
         quote: CommerceQuote;
         acquisitionTerms?: ResolvedAcquisitionTerms;
+        shippingTerms?: ShippingTerms;
         keyring: PromotionAcceptanceKeyring;
         now?: Date;
     }) => string | null;
@@ -32,6 +34,7 @@ export declare function createPromotionQuoteAcceptance<Request extends {
         request: Request;
         quote: CommerceQuote;
         acquisitionTerms?: ResolvedAcquisitionTerms;
+        shippingTerms?: ShippingTerms;
         keyring: PromotionAcceptanceKeyring;
         now?: Date;
     }) => {
@@ -43,6 +46,7 @@ export declare function createPromotionQuoteAcceptance<Request extends {
         request: Request;
         quote: CommerceQuote;
         acquisitionTerms?: ResolvedAcquisitionTerms;
+        shippingTerms?: ShippingTerms;
         expectedTotal: {
             amountMinor: number;
             currency: string;
@@ -55,6 +59,7 @@ export declare function createPromotionQuoteAcceptance<Request extends {
         request: Request;
         quote: CommerceQuote;
         acquisitionTerms?: ResolvedAcquisitionTerms;
+        shippingTerms?: ShippingTerms;
         expectedTotal: {
             amountMinor: number;
             currency: string;

package/dist/promotions/promotionQuoteAcceptance.js

@@ -25,7 +25,7 @@ export function createPromotionQuoteAcceptance({ projectRequest }) {
     }
     function issuePromotionQuoteAcceptanceWithOutcome(input) {
         const evidence = v2Discounts(input.quote);
-        if (evidence.length === 0 && !input.acquisitionTerms)
+        if (evidence.length === 0 && !input.acquisitionTerms && !input.shippingTerms)
             return {
                 token: null,
                 diagnostic: rejected("no_v2_adjustment"),
@@ -47,8 +47,8 @@ export function createPromotionQuoteAcceptance({ projectRequest }) {
             engine: "promotion-engine.v2",
             requestBinding: requestBinding(input.request, input.keyring.current),
             codeBinding: codeBinding(input.request.promoCodes, input.keyring.current),
-            quoteBinding: quoteBinding(input.quote, input.keyring.current, input.acquisitionTerms),
-            sectionBindings: sectionBindings(input.quote, input.keyring.current, input.acquisitionTerms),
+            quoteBinding: quoteBinding(input.quote, input.keyring.current, input.acquisitionTerms, input.shippingTerms),
+            sectionBindings: sectionBindings(input.quote, input.keyring.current, input.acquisitionTerms, input.shippingTerms),
             totalMinor: input.quote.totalGross.amountMinor,
             currency: input.quote.totalGross.currency,
         });
@@ -78,8 +78,8 @@ export function createPromotionQuoteAcceptance({ projectRequest }) {
         if (payload.codeBinding !== codeBinding(input.request.promoCodes, secret)) {
             return { accepted: false, reason: "code_mismatch", ...base };
         }
-        if (payload.quoteBinding !== quoteBinding(input.quote, secret, input.acquisitionTerms)) {
-            const mismatchField = namedMismatchField(payload.sectionBindings, input.quote, secret, input.acquisitionTerms);
+        if (payload.quoteBinding !== quoteBinding(input.quote, secret, input.acquisitionTerms, input.shippingTerms)) {
+            const mismatchField = namedMismatchField(payload.sectionBindings, input.quote, secret, input.acquisitionTerms, input.shippingTerms);
             return { accepted: false, reason: "quote_mismatch", mismatchField, ...base };
         }
         if (payload.totalMinor !== input.expectedTotal.amountMinor) {
@@ -88,7 +88,7 @@ export function createPromotionQuoteAcceptance({ projectRequest }) {
         if (payload.currency !== input.expectedTotal.currency) {
             return { accepted: false, reason: "currency_mismatch", ...base };
         }
-        if (v2Discounts(input.quote).length === 0 && !input.acquisitionTerms) {
+        if (v2Discounts(input.quote).length === 0 && !input.acquisitionTerms && !input.shippingTerms) {
             return { accepted: false, reason: "no_v2_adjustment_in_quote", ...base };
         }
         return { accepted: true, reason: "accepted", ...base };
@@ -161,11 +161,11 @@ export function createPromotionQuoteAcceptance({ projectRequest }) {
     function codeBinding(codes, secret) {
         return hmac(secret, stableJson([...new Set(codes.map((code) => code.trim().toUpperCase()))].sort()));
     }
-    function quoteBinding(quote, secret, acquisitionTerms) {
-        return hmac(secret, stableJson(projectPromotionQuoteMoney(quote, acquisitionTerms)));
+    function quoteBinding(quote, secret, acquisitionTerms, shippingTerms) {
+        return hmac(secret, stableJson(projectPromotionQuoteMoney(quote, acquisitionTerms, shippingTerms)));
     }
-    function sectionBindings(quote, secret, acquisitionTerms) {
-        const sections = promotionQuoteMoneySections(quote, acquisitionTerms);
+    function sectionBindings(quote, secret, acquisitionTerms, shippingTerms) {
+        const sections = promotionQuoteMoneySections(quote, acquisitionTerms, shippingTerms);
         return Object.fromEntries(PROMOTION_QUOTE_MONEY_SECTIONS
             .map((section) => [section, hmac(secret, stableJson(sections[section]))]));
     }
@@ -173,10 +173,10 @@ export function createPromotionQuoteAcceptance({ projectRequest }) {
      * The verifier holds only the issuer's HMACs, never the issued quote, so the
      * differing section is found by comparing per-section hashes in a fixed order.
      */
-    function namedMismatchField(issued, quote, secret, acquisitionTerms) {
+    function namedMismatchField(issued, quote, secret, acquisitionTerms, shippingTerms) {
         if (!issued)
             return "other";
-        const verified = sectionBindings(quote, secret, acquisitionTerms);
+        const verified = sectionBindings(quote, secret, acquisitionTerms, shippingTerms);
         return PROMOTION_QUOTE_MONEY_SECTIONS
             .find((section) => issued[section] !== verified[section]) ?? "other";
     }

package/dist/promotions/promotionQuoteBinding.d.ts

@@ -1,3 +1,4 @@
+import type { ShippingTerms } from "../shipping/index.js";
 import { type ResolvedAcquisitionTerms } from "../pricing/index.js";
 import type { CommerceMoney, CommerceQuote, CommerceQuoteDiscount } from "../pricing/index.js";
 /**
@@ -43,6 +44,7 @@ export interface PromotionQuoteMoneyDiscount {
 }
 export interface PromotionQuoteMoneyProjection {
     acquisitionTerms?: ResolvedAcquisitionTerms;
+    shippingTerms?: ShippingTerms;
     currency: string;
     totalGross: CommerceMoney;
     netTotal: CommerceMoney;
@@ -64,8 +66,8 @@ export type PromotionQuoteMismatchField = (typeof PROMOTION_QUOTE_MISMATCH_FIELD
  * Discount order is preserved: the promotion engine emits its lanes
  * deterministically, so a reordering is a real evaluation difference.
  */
-export declare function projectPromotionQuoteMoney(quote: CommerceQuote, acquisitionTerms?: ResolvedAcquisitionTerms): PromotionQuoteMoneyProjection;
+export declare function projectPromotionQuoteMoney(quote: CommerceQuote, acquisitionTerms?: ResolvedAcquisitionTerms, shippingTerms?: ShippingTerms): PromotionQuoteMoneyProjection;
 /** Same projection, partitioned. The union of these five sections is the whole projection. */
-export declare function promotionQuoteMoneySections(quote: CommerceQuote, acquisitionTerms?: ResolvedAcquisitionTerms): Record<PromotionQuoteMoneySection, unknown>;
+export declare function promotionQuoteMoneySections(quote: CommerceQuote, acquisitionTerms?: ResolvedAcquisitionTerms, shippingTerms?: ShippingTerms): Record<PromotionQuoteMoneySection, unknown>;
 /** Key-sorted, `undefined`-dropping JSON. Every acceptance binding hashes this shape. */
 export declare function stableJson(value: unknown): string;

package/dist/promotions/promotionQuoteBinding.js

@@ -16,7 +16,7 @@ export const PROMOTION_QUOTE_MISMATCH_FIELDS = [
  * Discount order is preserved: the promotion engine emits its lanes
  * deterministically, so a reordering is a real evaluation difference.
  */
-export function projectPromotionQuoteMoney(quote, acquisitionTerms) {
+export function projectPromotionQuoteMoney(quote, acquisitionTerms, shippingTerms) {
     return {
         ...acquisitionQuoteBinding(acquisitionTerms),
         currency: quote.currency,
@@ -27,6 +27,7 @@ export function projectPromotionQuoteMoney(quote, acquisitionTerms) {
         discountTotalGross: quote.discountTotalGross,
         shippingGross: quote.shippingGross ?? null,
         shippingDiscountGross: quote.shippingDiscountGross ?? null,
+        ...(shippingTerms ? { shippingTerms } : {}),
         lines: quote.lines.map((line) => ({
             sku: line.sku,
             quantity: line.quantity,
@@ -52,14 +53,15 @@ export function projectPromotionQuoteMoney(quote, acquisitionTerms) {
     };
 }
 /** Same projection, partitioned. The union of these five sections is the whole projection. */
-export function promotionQuoteMoneySections(quote, acquisitionTerms) {
-    const money = projectPromotionQuoteMoney(quote, acquisitionTerms);
+export function promotionQuoteMoneySections(quote, acquisitionTerms, shippingTerms) {
+    const money = projectPromotionQuoteMoney(quote, acquisitionTerms, shippingTerms);
     return {
         lines: money.lines,
         discounts: money.discounts,
         shipping: {
             shippingGross: money.shippingGross,
             shippingDiscountGross: money.shippingDiscountGross,
+            ...(money.shippingTerms ? { shippingTerms: money.shippingTerms } : {}),
         },
         totals: {
             ...acquisitionQuoteBinding(money.acquisitionTerms),

package/dist/promotions/quoteAcquisitionBinding.d.ts

@@ -0,0 +1,6 @@
+import type { PromotionRow } from "@openlup/core/promo";
+import type { AcquisitionFinancialPolicy } from "../pricing/index.js";
+export interface QuoteAcquisitionBinding<Request = unknown> {
+    financialPolicy: AcquisitionFinancialPolicy<PromotionRow>;
+    capability(request: Request): unknown;
+}

package/dist/promotions/quoteAcquisitionBinding.js

@@ -0,0 +1 @@
+export {};

package/dist/promotions/quoteAutomaticPromotions.d.ts

@@ -1,3 +1,4 @@
+import type { QuoteAcquisitionBinding } from "./quoteAcquisitionBinding.js";
 import type { CreateQuoteRequest } from "../pricing/index.js";
 import type { CreateQuoteOptions } from "../pricing/index.js";
 import type { CommercePromoDataPort } from "./promoDataPort.js";
@@ -5,7 +6,8 @@ import type { createQuotePromoDiscounts, QuoteDiscountResult } from "./quoteProm
 import type { createQuotePromotionV2 } from "./quotePromotionV2.js";
 export declare function createQuoteAutomaticPromotions<Request extends CreateQuoteRequest & {
     visitorId?: string;
-}>({ resolveEmailEligibility, evaluateOrderTotalDiscounts, evaluateAutomaticPromotionV2, legacyPromotionDataPort }: {
+}>({ resolveEmailEligibility, evaluateOrderTotalDiscounts, evaluateAutomaticPromotionV2, legacyPromotionDataPort, acquisition }: {
+    acquisition?: QuoteAcquisitionBinding<Request>;
     resolveEmailEligibility(request: Request): boolean;
     evaluateOrderTotalDiscounts: ReturnType<typeof createQuotePromoDiscounts>["evaluateOrderTotalDiscounts"];
     evaluateAutomaticPromotionV2: ReturnType<typeof createQuotePromotionV2>["evaluateAutomaticPromotionV2"];