@openlup/platform 0.16.0 → 0.18.0

package/dist/pricing/dbBackedCommerceQuoteSnapshotVerifier.js

@@ -0,0 +1,25 @@
+import { isDeepStrictEqual } from "node:util";
+import { CommerceQuoteSnapshotError, } from "./quotePorts.js";
+import { projectPublicQuoteSnapshot } from "./catalogFactsProvenance.js";
+import { createExpectedQuote } from "./commerceQuoteSnapshotExpect.js";
+export function createDbBackedCommerceQuoteSnapshotVerifier(quotePort, quoteRequestFromSnapshot, createQuoteResponseSchema) {
+    async function verifyAndEnrich(snapshot) {
+        const publicSnapshot = projectPublicQuoteSnapshot(snapshot);
+        const expected = await createExpectedQuote(quotePort.createServerAuthoritativeQuote
+            ? { createQuote: quotePort.createServerAuthoritativeQuote.bind(quotePort) }
+            : quotePort, quoteRequestFromSnapshot(publicSnapshot), {
+            invalidResponseMessage: "Commerce DB-backed quote verifier returned invalid response",
+            catalogMismatchMessage: "Commerce quote snapshot does not match current DB-backed catalog pricing",
+        }, createQuoteResponseSchema);
+        if (!isDeepStrictEqual(publicSnapshot, projectPublicQuoteSnapshot(expected))) {
+            throw new CommerceQuoteSnapshotError("QUOTE_SNAPSHOT_MISMATCH", "Commerce quote snapshot does not match current DB-backed catalog pricing", {
+                reason: "snapshot_does_not_match_db_backed_quote",
+                skus: publicSnapshot.quote.lines.map((line) => line.sku),
+            });
+        }
+        return expected;
+    }
+    return {
+        verifyQuoteSnapshot: verifyAndEnrich,
+    };
+}

package/dist/pricing/index.d.ts

