@openlup/platform 0.18.0 → 0.19.0

package/dist/composition/inventoryContribution.js

@@ -0,0 +1,17 @@
+/** Structural selected callables keep inventory and catalog declarations independent. */
+export function createInventoryContribution(input) {
+    const contribution = {
+        manifest: {
+            name: "@openlup/platform", version: input.version, kind: "rail",
+            module: { id: "inventory", kind: "capability", provides: ["./inventory"], dependsOn: [] },
+            emits: [], handles: [], schedules: [], env: [], requiredPorts: Object.keys(input.inventory),
+            routes: input.routes.map(route => route.id), requiredSchema: input.requiredSchema,
+        },
+        handlers: [], schedules: [], routes: input.routes,
+    };
+    return {
+        contributions: [contribution],
+        ports: Object.fromEntries(Object.entries(input.inventory).filter(([, fn]) => typeof fn === "function").map(([name, fn]) => [`@openlup/platform/inventory:${name}`, fn])),
+        routes: Object.fromEntries(input.routes.map(route => [`@openlup/platform/inventory:${route.id}`, route.handle])),
+    };
+}

package/dist/composition/shippingContribution.d.ts

@@ -0,0 +1,16 @@
+import type { Contribution, RequiredSchema } from "@openlup/core/readiness";
+/** Structural selected callables keep shipping declarations independent. */
+export declare function createShippingContribution(input: {
+    version: string;
+    requiredSchema: RequiredSchema;
+    shipping: Readonly<Record<string, ((...args: never[]) => unknown) | null>>;
+    routes: Contribution["routes"];
+}): {
+    contributions: Contribution[];
+    ports: {
+        [k: string]: ((...args: never[]) => unknown) | null;
+    };
+    routes: {
+        [k: string]: (...args: never[]) => unknown;
+    };
+};

package/dist/composition/shippingContribution.js

@@ -0,0 +1,17 @@
+/** Structural selected callables keep shipping declarations independent. */
+export function createShippingContribution(input) {
+    const contribution = {
+        manifest: {
+            name: "@openlup/platform", version: input.version, kind: "rail",
+            module: { id: "shipping", kind: "capability", provides: ["./shipping"], dependsOn: [] },
+            emits: [], handles: [], schedules: [], env: [], requiredPorts: Object.keys(input.shipping),
+            routes: input.routes.map(route => route.id), requiredSchema: input.requiredSchema,
+        },
+        handlers: [], schedules: [], routes: input.routes,
+    };
+    return {
+        contributions: [contribution],
+        ports: Object.fromEntries(Object.entries(input.shipping).filter(([, fn]) => typeof fn === "function").map(([name, fn]) => [`@openlup/platform/shipping:${name}`, fn])),
+        routes: Object.fromEntries(input.routes.map(route => [`@openlup/platform/shipping:${route.id}`, route.handle])),
+    };
+}

package/dist/inventory/bindings.d.ts

@@ -0,0 +1,35 @@
+import type { z } from "zod";
+import type { InventoryMutationPort, InventoryReadPort } from "./ports.js";
+import type { NewPurchaseStockReadPort } from "./newPurchaseStockAvailability.js";
+export interface InventoryBindingDependencies {
+    dataKind: string;
+    provider: {
+        stockMasterProvider: string;
+        providerSchema: z.ZodType<string>;
+    };
+    executor?: {
+        query(text: string, values?: unknown[]): Promise<{
+            rows: Record<string, unknown>[];
+        }>;
+    } | null;
+    createManagedStore?: (provider: InventoryBindingDependencies["provider"]) => {
+        readPort: InventoryReadPort;
+        mutationPort: InventoryMutationPort;
+    } | null;
+    newPurchaseStockReadPort?: NewPurchaseStockReadPort | null;
+    now?: () => string;
+}
+export interface InventoryBindings {
+    readPort: InventoryReadPort | null;
+    mutationPort: InventoryMutationPort | null;
+    newPurchaseStockReadPort: NewPurchaseStockReadPort | null;
+    readiness: {
+        ready: boolean;
+        reason: string | null;
+    };
+    unsupported: {
+        newPurchaseStockRead: string | null;
+    };
+}
+/** Select one store only. Factories declare bindings, never discover or activate a host. */
+export declare function createInventoryBindings(deps: InventoryBindingDependencies): InventoryBindings;

