@openlup/platform 0.18.0 → 0.19.0

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"];

package/dist/promotions/quoteAutomaticPromotions.js

@@ -1,12 +1,30 @@
+import { selectAcquisitionTerms, assertAcquisitionTermsCapability, ACQUISITION_TERMS_CAPABILITY } from "../pricing/index.js";
 import { PROMOTION_ENGINE_V2 } from "../pricing/index.js";
-export function createQuoteAutomaticPromotions({ resolveEmailEligibility, evaluateOrderTotalDiscounts, evaluateAutomaticPromotionV2, legacyPromotionDataPort }) {
+export function createQuoteAutomaticPromotions({ resolveEmailEligibility, evaluateOrderTotalDiscounts, evaluateAutomaticPromotionV2, legacyPromotionDataPort, acquisition }) {
     async function resolveAutomaticQuotePromotions(input) {
         if (!input.promoDataPort)
             return { discounts: [], codeRejections: [] };
+        let promoDataPort = input.promoDataPort;
+        let selection = null;
+        let acquisitionCapability;
+        if (acquisition) {
+            const clientId = input.options?.clientId ?? null;
+            const [paid, allRows] = await Promise.all([
+                clientId ? promoDataPort.countPaidOrdersByMode(clientId) : Promise.resolve({ oneTime: 0, subscription: 0 }),
+                promoDataPort.listActivePromotions(),
+            ]);
+            const existingSubscriber = input.request.mode === "subscription" && paid.subscription > 0;
+            const rows = existingSubscriber ? allRows.filter((row) => !acquisition.financialPolicy.facts(row).metadataPresent && row.eligibility.first_subscription_purchase !== true) : allRows;
+            promoDataPort = { ...promoDataPort, listActivePromotions: async () => rows, countPaidOrdersByMode: async () => paid };
+            selection = input.request.mode === "subscription" && !existingSubscriber
+                ? selectAcquisitionTerms(rows, input.atTime, input.regionCode, acquisition.financialPolicy) : null;
+            acquisitionCapability = acquisition.capability(input.request);
+            assertAcquisitionTermsCapability(selection, acquisitionCapability, input.options?.pricingPolicy?.promotionEngineVersion);
+        }
         const emailEligibilityConfirmed = resolveEmailEligibility(input.request);
         if (input.options?.pricingPolicy?.promotionEngineVersion === PROMOTION_ENGINE_V2) {
             return evaluateAutomaticPromotionV2({
-                promoDataPort: input.promoDataPort,
+                promoDataPort,
                 clientId: input.options.clientId ?? null,
                 visitorId: input.request.visitorId ?? null,
                 mode: input.request.mode,
@@ -17,10 +35,11 @@ export function createQuoteAutomaticPromotions({ resolveEmailEligibility, evalua
                 shippingMinor: input.shippingGrossMinor,
                 atTime: input.atTime,
                 emailEligibilityConfirmed,
+                ...(acquisition ? { acquisitionCapability } : {}),
             });
         }
-        return evaluateOrderTotalDiscounts({
-            promoDataPort: legacyPromotionDataPort(input.promoDataPort),
+        const pending = evaluateOrderTotalDiscounts({
+            promoDataPort: legacyPromotionDataPort(promoDataPort),
             clientId: input.options?.clientId ?? null,
             visitorId: input.request.visitorId ?? null,
             mode: input.request.mode,
@@ -31,6 +50,11 @@ export function createQuoteAutomaticPromotions({ resolveEmailEligibility, evalua
             atTime: input.atTime,
             emailEligibilityConfirmed,
         });
+        if (!acquisition)
+            return pending;
+        const result = await pending;
+        return selection && acquisitionCapability === ACQUISITION_TERMS_CAPABILITY
+            ? { ...result, acquisitionTerms: selection.terms } : result;
     }
     return { resolveAutomaticQuotePromotions };
 }

package/dist/promotions/quotePromoDiscounts.d.ts

@@ -1,14 +1,18 @@
+import type { ResolvedAcquisitionTerms } from "../pricing/index.js";
+import type { QuoteAcquisitionBinding } from "./quoteAcquisitionBinding.js";
 import type { CreateQuoteRequest } from "../pricing/index.js";
 import type { CommerceCodeRejection, CommerceQuoteDiscount } from "../pricing/index.js";
 import type { PromotionRow } from "@openlup/core/promo";
 import type { CommercePromoDataPort } from "./promoDataPort.js";
 export interface QuoteDiscountResult {
+    acquisitionTerms?: ResolvedAcquisitionTerms;
     /** Applied discounts: order_total (clamped to subtotal) + at most one shipping discount. */
     discounts: CommerceQuoteDiscount[];
     /** Submitted coupon codes that produced no discount, with the reason. */
     codeRejections: CommerceCodeRejection[];
 }
-export declare function createQuotePromoDiscounts({ promotionCustomerSemantic }: {
+export declare function createQuotePromoDiscounts({ promotionCustomerSemantic, acquisition }: {
+    acquisition?: Pick<QuoteAcquisitionBinding, "financialPolicy">;
     promotionCustomerSemantic: (row: PromotionRow) => CommerceQuoteDiscount["customerSemantic"];
 }): {
     evaluateOrderTotalDiscounts: (input: {

package/dist/promotions/quotePromoDiscounts.js

@@ -1,5 +1,6 @@
+import { filterAcquisitionPromotions } from "../pricing/index.js";
 import { evaluatePromos, promoEligibilityFailure } from "@openlup/core/promo";
-export function createQuotePromoDiscounts({ promotionCustomerSemantic }) {
+export function createQuotePromoDiscounts({ promotionCustomerSemantic, acquisition }) {
     /**
      * Evaluate active promotions for this cart and map them to quote discounts. Two lanes:
      * `order_total` promos are clamped to the subtotal (so `discountTotal <= subtotal`), and
@@ -23,7 +24,12 @@ export function createQuotePromoDiscounts({ promotionCustomerSemantic }) {
             input.promoDataPort.redemptionCounts(input.clientId),
             input.promoDataPort.deviceFirstOrderRedeemed(input.visitorId ?? null),
         ]);
-        const candidates = allCandidates.filter((promo) => !capReached(promo, redemptionCounts.get(promo.id), input.clientId));
+        const customerCandidates = acquisition && input.mode === "subscription" && byMode.subscription > 0
+            ? allCandidates.filter((row) => !acquisition.financialPolicy.facts(row).metadataPresent && row.eligibility.first_subscription_purchase !== true)
+            : allCandidates;
+        const effectiveCandidates = acquisition && input.mode === "subscription"
+            ? filterAcquisitionPromotions(customerCandidates, input.atTime, input.regionCode, acquisition.financialPolicy) : customerCandidates;
+        const candidates = effectiveCandidates.filter((promo) => !capReached(promo, redemptionCounts.get(promo.id), input.clientId));
         const cart = {
             region_code: input.regionCode,
             cart_mode: input.mode === "subscription" ? "subscription" : "one_time",