@@ -0,0 +1,51 @@
+export * from "./contracts/index.js";
+export { CommercePriceAuthorityError } from "./ports.js";
+export type { CommercePriceAuthorityPort } from "./ports.js";
+export { createCommercePriceAuthorityPort, 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";
+export { createPricingPolicyToken, verifyPricingPolicyToken, resolvePricingPolicy } from "./pricingPolicyToken.js";
+export type { PricingPolicyTokenPayload } from "./pricingPolicyToken.js";
+export { CommercePricingPolicyUnavailableError, PRICING_POLICY_REQUEST_REASONS, CommercePricingPolicyRequestError, mapPricingPolicyFailure } from "./commercePricingPolicyErrors.js";
+export type { PricingPolicyRequestReason, SafePricingPolicyReason, PricingPolicyFailureMapping } from "./commercePricingPolicyErrors.js";
+export { CommerceQuoteError, CommerceQuoteSnapshotError } from "./quotePorts.js";
+export type { CreateQuoteOptions, CommerceQuotePort, CommerceQuoteSnapshotVerifierPort, CommerceQuoteErrorCode, CommerceQuoteSnapshotErrorCode } from "./quotePorts.js";
+export { createCommerceQuotePrimitives } from "./quotePrimitives.js";
+export { createCommerceQuoteSchemas, splitIncludedVat, quoteMoneyCurrenciesMatch } from "./quoteSchemas.js";
+export { quoteDiscountSchema, hasValidV2PromotionEvidence } from "./quotePromotionEvidence.js";
+export { quoteCodeRejectionDetailSchema } from "./quoteCodeRejectionDetails.js";
+export { catalogFactsProvenanceSchema, rejectCatalogFactsFromPublicQuote } from "./catalogFactsSchemas.js";
+export { createCatalogFactsProvenance, catalogFactsForQuoteLine, projectPublicQuoteSnapshot } from "./catalogFactsProvenance.js";
+export { CommerceQuoteCatalogReadError } from "./commerceQuoteCatalogReadPort.js";
+export type { CommerceQuoteCatalogItem, CommerceQuoteCatalogReadPort, CommerceQuoteCatalogReadRefusalCode } from "./commerceQuoteCatalogReadPort.js";
+export { assertSupportedCommerceTaxProfile } from "./taxProfileGuard.js";
+export { buildSkuIndex, eligibleQtyForMode, resolveOneTimeComparison, resolveStrictQuotePrice, assertSubscriptionCheapest, toGrossMinor, calculateIncludedVat, mapPricingComponent, moneyIn, sum } from "./dbBackedCommerceQuoteHelpers.js";
+export type { SkuIndexEntry, StrictQuotePriceResolution } from "./dbBackedCommerceQuoteHelpers.js";
+export { createDbBackedCommerceQuotePort } from "./dbBackedCommerceQuotePort.js";
+export type { DbBackedCommerceQuotePortDeps, QuotePromotionResult } from "./dbBackedCommerceQuotePort.js";
+export { createExpectedQuote } from "./commerceQuoteSnapshotExpect.js";
+export type { QuoteSnapshotExpectMessages } from "./commerceQuoteSnapshotExpect.js";
+export { createDbBackedCommerceQuoteSnapshotVerifier } from "./dbBackedCommerceQuoteSnapshotVerifier.js";
+export { createCommerceQuoteHandler } from "./commerceQuoteHandler.js";
+export type { CommerceQuoteHandlerDeps } from "./commerceQuoteHandler.js";
+export { createCommerceQuoteBatchHandler } from "./commerceQuoteBatchHandler.js";
+export type { CommerceQuoteBatchHandlerDeps } from "./commerceQuoteBatchHandler.js";
+export { createCommerceOfferPricingSchemas } from "./offerPricingSchemas.js";
+export { projectCommerceOfferPricing } from "./commerceOfferPricing.js";
+export type { CommerceOfferPricingDeps } from "./commerceOfferPricing.js";
+export { createCommerceOfferPricingHandler, COMMERCE_OFFER_PRICING_CACHE_CONTROL, COMMERCE_OFFER_PRICING_ASSIGNED_CACHE_CONTROL, OFFER_POLICY_CAPABILITY_HEADER, OFFER_POLICY_TOKEN_HEADER, OFFER_POLICY_VISITOR_HEADER } from "./commerceOfferPricingHandler.js";
+export type { CommerceOfferPricingHandlerDeps } from "./commerceOfferPricingHandler.js";
+export { createCommerceOfferPricingCache } from "./commerceOfferPricingCache.js";
+export type { CommerceOfferPricingCache } from "./commerceOfferPricingCache.js";
+export { OFFER_POLICY_V2_READINESS_CONTRACT, createOfferPolicyReadinessCache, readOfferPolicyV2Readiness, resetOfferPolicyReadinessCacheForTests } from "./offerPolicyReadiness.js";
+export type { OfferPolicyV2Readiness, OfferPolicyReadinessPort, OfferPolicyReadinessCache } from "./offerPolicyReadiness.js";
+export * from "./acquisitionFinancialPolicy.js";
+export * from "./acquisitionTermsSchemas.js";
+export * from "./acquisitionTerms.js";
+export * from "./quoteAcquisitionTerms.js";
+export * from "./acquisitionQuoteBinding.js";
+export * from "./acquisitionOfferPricingSchemas.js";
+export * from "./acquisitionOfferPricing.js";
+export * from "./acquisitionOfferPricingHandler.js";
+export * from "./acquisitionReadiness.js";

package/dist/pricing/index.js

@@ -0,0 +1,36 @@
+export * from "./contracts/index.js";
+export { CommercePriceAuthorityError } from "./ports.js";
+export { createCommercePriceAuthorityPort, 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";
+export { CommercePricingPolicyUnavailableError, PRICING_POLICY_REQUEST_REASONS, CommercePricingPolicyRequestError, mapPricingPolicyFailure } from "./commercePricingPolicyErrors.js";
+export { CommerceQuoteError, CommerceQuoteSnapshotError } from "./quotePorts.js";
+export { createCommerceQuotePrimitives } from "./quotePrimitives.js";
+export { createCommerceQuoteSchemas, splitIncludedVat, quoteMoneyCurrenciesMatch } from "./quoteSchemas.js";
+export { quoteDiscountSchema, hasValidV2PromotionEvidence } from "./quotePromotionEvidence.js";
+export { quoteCodeRejectionDetailSchema } from "./quoteCodeRejectionDetails.js";
+export { catalogFactsProvenanceSchema, rejectCatalogFactsFromPublicQuote } from "./catalogFactsSchemas.js";
+export { createCatalogFactsProvenance, catalogFactsForQuoteLine, projectPublicQuoteSnapshot } from "./catalogFactsProvenance.js";
+export { CommerceQuoteCatalogReadError } from "./commerceQuoteCatalogReadPort.js";
+export { assertSupportedCommerceTaxProfile } from "./taxProfileGuard.js";
+export { buildSkuIndex, eligibleQtyForMode, resolveOneTimeComparison, resolveStrictQuotePrice, assertSubscriptionCheapest, toGrossMinor, calculateIncludedVat, mapPricingComponent, moneyIn, sum } from "./dbBackedCommerceQuoteHelpers.js";
+export { createDbBackedCommerceQuotePort } from "./dbBackedCommerceQuotePort.js";
+export { createExpectedQuote } from "./commerceQuoteSnapshotExpect.js";
+export { createDbBackedCommerceQuoteSnapshotVerifier } from "./dbBackedCommerceQuoteSnapshotVerifier.js";
+export { createCommerceQuoteHandler } from "./commerceQuoteHandler.js";
+export { createCommerceQuoteBatchHandler } from "./commerceQuoteBatchHandler.js";
+export { createCommerceOfferPricingSchemas } from "./offerPricingSchemas.js";
+export { projectCommerceOfferPricing } from "./commerceOfferPricing.js";
+export { createCommerceOfferPricingHandler, COMMERCE_OFFER_PRICING_CACHE_CONTROL, COMMERCE_OFFER_PRICING_ASSIGNED_CACHE_CONTROL, OFFER_POLICY_CAPABILITY_HEADER, OFFER_POLICY_TOKEN_HEADER, OFFER_POLICY_VISITOR_HEADER } from "./commerceOfferPricingHandler.js";
+export { createCommerceOfferPricingCache } from "./commerceOfferPricingCache.js";
+export { OFFER_POLICY_V2_READINESS_CONTRACT, createOfferPolicyReadinessCache, readOfferPolicyV2Readiness, resetOfferPolicyReadinessCacheForTests } from "./offerPolicyReadiness.js";
+export * from "./acquisitionFinancialPolicy.js";
+export * from "./acquisitionTermsSchemas.js";
+export * from "./acquisitionTerms.js";
+export * from "./quoteAcquisitionTerms.js";
+export * from "./acquisitionQuoteBinding.js";
+export * from "./acquisitionOfferPricingSchemas.js";
+export * from "./acquisitionOfferPricing.js";
+export * from "./acquisitionOfferPricingHandler.js";
+export * from "./acquisitionReadiness.js";

package/dist/pricing/offerPolicyReadiness.d.ts

@@ -0,0 +1,21 @@
+export declare const OFFER_POLICY_V2_READINESS_CONTRACT = "commerce-offer-policy-v2-readiness.v1";
+export interface OfferPolicyV2Readiness {
+    contractVersion: typeof OFFER_POLICY_V2_READINESS_CONTRACT;
+    ready: boolean;
+    checkedAt: string;
+    reasons: string[];
+}
+export interface OfferPolicyReadinessPort {
+    readOfferPolicyV2Readiness(): Promise<unknown>;
+}
+export interface OfferPolicyReadinessCache {
+    read(port: OfferPolicyReadinessPort): Promise<OfferPolicyV2Readiness>;
+    clear(): void;
+}
+export declare function createOfferPolicyReadinessCache(input?: {
+    now?: () => number;
+    positiveTtlMs?: number;
+    negativeTtlMs?: number;
+}): OfferPolicyReadinessCache;
+export declare function readOfferPolicyV2Readiness(port: OfferPolicyReadinessPort): Promise<OfferPolicyV2Readiness>;
+export declare function resetOfferPolicyReadinessCacheForTests(isTest: boolean): void;

package/dist/pricing/offerPolicyReadiness.js

@@ -0,0 +1,79 @@
+export const OFFER_POLICY_V2_READINESS_CONTRACT = "commerce-offer-policy-v2-readiness.v1";
+export function createOfferPolicyReadinessCache(input = {}) {
+    const now = input.now ?? Date.now;
+    const positiveTtlMs = Math.min(60_000, Math.max(0, input.positiveTtlMs ?? 60_000));
+    const negativeTtlMs = Math.min(5_000, Math.max(0, input.negativeTtlMs ?? 5_000));
+    let cached = null;
+    let inFlight = null;
+    return {
+        read(port) {
+            const current = now();
+            if (cached && cached.expiresAtMs > current)
+                return Promise.resolve(cached.readiness);
+            if (inFlight)
+                return inFlight;
+            const startedAtMs = current;
+            inFlight = loadFailClosed(port)
+                .then((readiness) => {
+                cached = {
+                    readiness,
+                    // Bound staleness from the start of the database read. A slow RPC
+                    // must consume the TTL, not extend a green decision past 60s.
+                    expiresAtMs: startedAtMs + (readiness.ready ? positiveTtlMs : negativeTtlMs),
+                };
+                return readiness;
+            })
+                .finally(() => {
+                inFlight = null;
+            });
+            return inFlight;
+        },
+        clear() {
+            cached = null;
+            inFlight = null;
+        },
+    };
+}
+const sharedCache = createOfferPolicyReadinessCache();
+export function readOfferPolicyV2Readiness(port) {
+    return sharedCache.read(port);
+}
+export function resetOfferPolicyReadinessCacheForTests(isTest) {
+    if (isTest)
+        sharedCache.clear();
+}
+async function loadFailClosed(port) {
+    try {
+        const parsed = parseReadiness(await port.readOfferPolicyV2Readiness());
+        return parsed ?? unavailable("readiness_contract_invalid");
+    }
+    catch {
+        return unavailable("readiness_rpc_unavailable");
+    }
+}
+function parseReadiness(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const record = value;
+    if (record.contractVersion !== OFFER_POLICY_V2_READINESS_CONTRACT ||
+        typeof record.ready !== "boolean" ||
+        typeof record.checkedAt !== "string" ||
+        !Number.isFinite(Date.parse(record.checkedAt)) ||
+        !Array.isArray(record.reasons) ||
+        !record.reasons.every((reason) => typeof reason === "string"))
+        return null;
+    return {
+        contractVersion: OFFER_POLICY_V2_READINESS_CONTRACT,
+        ready: record.ready,
+        checkedAt: record.checkedAt,
+        reasons: record.reasons,
+    };
+}
+function unavailable(reason) {
+    return {
+        contractVersion: OFFER_POLICY_V2_READINESS_CONTRACT,
+        ready: false,
+        checkedAt: new Date(0).toISOString(),
+        reasons: [reason],
+    };
+}

package/dist/pricing/offerPolicySchemas.d.ts

@@ -0,0 +1,25 @@
+import { z } from "./validation.js";
+export declare const offerPolicyVersionSchema: z.ZodEnum<{
+    "commerce.offer-policy.v1": "commerce.offer-policy.v1";
+    "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";
+}>;
+/** Client capability plus an opaque server-signed assignment. Never a version selector. */
+export declare const pricingPolicyRequestSchema: z.ZodObject<{
+    capability: z.ZodOptional<z.ZodLiteral<"commerce.offer-policy.v2">>;
+    token: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const pricingPolicySnapshotSchema: z.ZodObject<{
+    offerPolicyVersion: z.ZodEnum<{
+        "commerce.offer-policy.v1": "commerce.offer-policy.v1";
+        "commerce.offer-policy.v2": "commerce.offer-policy.v2";
+    }>;
+    promotionEngineVersion: z.ZodEnum<{
+        "promotion-engine.v2": "promotion-engine.v2";
+        "promotion-engine.v1": "promotion-engine.v1";
+    }>;
+    pricingPolicyToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;

package/dist/pricing/offerPolicySchemas.js

@@ -0,0 +1,15 @@
+import { z } from "./validation.js";
+import { OFFER_POLICY_V1, OFFER_POLICY_V2, PROMOTION_ENGINE_V1, PROMOTION_ENGINE_V2, OFFER_POLICY_V2_CAPABILITY } from "./contracts/index.js";
+export const offerPolicyVersionSchema = z.enum([OFFER_POLICY_V1, OFFER_POLICY_V2]);
+export const promotionEngineVersionSchema = z.enum([PROMOTION_ENGINE_V1, PROMOTION_ENGINE_V2]);
+/** Client capability plus an opaque server-signed assignment. Never a version selector. */
+export const pricingPolicyRequestSchema = z.object({
+    capability: z.literal(OFFER_POLICY_V2_CAPABILITY).optional(),
+    token: z.string().trim().min(32).max(2048).optional(),
+}).strict();
+export const pricingPolicySnapshotSchema = z.object({
+    offerPolicyVersion: offerPolicyVersionSchema,
+    promotionEngineVersion: promotionEngineVersionSchema,
+    pricingPolicyToken: z.string().trim().min(32).max(2048).optional(),
+}).strict().refine((value) => (value.offerPolicyVersion === OFFER_POLICY_V1 && value.promotionEngineVersion === PROMOTION_ENGINE_V1) ||
+    (value.offerPolicyVersion === OFFER_POLICY_V2 && value.promotionEngineVersion === PROMOTION_ENGINE_V2), { message: "offer policy and promotion engine versions must be paired" });

package/dist/pricing/offerPricingSchemas.d.ts

@@ -0,0 +1,315 @@
+import { z } from "zod";
+import type { CommerceMoney } from "./contracts/money.js";
+export declare function createCommerceOfferPricingSchemas<ScopeV1 extends string, ScopeV2 extends string>({ commerceMoneySchema, catalogProductSlugSchema, scopeV1Schema, scopeV2Schema, minimumProductPayableMinor, minimumProductPayableMessage, }: {
+    commerceMoneySchema: z.ZodType<CommerceMoney>;
+    catalogProductSlugSchema: z.ZodType<string>;
+    scopeV1Schema: z.ZodType<ScopeV1>;
+    scopeV2Schema: z.ZodType<ScopeV2>;
+    minimumProductPayableMinor: number;
+    minimumProductPayableMessage: string;
+}): {
+    commerceProductOfferPricingSchema: z.ZodObject<{
+        productSlug: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+        unitCount: z.ZodNumber;
+        oneTime: z.ZodObject<{
+            packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+        }, z.core.$strict>;
+        subscriptionInitial: z.ZodObject<{
+            packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+        }, z.core.$strict>;
+        subscriptionRecurring: z.ZodObject<{
+            packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+        }, z.core.$strict>;
+        catalogAnchorUnitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+        initialDiscountPercent: z.ZodNumber;
+        recurringDiscountPercent: z.ZodNumber;
+    }, z.core.$strict>;
+    commerceOfferPricingV1ResponseSchema: z.ZodObject<{
+        contractVersion: z.ZodLiteral<"commerce.offer-pricing.v1">;
+        scope: z.ZodType<ScopeV1, unknown, z.core.$ZodTypeInternals<ScopeV1, unknown>>;
+        products: z.ZodArray<z.ZodObject<{
+            productSlug: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+            unitCount: z.ZodNumber;
+            oneTime: z.ZodObject<{
+                packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            }, z.core.$strict>;
+            subscriptionInitial: z.ZodObject<{
+                packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            }, z.core.$strict>;
+            subscriptionRecurring: z.ZodObject<{
+                packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            }, z.core.$strict>;
+            catalogAnchorUnitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            initialDiscountPercent: z.ZodNumber;
+            recurringDiscountPercent: z.ZodNumber;
+        }, z.core.$strict>>;
+        minimum: z.ZodObject<{
+            oneTime: z.ZodObject<{
+                productSlug: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+                unitCount: z.ZodNumber;
+                oneTime: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionInitial: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionRecurring: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                catalogAnchorUnitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                initialDiscountPercent: z.ZodNumber;
+                recurringDiscountPercent: z.ZodNumber;
+            }, z.core.$strict>;
+            subscription: z.ZodObject<{
+                productSlug: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+                unitCount: z.ZodNumber;
+                oneTime: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionInitial: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionRecurring: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                catalogAnchorUnitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                initialDiscountPercent: z.ZodNumber;
+                recurringDiscountPercent: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    commerceOfferPricingV2ResponseSchema: z.ZodObject<{
+        contractVersion: z.ZodLiteral<"commerce.offer-pricing.v2">;
+        scope: z.ZodType<ScopeV2, unknown, z.core.$ZodTypeInternals<ScopeV2, unknown>>;
+        pricingPolicy: z.ZodObject<{
+            offerPolicyVersion: z.ZodEnum<{
+                "commerce.offer-policy.v1": "commerce.offer-policy.v1";
+                "commerce.offer-policy.v2": "commerce.offer-policy.v2";
+            }>;
+            promotionEngineVersion: z.ZodEnum<{
+                "promotion-engine.v2": "promotion-engine.v2";
+                "promotion-engine.v1": "promotion-engine.v1";
+            }>;
+            pricingPolicyToken: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        products: z.ZodArray<z.ZodObject<{
+            productSlug: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+            unitCount: z.ZodNumber;
+            oneTime: z.ZodObject<{
+                packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            }, z.core.$strict>;
+            subscriptionInitial: z.ZodObject<{
+                packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            }, z.core.$strict>;
+            subscriptionRecurring: z.ZodObject<{
+                packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            }, z.core.$strict>;
+            catalogAnchorUnitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            initialDiscountPercent: z.ZodNumber;
+            recurringDiscountPercent: z.ZodNumber;
+        }, z.core.$strict>>;
+        minimum: z.ZodObject<{
+            oneTime: z.ZodObject<{
+                productSlug: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+                unitCount: z.ZodNumber;
+                oneTime: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionInitial: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionRecurring: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                catalogAnchorUnitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                initialDiscountPercent: z.ZodNumber;
+                recurringDiscountPercent: z.ZodNumber;
+            }, z.core.$strict>;
+            subscription: z.ZodObject<{
+                productSlug: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+                unitCount: z.ZodNumber;
+                oneTime: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionInitial: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionRecurring: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                catalogAnchorUnitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                initialDiscountPercent: z.ZodNumber;
+                recurringDiscountPercent: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        shipping: z.ZodObject<{
+            gross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            discountGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            payable: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+        }, z.core.$strict>;
+        minimumProductPayable: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+    }, z.core.$strict>;
+    commerceOfferPricingResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+        contractVersion: z.ZodLiteral<"commerce.offer-pricing.v1">;
+        scope: z.ZodType<ScopeV1, unknown, z.core.$ZodTypeInternals<ScopeV1, unknown>>;
+        products: z.ZodArray<z.ZodObject<{
+            productSlug: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+            unitCount: z.ZodNumber;
+            oneTime: z.ZodObject<{
+                packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            }, z.core.$strict>;
+            subscriptionInitial: z.ZodObject<{
+                packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            }, z.core.$strict>;
+            subscriptionRecurring: z.ZodObject<{
+                packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            }, z.core.$strict>;
+            catalogAnchorUnitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            initialDiscountPercent: z.ZodNumber;
+            recurringDiscountPercent: z.ZodNumber;
+        }, z.core.$strict>>;
+        minimum: z.ZodObject<{
+            oneTime: z.ZodObject<{
+                productSlug: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+                unitCount: z.ZodNumber;
+                oneTime: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionInitial: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionRecurring: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                catalogAnchorUnitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                initialDiscountPercent: z.ZodNumber;
+                recurringDiscountPercent: z.ZodNumber;
+            }, z.core.$strict>;
+            subscription: z.ZodObject<{
+                productSlug: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+                unitCount: z.ZodNumber;
+                oneTime: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionInitial: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionRecurring: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                catalogAnchorUnitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                initialDiscountPercent: z.ZodNumber;
+                recurringDiscountPercent: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        contractVersion: z.ZodLiteral<"commerce.offer-pricing.v2">;
+        scope: z.ZodType<ScopeV2, unknown, z.core.$ZodTypeInternals<ScopeV2, unknown>>;
+        pricingPolicy: z.ZodObject<{
+            offerPolicyVersion: z.ZodEnum<{
+                "commerce.offer-policy.v1": "commerce.offer-policy.v1";
+                "commerce.offer-policy.v2": "commerce.offer-policy.v2";
+            }>;
+            promotionEngineVersion: z.ZodEnum<{
+                "promotion-engine.v2": "promotion-engine.v2";
+                "promotion-engine.v1": "promotion-engine.v1";
+            }>;
+            pricingPolicyToken: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        products: z.ZodArray<z.ZodObject<{
+            productSlug: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+            unitCount: z.ZodNumber;
+            oneTime: z.ZodObject<{
+                packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            }, z.core.$strict>;
+            subscriptionInitial: z.ZodObject<{
+                packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            }, z.core.$strict>;
+            subscriptionRecurring: z.ZodObject<{
+                packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            }, z.core.$strict>;
+            catalogAnchorUnitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            initialDiscountPercent: z.ZodNumber;
+            recurringDiscountPercent: z.ZodNumber;
+        }, z.core.$strict>>;
+        minimum: z.ZodObject<{
+            oneTime: z.ZodObject<{
+                productSlug: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+                unitCount: z.ZodNumber;
+                oneTime: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionInitial: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionRecurring: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                catalogAnchorUnitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                initialDiscountPercent: z.ZodNumber;
+                recurringDiscountPercent: z.ZodNumber;
+            }, z.core.$strict>;
+            subscription: z.ZodObject<{
+                productSlug: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+                unitCount: z.ZodNumber;
+                oneTime: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionInitial: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                subscriptionRecurring: z.ZodObject<{
+                    packageGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                    unitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                }, z.core.$strict>;
+                catalogAnchorUnitGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+                initialDiscountPercent: z.ZodNumber;
+                recurringDiscountPercent: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        shipping: z.ZodObject<{
+            gross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            discountGross: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+            payable: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+        }, z.core.$strict>;
+        minimumProductPayable: z.ZodType<CommerceMoney, unknown, z.core.$ZodTypeInternals<CommerceMoney, unknown>>;
+    }, z.core.$strict>]>;
+};

package/dist/pricing/offerPricingSchemas.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+import { COMMERCE_OFFER_PRICING_CONTRACT_VERSION, COMMERCE_OFFER_PRICING_V2_CONTRACT_VERSION } from "./contracts/offer.js";
+import { pricingPolicySnapshotSchema } from "./offerPolicySchemas.js";
+export function createCommerceOfferPricingSchemas({ commerceMoneySchema, catalogProductSlugSchema, scopeV1Schema, scopeV2Schema, minimumProductPayableMinor, minimumProductPayableMessage, }) {
+    const offerPriceSchema = z
+        .object({
+        packageGross: commerceMoneySchema,
+        unitGross: commerceMoneySchema,
+    })
+        .strict();
+    const commerceProductOfferPricingSchema = z
+        .object({
+        productSlug: catalogProductSlugSchema,
+        unitCount: z.number().int().positive(),
+        oneTime: offerPriceSchema,
+        subscriptionInitial: offerPriceSchema,
+        subscriptionRecurring: offerPriceSchema,
+        catalogAnchorUnitGross: commerceMoneySchema,
+        initialDiscountPercent: z.number().int().min(0).max(100),
+        recurringDiscountPercent: z.number().int().min(0).max(100),
+    })
+        .strict();
+    const commerceOfferPricingV1ResponseSchema = z
+        .object({
+        contractVersion: z.literal(COMMERCE_OFFER_PRICING_CONTRACT_VERSION),
+        scope: scopeV1Schema,
+        products: z.array(commerceProductOfferPricingSchema).min(1),
+        minimum: z
+            .object({
+            oneTime: commerceProductOfferPricingSchema,
+            subscription: commerceProductOfferPricingSchema,
+        })
+            .strict(),
+    })
+        .strict();
+    const commerceOfferPricingV2ResponseSchema = z
+        .object({
+        contractVersion: z.literal(COMMERCE_OFFER_PRICING_V2_CONTRACT_VERSION),
+        scope: scopeV2Schema,
+        pricingPolicy: pricingPolicySnapshotSchema,
+        products: z.array(commerceProductOfferPricingSchema).min(1),
+        minimum: z.object({
+            oneTime: commerceProductOfferPricingSchema,
+            subscription: commerceProductOfferPricingSchema,
+        }).strict(),
+        shipping: z.object({
+            gross: commerceMoneySchema,
+            discountGross: commerceMoneySchema,
+            payable: commerceMoneySchema,
+        }).strict(),
+        minimumProductPayable: commerceMoneySchema,
+    })
+        .strict()
+        .refine((value) => value.pricingPolicy.offerPolicyVersion === "commerce.offer-policy.v2" &&
+        value.pricingPolicy.promotionEngineVersion === "promotion-engine.v2", { message: "offer-pricing v2 requires the paired v2 policy", path: ["pricingPolicy"] })
+        .refine((value) => value.minimumProductPayable.amountMinor === minimumProductPayableMinor, { message: minimumProductPayableMessage, path: ["minimumProductPayable"] })
+        .refine((value) => value.shipping.payable.amountMinor ===
+        value.shipping.gross.amountMinor - value.shipping.discountGross.amountMinor, { message: "offer-pricing v2 shipping arithmetic is inconsistent", path: ["shipping"] });
+    const commerceOfferPricingResponseSchema = z.union([
+        commerceOfferPricingV1ResponseSchema,
+        commerceOfferPricingV2ResponseSchema,
+    ]);
+    return { commerceProductOfferPricingSchema, commerceOfferPricingV1ResponseSchema,
+        commerceOfferPricingV2ResponseSchema, commerceOfferPricingResponseSchema };
+}