package/dist/inventory/bindings.js

@@ -0,0 +1,45 @@
+import { createPostgresAdminInventoryPort } from "./adminInventory.js";
+import { createInventorySubscriptionForecastResponseSchema } from "./schemas.js";
+/** Select one store only. Factories declare bindings, never discover or activate a host. */
+export function createInventoryBindings(deps) {
+    const refused = (reason) => ({
+        readPort: null, mutationPort: null, newPurchaseStockReadPort: null,
+        readiness: { ready: false, reason }, unsupported: { newPurchaseStockRead: reason },
+    });
+    if (!deps.provider?.providerSchema?.safeParse(deps.provider.stockMasterProvider).success)
+        return refused("inventory_provider_mismatch");
+    let readPort, mutationPort;
+    if (deps.dataKind === "postgres") {
+        if (!deps.executor || typeof deps.executor.query !== "function")
+            return refused("inventory_executor_required");
+        readPort = mutationPort = createPostgresAdminInventoryPort(deps.executor, deps.provider, deps.now);
+    }
+    else if (deps.dataKind === "supabase") {
+        const store = deps.createManagedStore?.(deps.provider);
+        if (!store)
+            return refused("inventory_managed_store_required");
+        ({ readPort, mutationPort } = store);
+    }
+    else
+        return refused("inventory_store_incompatible");
+    if (![readPort?.listStock, readPort?.listReservations, readPort?.checkAtp, readPort?.forecastSubscriptions, mutationPort?.adjustStock].every(fn => typeof fn === "function"))
+        return refused("inventory_store_incompatible");
+    const responseSchema = createInventorySubscriptionForecastResponseSchema(deps.provider.providerSchema);
+    const native = deps.dataKind === "postgres";
+    const stockRead = native ? null : deps.newPurchaseStockReadPort;
+    const newPurchaseStockReadPort = typeof stockRead?.read === "function" ? stockRead : null;
+    return {
+        readPort: {
+            listStock: request => readPort.listStock(request),
+            listReservations: request => readPort.listReservations(request),
+            checkAtp: request => readPort.checkAtp(request),
+            forecastSubscriptions: async (request) => responseSchema.parse(await readPort.forecastSubscriptions(request)),
+        },
+        mutationPort, newPurchaseStockReadPort,
+        readiness: { ready: true, reason: null },
+        unsupported: {
+            newPurchaseStockRead: native ? "inventory_native_new_purchase_stock_read_unsupported"
+                : newPurchaseStockReadPort ? null : "inventory_new_purchase_stock_reader_required",
+        },
+    };
+}

package/dist/inventory/index.d.ts

@@ -11,3 +11,4 @@ export { createPostgresRenewalReservationPort, type AutomaticRenewalInventoryPor
 export { forecastSubscriptionInventoryShortages, buildSubscriptionInventoryForecast } from "./forecast.js";
 export { calculateSubscriptionForecastSkus, calculateSubscriptionForecastTotals } from "./subscriptionForecastCalculation.js";
 export { INVENTORY_MIGRATIONS } from "./sql.js";
+export { createInventoryBindings, type InventoryBindingDependencies, type InventoryBindings } from "./bindings.js";

package/dist/inventory/index.js

@@ -8,3 +8,4 @@ export { createPostgresRenewalReservationPort } from "./renewalReservation.js";
 export { forecastSubscriptionInventoryShortages, buildSubscriptionInventoryForecast } from "./forecast.js";
 export { calculateSubscriptionForecastSkus, calculateSubscriptionForecastTotals } from "./subscriptionForecastCalculation.js";
 export { INVENTORY_MIGRATIONS } from "./sql.js";
+export { createInventoryBindings } from "./bindings.js";

package/dist/pricing/commercePriceAuthority.d.ts

@@ -22,5 +22,7 @@ export interface CommercePriceAuthorityReadPort {
 }
 /** Provider-neutral strict money algorithm; adapters own only persistence reads and row mapping. */
 export declare function createCommercePriceAuthorityPort(reads: CommercePriceAuthorityReadPort): CommercePriceAuthorityPort;
+/** Opt-in scheduling using the selected list for concurrent history reads. */
+export declare function createConcurrentCommercePriceAuthorityPort(reads: CommercePriceAuthorityReadPort): CommercePriceAuthorityPort;
 /** The current money context requires one list; creation order cannot resolve overlap. */
 export declare function selectUniqueEffectivePriceList(priceLists: readonly TimedAuthorityValue<string>[], atTime: string): string;

package/dist/pricing/commercePriceAuthority.js

@@ -60,6 +60,67 @@ export function createCommercePriceAuthorityPort(reads) {
         },
     };
 }
+/** Opt-in scheduling using the selected list for concurrent history reads. */
+export function createConcurrentCommercePriceAuthorityPort(reads) {
+    return {
+        async resolvePrice(query) {
+            const atTime = query.atTime ?? new Date().toISOString();
+            const priceListId = selectUniqueEffectivePriceList(await reads.listPriceLists(query), atTime);
+            // Schedule history alongside base reads, retaining base-refusal precedence.
+            const policyHistoryRead = query.mode === "subscription" ? Promise.resolve().then(() => reads.listSubscriptionPolicyHistory({ priceListId, regionCode: query.regionCode,
+                currency: query.currency, channel: query.channel })).then((value) => ({ value }), (error) => ({ error })) : null;
+            const baseCandidates = effective(await reads.listExactBaseEntries({
+                variantId: query.variantId,
+                priceListId,
+            }), atTime);
+            if (baseCandidates.length === 0)
+                throw new CommercePriceAuthorityError("base_price_not_found");
+            if (baseCandidates.length !== 1)
+                throw new CommercePriceAuthorityError("base_price_ambiguous");
+            if (baseCandidates[0].value.amountKind !== "gross") {
+                throw new CommercePriceAuthorityError("base_price_amount_kind_invalid");
+            }
+            const base = { ...baseCandidates[0].value, resolvedAt: atTime };
+            if (query.mode === "one_time")
+                return { kind: "one_time", base, unitPriceMinor: base.unitPriceMinor };
+            const policyRead = await policyHistoryRead;
+            if ("error" in policyRead)
+                throw policyRead.error;
+            const policyHistory = policyRead.value;
+            if (policyHistory.length === 0) {
+                const legacyCandidates = effective(await reads.listExactLegacySubscriptionEntries({
+                    variantId: query.variantId,
+                    priceListId: base.priceListId,
+                }), atTime);
+                if (legacyCandidates.length === 0)
+                    throw new CommercePriceAuthorityError("legacy_subscription_price_not_found");
+                if (legacyCandidates.length !== 1)
+                    throw new CommercePriceAuthorityError("legacy_subscription_price_ambiguous");
+                const legacyResolved = { ...legacyCandidates[0].value, resolvedAt: atTime };
+                return { kind: "subscription_legacy", base, unitPriceMinor: legacyResolved.unitPriceMinor, legacyResolved };
+            }
+            const effectivePolicies = effective(policyHistory, atTime);
+            if (effectivePolicies.length === 0)
+                throw new CommercePriceAuthorityError("subscription_price_policy_not_effective");
+            if (effectivePolicies.length !== 1)
+                throw new CommercePriceAuthorityError("subscription_price_policy_ambiguous");
+            try {
+                const policy = await assertSubscriptionPricePolicyDigest(effectivePolicies[0].value);
+                return {
+                    kind: "subscription_policy",
+                    base,
+                    unitPriceMinor: deriveSubscriptionUnitPrice(base.unitPriceMinor, policy),
+                    policy,
+                };
+            }
+            catch (error) {
+                throw new CommercePriceAuthorityError(error instanceof SubscriptionPricePolicyDigestError
+                    ? "subscription_price_policy_digest_mismatch"
+                    : "subscription_price_policy_invalid");
+            }
+        },
+    };
+}
 /** The current money context requires one list; creation order cannot resolve overlap. */
 export function selectUniqueEffectivePriceList(priceLists, atTime) {
     const candidates = effective(priceLists, atTime);

package/dist/pricing/commerceQuoteHandler.d.ts

@@ -1,3 +1,4 @@
+import type { ShippingTerms } from "../shipping/index.js";
 import type { ResolvedAcquisitionTerms } from "./contracts/acquisitionTerms.js";
 import type { HttpRequest, HttpResponse } from "../http/index.js";
 import type { BffResponder } from "../bff/index.js";
@@ -7,6 +8,9 @@ import { type CommerceQuotePort } from "./quotePorts.js";
 import type { PricingPolicySnapshot } from "./contracts/offerPolicy.js";
 export interface CommerceQuoteHandlerDeps<Request extends CreateQuoteRequest = CreateQuoteRequest, Response extends CreateQuoteResponse = CreateQuoteResponse> {
     responder: BffResponder;
+    shipping?: {
+        terms(quote: Response["quote"]): ShippingTerms | undefined;
+    };
     acquisition?: {
         terms(quote: Response["quote"]): ResolvedAcquisitionTerms | undefined;
     };
@@ -25,7 +29,7 @@ export interface CommerceQuoteHandlerDeps<Request extends CreateQuoteRequest = C
         source: "anonymous" | "resolved_client";
     }>;
     resolvePricingPolicy?: (request: Request) => PricingPolicySnapshot | undefined | Promise<PricingPolicySnapshot | undefined>;
-    createPromotionAcceptance?: (request: Request, quote: Awaited<ReturnType<CommerceQuotePort<Request, Response>["createQuote"]>>["quote"], acquisitionTerms?: ResolvedAcquisitionTerms) => string | null;
-    honorPromotionAcceptance?: (token: string, request: Request, quote: Awaited<ReturnType<CommerceQuotePort<Request, Response>["createQuote"]>>["quote"], acquisitionTerms?: ResolvedAcquisitionTerms) => boolean;
+    createPromotionAcceptance?: (request: Request, quote: Awaited<ReturnType<CommerceQuotePort<Request, Response>["createQuote"]>>["quote"], acquisitionTerms?: ResolvedAcquisitionTerms, shippingTerms?: ShippingTerms) => string | null;
+    honorPromotionAcceptance?: (token: string, request: Request, quote: Awaited<ReturnType<CommerceQuotePort<Request, Response>["createQuote"]>>["quote"], acquisitionTerms?: ResolvedAcquisitionTerms, shippingTerms?: ShippingTerms) => boolean;
 }
-export declare function createCommerceQuoteHandler<Request extends CreateQuoteRequest, Response extends CreateQuoteResponse>({ responder, createQuoteRequestSchema, createQuoteResponseSchema, publicCreateQuoteRequestSchema, publicCreateQuoteResponseSchema, quotePort, acquisition, fallbackQuotePort, resolveCustomerEligibility, resolvePricingPolicy, createPromotionAcceptance, honorPromotionAcceptance, }: CommerceQuoteHandlerDeps<Request, Response>): (req: HttpRequest, res: HttpResponse) => Promise<void>;
+export declare function createCommerceQuoteHandler<Request extends CreateQuoteRequest, Response extends CreateQuoteResponse>({ responder, createQuoteRequestSchema, createQuoteResponseSchema, publicCreateQuoteRequestSchema, publicCreateQuoteResponseSchema, quotePort, acquisition, shipping, fallbackQuotePort, resolveCustomerEligibility, resolvePricingPolicy, createPromotionAcceptance, honorPromotionAcceptance, }: CommerceQuoteHandlerDeps<Request, Response>): (req: HttpRequest, res: HttpResponse) => Promise<void>;

package/dist/pricing/commerceQuoteHandler.js

@@ -6,7 +6,7 @@ import { CommerceQuoteCatalogReadError } from "./commerceQuoteCatalogReadPort.js
 function commerceQuoteFailureDetails(stage) {
     return { reason: "quote_dependency_failed", stage };
 }
-export function createCommerceQuoteHandler({ responder, createQuoteRequestSchema, createQuoteResponseSchema, publicCreateQuoteRequestSchema, publicCreateQuoteResponseSchema, quotePort, acquisition, fallbackQuotePort, resolveCustomerEligibility, resolvePricingPolicy, createPromotionAcceptance, honorPromotionAcceptance, }) {
+export function createCommerceQuoteHandler({ responder, createQuoteRequestSchema, createQuoteResponseSchema, publicCreateQuoteRequestSchema, publicCreateQuoteResponseSchema, quotePort, acquisition, shipping, fallbackQuotePort, resolveCustomerEligibility, resolvePricingPolicy, createPromotionAcceptance, honorPromotionAcceptance, }) {
     const { sendBffError, sendBffSuccess, sendMethodNotAllowed } = responder;
     return async function handler(req, res) {
         if (req.method !== "POST") {
@@ -47,9 +47,21 @@ export function createCommerceQuoteHandler({ responder, createQuoteRequestSchema
             let quote = canonicalQuote.data;
             stage = "promotion_acceptance";
             const acquisitionTerms = acquisition?.terms(quote.quote);
-            const honoredToken = promotionAcceptanceToken && honorPromotionAcceptance?.(promotionAcceptanceToken, request.data, quote.quote, acquisitionTerms) ? promotionAcceptanceToken : undefined;
-            const issuedToken = honoredToken ?? createPromotionAcceptance?.(request.data, quote.quote, acquisitionTerms) ?? undefined;
+            const shippingTerms = shipping?.terms(quote.quote);
+            const honoredToken = promotionAcceptanceToken && (shipping
+                ? honorPromotionAcceptance?.(promotionAcceptanceToken, request.data, quote.quote, acquisitionTerms, shippingTerms)
+                : honorPromotionAcceptance?.(promotionAcceptanceToken, request.data, quote.quote, acquisitionTerms))
+                ? promotionAcceptanceToken : undefined;
+            const issuedToken = honoredToken ?? (shipping
+                ? createPromotionAcceptance?.(request.data, quote.quote, acquisitionTerms, shippingTerms)
+                : createPromotionAcceptance?.(request.data, quote.quote, acquisitionTerms)) ?? undefined;
             const containsV2Promotion = quote.quote.discounts.some((discount) => discount.promotionEngineVersion === "promotion-engine.v2");
+            if (shippingTerms && !issuedToken) {
+                sendBffError(res, "CONFLICT", "Shipping quote must be refreshed", {
+                    details: { feature: "quote", reason: "promotion_acceptance_refresh_required" },
+                });
+                return;
+            }
             if ((containsV2Promotion || acquisitionTerms) && !issuedToken) {
                 stage = "promotion_fallback";
                 const fallback = fallbackQuotePort
@@ -58,7 +70,7 @@ export function createCommerceQuoteHandler({ responder, createQuoteRequestSchema
                         ...(pricingPolicy ? { pricingPolicy } : {}),
                     }))
                     : null;
-                if (!fallback?.success || acquisition?.terms(fallback.data.quote) || fallback.data.quote.discounts.some((discount) => discount.promotionEngineVersion === "promotion-engine.v2")) {
+                if (!fallback?.success || shipping?.terms(fallback.data.quote) || acquisition?.terms(fallback.data.quote) || fallback.data.quote.discounts.some((discount) => discount.promotionEngineVersion === "promotion-engine.v2")) {
                     sendBffError(res, "CONFLICT", "Promotion quote must be refreshed", {
                         details: { feature: "quote", reason: "promotion_acceptance_refresh_required" },
                     });

package/dist/pricing/dbBackedCommerceQuotePort.d.ts

@@ -1,3 +1,6 @@
+import type { ShippingTerms } from "../shipping/index.js";
+import type { ResolvedAcquisitionTerms } from "./contracts/acquisitionTerms.js";
+import type { QuoteShippingPromotionInput, QuoteShippingPromotionResult } from "./quoteShippingPromotions.js";
 import type { PricingResolverPort } from "@openlup/core/pricing";
 import type { CreateQuoteResponse, PricingPolicySnapshot, CreateQuoteRequest, CommerceQuoteContext, CommerceQuoteLine, CommerceTaxProfile, CommerceQuoteDiscount, CommerceCodeRejection, CommerceCodeRejectionDetail, CartLineInput } from "./contracts/index.js";
 import { type CreateQuoteOptions } from "./quotePorts.js";
@@ -21,6 +24,7 @@ export interface DbBackedCommerceQuotePortDeps<Request extends CreateQuoteReques
     currency: string;
     now?: () => string;
     shippingFlatMinor?: () => Promise<number>;
+    resolveQuoteShippingPromotions?: (input: QuoteShippingPromotionInput<Request>) => Promise<QuoteShippingPromotionResult>;
     hasPromotionCodePort: boolean;
     lineContext(line: CartLineInput, item: Item): LineContext;
     quoteContext(request: Request, lines: Array<LineContext & {
@@ -53,6 +57,8 @@ export declare function createDbBackedCommerceQuotePort<Request extends CreateQu
         quote: Omit<CreateQuoteResponse["quote"], "context"> & {
             context: Context & {
                 pricingPolicy?: PricingPolicySnapshot;
+                shippingTerms?: ShippingTerms;
+                acquisitionTerms?: ResolvedAcquisitionTerms;
             };
         };
     }>;
@@ -60,6 +66,8 @@ export declare function createDbBackedCommerceQuotePort<Request extends CreateQu
         quote: Omit<CreateQuoteResponse["quote"], "context"> & {
             context: Context & {
                 pricingPolicy?: PricingPolicySnapshot;
+                shippingTerms?: ShippingTerms;
+                acquisitionTerms?: ResolvedAcquisitionTerms;
             };
         };
     }>;

package/dist/pricing/dbBackedCommerceQuotePort.js

@@ -7,7 +7,7 @@ import { assertSupportedCommerceTaxProfile } from "./taxProfileGuard.js";
 import { catalogFactsForQuoteLine, projectPublicQuoteSnapshot } from "./catalogFactsProvenance.js";
 const STRICT_D1_COMMERCE_CHANNEL = "D2C";
 export function createDbBackedCommerceQuotePort(deps) {
-    const { taxProfile, supportedTaxProfiles, regionCode, currency, now = () => new Date().toISOString(), quoteCatalogReadPort, isStrictD1Quote, pricingResolverPort, commercePriceAuthorityPort, shippingFlatMinor, resolveAutomaticQuotePromotions, applyPromotionCodesV2, hasPromotionCodePort, lineContext, quoteContext, } = deps;
+    const { taxProfile, supportedTaxProfiles, regionCode, currency, now = () => new Date().toISOString(), quoteCatalogReadPort, isStrictD1Quote, pricingResolverPort, commercePriceAuthorityPort, shippingFlatMinor, resolveAutomaticQuotePromotions, applyPromotionCodesV2, hasPromotionCodePort, lineContext, quoteContext, resolveQuoteShippingPromotions, } = deps;
     assertSupportedCommerceTaxProfile(taxProfile, supportedTaxProfiles);
     const money = moneyIn(currency);
     async function createServerAuthoritativeQuote(request, options) {
@@ -129,33 +129,49 @@ export function createDbBackedCommerceQuotePort(deps) {
         const referenceProductMinor = sum(pricedLines.map((entry) => entry.referenceGrossMinor));
         const netTotalMinor = sum(lines.map((line) => line.tax.netAmount.amountMinor));
         const taxTotalMinor = sum(lines.map((line) => line.tax.vatAmount.amountMinor));
-        // Shipping is a flat per-order gross from settings; absent settings port ⇒ no
-        // shipping (byte-identical to pre-shipping quotes). Resolved before promo eval so
-        // the free-shipping lane has a real amount to zero.
-        const shippingGrossMinor = shippingFlatMinor
-            ? await shippingFlatMinor()
-            : 0;
-        const automaticPromotionResult = await resolveAutomaticQuotePromotions({
-            request,
-            options,
-            regionCode,
-            referenceProductMinor,
-            subtotalGrossMinor,
-            shippingGrossMinor,
-            atTime,
-        });
-        const promotionResult = await applyPromotionCodesV2({
-            preserveLegacyDiscountsWhenNoCandidates: options?.pricingPolicy?.promotionEngineVersion !== PROMOTION_ENGINE_V2,
-            clientId: options?.clientId ?? null,
-            mode: request.mode,
-            promoCodes: request.promoCodes,
-            referenceProductMinor: sum(pricedLines.map((entry) => entry.referenceGrossMinor)),
-            subtotalGrossMinor,
-            shippingGrossMinor,
-            discounts: automaticPromotionResult.discounts,
-            codeRejections: automaticPromotionResult.codeRejections,
-            atTime,
-        });
+        let shippingGrossMinor;
+        let promotionResult;
+        let hasShipping;
+        let shippingTerms;
+        let acquisitionTerms;
+        if (resolveQuoteShippingPromotions) {
+            const resolved = await resolveQuoteShippingPromotions({ request, options, regionCode, currency, referenceProductMinor, subtotalGrossMinor, atTime });
+            shippingGrossMinor = resolved.shippingGrossMinor;
+            promotionResult = resolved;
+            hasShipping = resolved.hasShipping;
+            shippingTerms = resolved.shippingTerms;
+            acquisitionTerms = resolved.acquisitionTerms;
+        }
+        else {
+            // Shipping is a flat per-order gross from settings; absent settings port ⇒ no
+            // shipping (byte-identical to pre-shipping quotes). Resolved before promo eval so
+            // the free-shipping lane has a real amount to zero.
+            shippingGrossMinor = shippingFlatMinor
+                ? await shippingFlatMinor()
+                : 0;
+            const automaticPromotionResult = await resolveAutomaticQuotePromotions({
+                request,
+                options,
+                regionCode,
+                referenceProductMinor,
+                subtotalGrossMinor,
+                shippingGrossMinor,
+                atTime,
+            });
+            promotionResult = await applyPromotionCodesV2({
+                preserveLegacyDiscountsWhenNoCandidates: options?.pricingPolicy?.promotionEngineVersion !== PROMOTION_ENGINE_V2,
+                clientId: options?.clientId ?? null,
+                mode: request.mode,
+                promoCodes: request.promoCodes,
+                referenceProductMinor: sum(pricedLines.map((entry) => entry.referenceGrossMinor)),
+                subtotalGrossMinor,
+                shippingGrossMinor,
+                discounts: automaticPromotionResult.discounts,
+                codeRejections: automaticPromotionResult.codeRejections,
+                atTime,
+            });
+            hasShipping = shippingFlatMinor != null;
+        }
         const { discounts, codeRejections, codeRejectionDetails } = promotionResult;
         // Two lanes: order_total/line discounts reduce the subtotal; a shipping discount
         // (free-shipping promo) reduces the shipping gross. They are summed and validated
@@ -169,7 +185,6 @@ export function createDbBackedCommerceQuotePort(deps) {
         const { netMinor: discountNetMinor, vatMinor: discountVatMinor } = splitIncludedVat(orderDiscountMinor, taxProfile.vatRateBps);
         const ship = splitIncludedVat(shippingGrossMinor, taxProfile.vatRateBps);
         const shipDiscount = splitIncludedVat(shippingDiscountMinor, taxProfile.vatRateBps);
-        const hasShipping = shippingFlatMinor != null;
         const shippingFields = hasShipping
             ? {
                 shippingGross: money(shippingGrossMinor),
@@ -188,6 +203,8 @@ export function createDbBackedCommerceQuotePort(deps) {
                 pricingComponents: quoteComponents,
                 context: {
                     ...context(),
+                    ...(resolveQuoteShippingPromotions && acquisitionTerms ? { acquisitionTerms } : {}),
+                    ...(resolveQuoteShippingPromotions && shippingTerms ? { shippingTerms } : {}),
                     ...(options?.pricingPolicy ? { pricingPolicy: options.pricingPolicy } : {}),
                 },
                 subtotalGross: money(subtotalGrossMinor),

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 {};