@openlup/platform 0.18.0 → 0.19.0

package/release-gates.json

@@ -5,94 +5,117 @@
     "internal-candidate": "Development-preview API; no stable compatibility claim."
   },
   "packageSurface": {
-    "./http": {
+    "./bff": {
       "role": "rail",
       "maturity": "experimental",
       "compatibilityPolicy": "internal-candidate",
       "packageSmokeEvidence": [
         "test/packageBoundary.test.ts",
-        "test/http/runtime.test.ts",
-        "test/http/webhookSignature.test.ts"
+        "test/bff/dispatch.test.ts"
       ],
-      "entrypoint": "dist/http/index.d.ts",
-      "snapshot": "api/http.api.md"
+      "entrypoint": "dist/bff/index.d.ts",
+      "snapshot": "api/bff.api.md"
     },
-    "./bff": {
+    "./blob": {
       "role": "rail",
       "maturity": "experimental",
       "compatibilityPolicy": "internal-candidate",
       "packageSmokeEvidence": [
         "test/packageBoundary.test.ts",
-        "test/bff/dispatch.test.ts"
+        "test/blob/binding.test.ts"
       ],
-      "entrypoint": "dist/bff/index.d.ts",
-      "snapshot": "api/bff.api.md"
+      "entrypoint": "dist/blob/index.d.ts",
+      "snapshot": "api/blob.api.md"
     },
-    "./scheduler": {
-      "role": "rail",
+    "./catalog": {
+      "role": "capability",
       "maturity": "experimental",
       "compatibilityPolicy": "internal-candidate",
       "packageSmokeEvidence": [
         "test/packageBoundary.test.ts",
-        "test/scheduler/jobs.test.ts"
+        "test/catalog/catalogDraftHandler.test.ts",
+        "test/catalog/catalogDraftValidation.test.ts",
+        "test/catalog/resolvedSkuProjection.test.ts",
+        "test/catalog/referenceCatalogHandler.test.ts",
+        "test/catalog/catalogMediaResolution.test.ts",
+        "test/catalog/catalogLifecycleContracts.test.ts",
+        "test/catalog/bundleRules.test.ts",
+        "test/catalog/bundleAvailability.test.ts",
+        "test/catalog/bundleAvailabilityService.test.ts",
+        "test/catalog/bundleCatalogReadPort.test.ts",
+        "test/catalog/sellableBundleHandler.test.ts",
+        "test/catalog/catalogFoundationContracts.test.ts",
+        "test/catalog/catalogDraftContracts.test.ts",
+        "test/catalog/bundlePriceSelectionParity.test.ts"
       ],
-      "entrypoint": "dist/scheduler/index.d.ts",
-      "snapshot": "api/scheduler.api.md"
+      "entrypoint": "dist/catalog/index.d.ts",
+      "snapshot": "api/catalog.api.md"
     },
-    "./blob": {
-      "role": "rail",
+    "./catalog/contracts": {
+      "role": "capability",
       "maturity": "experimental",
       "compatibilityPolicy": "internal-candidate",
       "packageSmokeEvidence": [
         "test/packageBoundary.test.ts",
-        "test/blob/binding.test.ts"
+        "test/catalog/catalogFoundationContracts.test.ts",
+        "test/catalog/catalogProductTypeContracts.test.ts",
+        "test/catalog/catalogDraftContracts.test.ts",
+        "test/catalog/catalogMediaResolution.test.ts",
+        "test/catalog/catalogLifecycleContracts.test.ts"
       ],
-      "entrypoint": "dist/blob/index.d.ts",
-      "snapshot": "api/blob.api.md"
+      "entrypoint": "dist/catalog/contracts/index.d.ts",
+      "snapshot": "api/catalog-contracts.api.md"
     },
-    "./data": {
-      "role": "rail",
+    "./communications": {
+      "role": "capability",
       "maturity": "experimental",
       "compatibilityPolicy": "internal-candidate",
       "packageSmokeEvidence": [
         "test/packageBoundary.test.ts",
-        "test/data/binding.test.ts"
+        "test/communications/sql.test.ts",
+        "test/communications/contribution.test.ts",
+        "test/communications/transportConformance.test.ts",
+        "test/communications/marketingSyncConformance.test.ts",
+        "test/communications/marketingSyncCompatibility.test.ts"
       ],
-      "entrypoint": "dist/data/index.d.ts",
-      "snapshot": "api/data.api.md"
+      "entrypoint": "dist/communications/index.d.ts",
+      "snapshot": "api/communications.api.md"
     },
-    "./migrations": {
-      "role": "rail",
+    "./communications/contracts": {
+      "role": "capability",
       "maturity": "experimental",
       "compatibilityPolicy": "internal-candidate",
       "packageSmokeEvidence": [
         "test/packageBoundary.test.ts",
-        "test/migrations/postgresRunner.test.ts"
+        "test/communications/contracts.test.ts",
+        "test/communications/marketingSyncConformance.test.ts",
+        "test/communications/marketingSyncCompatibility.test.ts"
       ],
-      "entrypoint": "dist/migrations/index.d.ts",
-      "snapshot": "api/migrations.api.md"
+      "entrypoint": "dist/communications/contracts/index.d.ts",
+      "snapshot": "api/communications-contracts.api.md"
     },
-    "./job-ledger": {
-      "role": "rail",
+    "./communications/klaviyo": {
+      "role": "capability",
       "maturity": "experimental",
       "compatibilityPolicy": "internal-candidate",
       "packageSmokeEvidence": [
-        "test/packageBoundary.test.ts",
-        "test/job-ledger/postgres.test.ts"
+        "test/communications/klaviyo/portConformance.test.ts",
+        "test/communications/klaviyo/protocol.test.ts",
+        "test/communications/klaviyo/permissions.test.ts"
       ],
-      "entrypoint": "dist/job-ledger/index.d.ts",
-      "snapshot": "api/job-ledger.api.md"
+      "entrypoint": "dist/communications/klaviyo/index.d.ts",
+      "snapshot": "api/communications-klaviyo.api.md"
     },
-    "./kernel": {
-      "role": "rail",
+    "./communications/resend": {
+      "role": "capability",
       "maturity": "experimental",
       "compatibilityPolicy": "internal-candidate",
       "packageSmokeEvidence": [
-        "test/packageBoundary.test.ts",
-        "test/kernel/platformKernel.test.ts"
+        "test/communications/resend/egress.test.ts",
+        "test/communications/resend/protocol.test.ts"
       ],
-      "entrypoint": "dist/kernel/index.d.ts",
-      "snapshot": "api/kernel.api.md"
+      "entrypoint": "dist/communications/resend/index.d.ts",
+      "snapshot": "api/communications-resend.api.md"
     },
     "./composition": {
       "role": "rail",
@@ -105,6 +128,29 @@
       "entrypoint": "dist/composition/index.d.ts",
       "snapshot": "api/composition.api.md"
     },
+    "./data": {
+      "role": "rail",
+      "maturity": "experimental",
+      "compatibilityPolicy": "internal-candidate",
+      "packageSmokeEvidence": [
+        "test/packageBoundary.test.ts",
+        "test/data/binding.test.ts"
+      ],
+      "entrypoint": "dist/data/index.d.ts",
+      "snapshot": "api/data.api.md"
+    },
+    "./http": {
+      "role": "rail",
+      "maturity": "experimental",
+      "compatibilityPolicy": "internal-candidate",
+      "packageSmokeEvidence": [
+        "test/packageBoundary.test.ts",
+        "test/http/runtime.test.ts",
+        "test/http/webhookSignature.test.ts"
+      ],
+      "entrypoint": "dist/http/index.d.ts",
+      "snapshot": "api/http.api.md"
+    },
     "./identity": {
       "role": "capability",
       "maturity": "experimental",
@@ -127,71 +173,68 @@
       "entrypoint": "dist/identity/contracts/index.d.ts",
       "snapshot": "api/identity-contracts.api.md"
     },
-    "./communications": {
+    "./inventory": {
       "role": "capability",
       "maturity": "experimental",
       "compatibilityPolicy": "internal-candidate",
       "packageSmokeEvidence": [
         "test/packageBoundary.test.ts",
-        "test/communications/sql.test.ts",
-        "test/communications/contribution.test.ts",
-        "test/communications/transportConformance.test.ts",
-        "test/communications/marketingSyncConformance.test.ts",
-        "test/communications/marketingSyncCompatibility.test.ts"
+        "test/inventory/contracts.test.ts",
+        "test/inventory/adminInventoryConformance.test.ts",
+        "test/inventory/inventoryAvailabilityCharacterization.test.ts",
+        "test/inventory/newPurchaseStockBoundary.test.ts",
+        "test/inventory/reservationPolicyConformance.test.ts",
+        "test/inventory/subscriptionForecastCalculation.test.ts"
       ],
-      "entrypoint": "dist/communications/index.d.ts",
-      "snapshot": "api/communications.api.md"
+      "entrypoint": "dist/inventory/index.d.ts",
+      "snapshot": "api/inventory.api.md"
     },
-    "./communications/contracts": {
+    "./inventory/contracts": {
       "role": "capability",
       "maturity": "experimental",
       "compatibilityPolicy": "internal-candidate",
       "packageSmokeEvidence": [
         "test/packageBoundary.test.ts",
-        "test/communications/contracts.test.ts",
-        "test/communications/marketingSyncConformance.test.ts",
-        "test/communications/marketingSyncCompatibility.test.ts"
+        "test/inventory/contracts.test.ts",
+        "test/inventory/newPurchaseStockBoundary.test.ts",
+        "test/inventory/reservationPolicyConformance.test.ts",
+        "test/inventory/subscriptionForecastCalculation.test.ts"
       ],
-      "entrypoint": "dist/communications/contracts/index.d.ts",
-      "snapshot": "api/communications-contracts.api.md"
+      "entrypoint": "dist/inventory/contracts/index.d.ts",
+      "snapshot": "api/inventory-contracts.api.md"
     },
-    "./catalog": {
-      "role": "capability",
+    "./job-ledger": {
+      "role": "rail",
       "maturity": "experimental",
       "compatibilityPolicy": "internal-candidate",
       "packageSmokeEvidence": [
         "test/packageBoundary.test.ts",
-        "test/catalog/catalogDraftHandler.test.ts",
-        "test/catalog/catalogDraftValidation.test.ts",
-        "test/catalog/resolvedSkuProjection.test.ts",
-        "test/catalog/referenceCatalogHandler.test.ts",
-        "test/catalog/catalogMediaResolution.test.ts",
-        "test/catalog/catalogLifecycleContracts.test.ts",
-        "test/catalog/bundleRules.test.ts",
-        "test/catalog/bundleAvailability.test.ts",
-        "test/catalog/bundleAvailabilityService.test.ts",
-        "test/catalog/bundleCatalogReadPort.test.ts",
-        "test/catalog/sellableBundleHandler.test.ts",
-        "test/catalog/catalogFoundationContracts.test.ts",
-        "test/catalog/catalogDraftContracts.test.ts"
+        "test/job-ledger/postgres.test.ts"
       ],
-      "entrypoint": "dist/catalog/index.d.ts",
-      "snapshot": "api/catalog.api.md"
+      "entrypoint": "dist/job-ledger/index.d.ts",
+      "snapshot": "api/job-ledger.api.md"
     },
-    "./catalog/contracts": {
-      "role": "capability",
+    "./kernel": {
+      "role": "rail",
       "maturity": "experimental",
       "compatibilityPolicy": "internal-candidate",
       "packageSmokeEvidence": [
         "test/packageBoundary.test.ts",
-        "test/catalog/catalogFoundationContracts.test.ts",
-        "test/catalog/catalogProductTypeContracts.test.ts",
-        "test/catalog/catalogDraftContracts.test.ts",
-        "test/catalog/catalogMediaResolution.test.ts",
-        "test/catalog/catalogLifecycleContracts.test.ts"
+        "test/kernel/platformKernel.test.ts"
       ],
-      "entrypoint": "dist/catalog/contracts/index.d.ts",
-      "snapshot": "api/catalog-contracts.api.md"
+      "entrypoint": "dist/kernel/index.d.ts",
+      "snapshot": "api/kernel.api.md"
+    },
+    "./migrations": {
+      "role": "rail",
+      "maturity": "experimental",
+      "compatibilityPolicy": "internal-candidate",
+      "packageSmokeEvidence": [
+        "test/packageBoundary.test.ts",
+        "test/migrations/postgresRunner.test.ts"
+      ],
+      "entrypoint": "dist/migrations/index.d.ts",
+      "snapshot": "api/migrations.api.md"
     },
     "./pricing": {
       "role": "capability",
@@ -217,7 +260,8 @@
         "test/pricing/commerceOfferPricingCache.test.ts",
         "test/pricing/offerPolicyReadiness.test.ts",
         "test/pricing/acquisition.test.ts",
-        "test/pricing/offerPricingContracts.test.ts"
+        "test/pricing/offerPricingContracts.test.ts",
+        "test/pricing/concurrentCommercePriceAuthorityParity.test.ts"
       ],
       "entrypoint": "dist/pricing/index.d.ts",
       "snapshot": "api/pricing.api.md"
@@ -275,58 +319,16 @@
       "entrypoint": "dist/promotions/contracts/index.d.ts",
       "snapshot": "api/promotions-contracts.api.md"
     },
-    "./communications/resend": {
-      "role": "capability",
-      "maturity": "experimental",
-      "compatibilityPolicy": "internal-candidate",
-      "packageSmokeEvidence": [
-        "test/communications/resend/egress.test.ts",
-        "test/communications/resend/protocol.test.ts"
-      ],
-      "entrypoint": "dist/communications/resend/index.d.ts",
-      "snapshot": "api/communications-resend.api.md"
-    },
-    "./communications/klaviyo": {
-      "role": "capability",
-      "maturity": "experimental",
-      "compatibilityPolicy": "internal-candidate",
-      "packageSmokeEvidence": [
-        "test/communications/klaviyo/portConformance.test.ts",
-        "test/communications/klaviyo/protocol.test.ts",
-        "test/communications/klaviyo/permissions.test.ts"
-      ],
-      "entrypoint": "dist/communications/klaviyo/index.d.ts",
-      "snapshot": "api/communications-klaviyo.api.md"
-    },
-    "./inventory": {
-      "role": "capability",
-      "maturity": "experimental",
-      "compatibilityPolicy": "internal-candidate",
-      "packageSmokeEvidence": [
-        "test/packageBoundary.test.ts",
-        "test/inventory/contracts.test.ts",
-        "test/inventory/adminInventoryConformance.test.ts",
-        "test/inventory/inventoryAvailabilityCharacterization.test.ts",
-        "test/inventory/newPurchaseStockBoundary.test.ts",
-        "test/inventory/reservationPolicyConformance.test.ts",
-        "test/inventory/subscriptionForecastCalculation.test.ts"
-      ],
-      "entrypoint": "dist/inventory/index.d.ts",
-      "snapshot": "api/inventory.api.md"
-    },
-    "./inventory/contracts": {
-      "role": "capability",
+    "./scheduler": {
+      "role": "rail",
       "maturity": "experimental",
       "compatibilityPolicy": "internal-candidate",
       "packageSmokeEvidence": [
         "test/packageBoundary.test.ts",
-        "test/inventory/contracts.test.ts",
-        "test/inventory/newPurchaseStockBoundary.test.ts",
-        "test/inventory/reservationPolicyConformance.test.ts",
-        "test/inventory/subscriptionForecastCalculation.test.ts"
+        "test/scheduler/jobs.test.ts"
       ],
-      "entrypoint": "dist/inventory/contracts/index.d.ts",
-      "snapshot": "api/inventory-contracts.api.md"
+      "entrypoint": "dist/scheduler/index.d.ts",
+      "snapshot": "api/scheduler.api.md"
     },
     "./shipping": {
       "role": "capability",
@@ -361,23 +363,23 @@
       "maxFiles": 2000
     },
     "docs": {
-      "maxPackedBytes": 40960,
+      "maxPackedBytes": 49152,
       "maxFiles": 10
     },
     "maxPackedBytes": 1351680,
     "maxUnpackedBytes": 5734400,
     "maxFiles": 2100,
     "baseline": {
-      "version": "0.17.0",
-      "packedBytes": 414220
+      "version": "0.18.0",
+      "packedBytes": 779849
     },
     "browserEntries": {
+      "./catalog/contracts": 4096,
       "./communications/contracts": 11776,
       "./identity/contracts": 4800,
-      "./catalog/contracts": 4096,
+      "./inventory/contracts": 32,
       "./pricing/contracts": 416,
       "./promotions/contracts": 32,
-      "./inventory/contracts": 32,
       "./shipping/contracts": 32
     }
   }

package/src/catalog/adminBundleReadHandler.ts

@@ -2,9 +2,10 @@ import type { BundleAdminBindings, AuthorizeAdmin, AgentDomainQuerySpec, BundleQ
 import { allocateBundleTargetPrice, type BundleAllocationFailure } from "@openlup/core/pricing";
 import type { BundleHistoryRequest, BundlePricePreview, GetBundleRequest, ListBundlesRequest, PreviewBundlePriceRequest } from "./contracts/bundleRead.js";
 import type { BundleAvailabilityRow, BundleAvailabilityService } from "./bundleAvailabilityService.js";
-import type { BundleCatalogReadPort, BundleDetail, BundleHistoryResult, ListBundlesResult } from "./bundleCatalogReadPort.js";
+import type { BundleCatalogReadPort, BundleDetail, BundleHistoryResult, BundleTargetPriceRow, ListBundlesResult } from "./bundleCatalogReadPort.js";
 
 export interface AdminBundleReadHandlerDeps {
+  effectiveTarget?: (bundle: BundleDetail) => BundleTargetPriceRow | null;
   readPort: BundleCatalogReadPort;
   authorizeAdmin: AuthorizeAdmin;
   readsEnabled: boolean;
@@ -171,7 +172,7 @@ function createAdminBundlePreviewPriceHandler(deps: AdminBundleReadHandlerDeps)
         mode: input.mode,
       });
       if (!bundle) throw new BundleRpcError("P0002", "bundle_not_found");
-      return previewBundlePrice(bundle, input);
+      return previewBundlePrice(bundle, input, deps.effectiveTarget);
     },
     (preview) => ({ contractVersion: COMMERCE_CONTRACT_VERSION, preview }),
     previewBundlePriceResponseSchema,
@@ -213,6 +214,7 @@ function toDetailView(bundle: BundleDetail, stock: BundleAvailabilityRow | null)
 function previewBundlePrice(
   bundle: BundleDetail,
   input: PreviewBundlePriceRequest,
+  effectiveTarget?: (bundle: BundleDetail) => BundleTargetPriceRow | null,
 ): BundlePricePreview {
   if (!bundle.resolvedPriceListId || !bundle.resolvedCurrency) {
     throw new BundleRpcError("P0002", "no_active_price_list");
@@ -224,7 +226,7 @@ function previewBundlePrice(
     throw new BundleRpcError("P0001", `component_unpriced:${unpriced[0].sku}`);
   }
 
-  const activePrice = bundle.prices.find(
+  const activePrice = effectiveTarget ? effectiveTarget(bundle) : bundle.prices.find(
     (price) => price.active && (!input.mode || price.mode === input.mode),
   );
   const targetPriceMinor = input.targetPriceMinor ?? activePrice?.targetPriceMinor;
@@ -245,7 +247,7 @@ function previewBundlePrice(
   return {
     bundleCode: bundle.code,
     priceListId: bundle.resolvedPriceListId,
-    mode: input.mode ?? activePrice?.mode ?? "any",
+    mode: input.mode ?? activePrice?.mode ?? (effectiveTarget ? "one_time" : "any"),
     currency: bundle.resolvedCurrency,
     referenceTotalMinor: allocation.referenceTotalMinor,
     targetPriceMinor: allocation.targetPriceMinor,

package/src/catalog/bundleCatalogReadPort.ts

@@ -98,6 +98,8 @@ export interface BundleDetail extends BundleSummary {
   metadata: Record<string, unknown>;
   components: BundleComponentRow[];
   prices: BundleTargetPriceRow[];
+  /** Present only when the host selects effective price authority. */
+  resolvedTargetPrice?: BundleTargetPriceRow | null;
   /** The currency whose list resolved `referenceUnitPriceMinor`; `null` if none did. */
   resolvedCurrency: string | null;
   /**
@@ -116,8 +118,10 @@ export interface GetBundleInput {
    * only currency an operator has actually chosen for it.
    */
   currency?: string;
-  /** Narrow the target price whose list is selected; omitted means any mode. */
+  /** Narrow the target price whose list is selected; omitted means any mode (the opt-in effective store defaults to one_time). */
   mode?: string;
+  regionCode?: string;
+  atTime?: string;
 }
 
 /**
@@ -167,7 +171,7 @@ export interface BundleCatalogReadPort {
    * Every bundle a storefront may sell right now. Never returns a draft or an
    * archived bundle, and never a bundle without an active target price.
    */
-  listActiveBundleCompositions(input?: { currency?: string }): Promise<ActiveBundleComposition[]>;
+  listActiveBundleCompositions(input?: { currency?: string; regionCode?: string; mode?: "one_time" | "subscription"; atTime?: string }): Promise<ActiveBundleComposition[]>;
   /**
    * The operator trail for one bundle. The two chains answer from different
    * ledgers — a managed audit table and the platform's neutral write-event

package/src/catalog/bundleCatalogStore.ts

@@ -1,3 +1,4 @@
+import { createEffectiveBundleCatalogStore } from "./effectiveBundleCatalogStore.js";
 import {
   BundleCatalogReadError,
 } from "./bundleCatalogReadPort.js";
@@ -101,7 +102,11 @@ interface WriteEventRow {
 
 export function createPostgresBundleCatalogStore(
   executor: PgQueryExecutor,
+  options?: { priceAuthority?: "effective" },
 ): BundleCatalogReadPort {
+  if (options?.priceAuthority === "effective") {
+    return createEffectiveBundleCatalogStore(executor, createPostgresBundleCatalogStore(executor));
+  }
   async function rows<T>(sql: string, values: unknown[]): Promise<T[]> {
     // A driver failure becomes the port's own read error, so a caller sees the
     // same distinction between "found nothing" and "could not ask" on both chains.

package/src/catalog/bundlePriceSelection.ts

@@ -0,0 +1,25 @@
+import { selectUniqueEffectivePriceList } from "../pricing/index.js";
+import { BundleCatalogReadError, type BundleTargetPriceRow } from "./bundleCatalogReadPort.js";
+
+/** Half-open windows share the price authority's effective-time rule. */
+function bundlePriceEffective(row: { validFrom: string; validTo: string | null }, atTime: string): boolean {
+  try {
+    selectUniqueEffectivePriceList([{ value: "row", ...row }], atTime);
+    return true;
+  } catch { return false; }
+}
+export function uniqueBundlePrice<T extends { mode: string }>(rows: readonly T[], mode: string): T | null {
+  const exact = rows.filter(row => row.mode === mode);
+  const candidates = exact.length ? exact : rows.filter(row => row.mode === "any");
+  if (candidates.length > 1) throw new BundleCatalogReadError("bundle_price_ambiguous");
+  return candidates[0] ?? null;
+}
+export function selectEffectiveBundleTargetPrice(
+  rows: readonly { price: BundleTargetPriceRow; priceListId: string }[],
+  context: { priceListId: string | null; currency: string | null; mode: string; atTime: string },
+): BundleTargetPriceRow | null {
+  if (context.priceListId === null || context.currency === null) return null;
+  return uniqueBundlePrice(rows.filter(row => row.priceListId === context.priceListId
+    && row.price.currency === context.currency && row.price.active && row.price.amountKind === "gross"
+    && row.price.targetPriceMinor > 0 && bundlePriceEffective(row.price, context.atTime)).map(row => row.price), context.mode);
+}

package/src/catalog/contracts/bundleRead.ts

@@ -3,8 +3,8 @@ export type ListBundlesRequest = { limit: number; offset: number; status: "draft
 export type ListBundlesResponse = { bundles: { code: string; title: string; status: string; fulfillmentMode: string; componentCount: number; hasActiveTargetPrice: boolean; updatedAt: string; }[]; total: number; contractVersion: "commerce.v0"; };
 export type BundleSummaryView = { code: string; title: string; status: string; fulfillmentMode: string; componentCount: number; hasActiveTargetPrice: boolean; updatedAt: string; };
 export type GetBundleRequest = { code: string; currency?: string | undefined; mode?: "any" | "one_time" | "subscription" | undefined; };
-export type GetBundleResponse = { bundle: { code: string; title: string; status: string; fulfillmentMode: string; componentCount: number; hasActiveTargetPrice: boolean; updatedAt: string; compositionConstraint: { kind: string; version: number; data: Record<string, unknown>; } | null; metadata: Record<string, unknown>; components: { sku: string; title: string | null; productSlug: string; quantity: number; isAddon: boolean; sortOrder: number; referenceUnitPriceMinor: number | null; }[]; prices: { mode: string; targetPriceMinor: number; currency: string; amountKind: string; active: boolean; validFrom: string; validTo: string | null; }[]; resolvedCurrency: string | null; availability: { sellableNow: number | null; status: string; reasonCode: string; limitingSku: string | null; components: { sku: string; quantity: number; isAddon: boolean; sellableNow: number | null; }[]; } | null; }; contractVersion: "commerce.v0"; };
-export type BundleDetailView = { code: string; title: string; status: string; fulfillmentMode: string; componentCount: number; hasActiveTargetPrice: boolean; updatedAt: string; compositionConstraint: { kind: string; version: number; data: Record<string, unknown>; } | null; metadata: Record<string, unknown>; components: { sku: string; title: string | null; productSlug: string; quantity: number; isAddon: boolean; sortOrder: number; referenceUnitPriceMinor: number | null; }[]; prices: { mode: string; targetPriceMinor: number; currency: string; amountKind: string; active: boolean; validFrom: string; validTo: string | null; }[]; resolvedCurrency: string | null; availability: { sellableNow: number | null; status: string; reasonCode: string; limitingSku: string | null; components: { sku: string; quantity: number; isAddon: boolean; sellableNow: number | null; }[]; } | null; };
+export type GetBundleResponse = { bundle: { code: string; title: string; status: string; fulfillmentMode: string; componentCount: number; hasActiveTargetPrice: boolean; updatedAt: string; compositionConstraint: { kind: string; version: number; data: Record<string, unknown>; } | null; metadata: Record<string, unknown>; components: { sku: string; title: string | null; productSlug: string; quantity: number; isAddon: boolean; sortOrder: number; referenceUnitPriceMinor: number | null; }[]; prices: { mode: string; targetPriceMinor: number; currency: string; amountKind: string; active: boolean; validFrom: string; validTo: string | null; }[]; resolvedTargetPrice?: { mode: string; targetPriceMinor: number; currency: string; amountKind: string; active: boolean; validFrom: string; validTo: string | null; } | null; resolvedCurrency: string | null; availability: { sellableNow: number | null; status: string; reasonCode: string; limitingSku: string | null; components: { sku: string; quantity: number; isAddon: boolean; sellableNow: number | null; }[]; } | null; }; contractVersion: "commerce.v0"; };
+export type BundleDetailView = { code: string; title: string; status: string; fulfillmentMode: string; componentCount: number; hasActiveTargetPrice: boolean; updatedAt: string; compositionConstraint: { kind: string; version: number; data: Record<string, unknown>; } | null; metadata: Record<string, unknown>; components: { sku: string; title: string | null; productSlug: string; quantity: number; isAddon: boolean; sortOrder: number; referenceUnitPriceMinor: number | null; }[]; prices: { mode: string; targetPriceMinor: number; currency: string; amountKind: string; active: boolean; validFrom: string; validTo: string | null; }[]; resolvedTargetPrice?: { mode: string; targetPriceMinor: number; currency: string; amountKind: string; active: boolean; validFrom: string; validTo: string | null; } | null; resolvedCurrency: string | null; availability: { sellableNow: number | null; status: string; reasonCode: string; limitingSku: string | null; components: { sku: string; quantity: number; isAddon: boolean; sellableNow: number | null; }[]; } | null; };
 export type BundleAvailabilityView = { sellableNow: number | null; status: string; reasonCode: string; limitingSku: string | null; components: { sku: string; quantity: number; isAddon: boolean; sellableNow: number | null; }[]; };
 export type BundleHistoryRequest = { limit: number; offset: number; code: string; };
 export type BundleHistoryResponse = { events: { id: string; action: string; actorKind: string | null; actorEmail: string | null; entityId: string | null; oldValue: unknown; newValue: unknown; occurredAt: string; }[]; total: number; contractVersion: "commerce.v0"; };

package/src/catalog/contracts/draft.ts

@@ -39,7 +39,7 @@ export function canonicalCatalogDraftJson(input: unknown): string {
   function visit(value: unknown, depth: number): unknown {
     if (depth > 48) throw new Error("draft_json_depth");
     if (typeof value === "string") {
-      if (value.includes("\u0000") || /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/u.test(value)) throw new Error("draft_json_invalid");
+      if (value.includes("\u0000") || /[\uD800-\uDFFF]/u.test(value)) throw new Error("draft_json_invalid");
       return value;
     }
     if (value === null || typeof value === "boolean") return value;

package/src/catalog/effectiveBundleCatalogQueries.ts

@@ -0,0 +1,80 @@
+/** Effective-authority SQL is isolated from the incumbent exported statements. */
+const ANCHORS = `SELECT pe.unit_price_minor FROM public.price_entries pe
+  WHERE pe.variant_id = s.id AND pe.price_list_id = %LIST% AND pe.active
+    AND pe.min_qty = 1 AND pe.amount_kind = 'gross'
+    AND pe.valid_from <= $3::timestamptz AND (pe.valid_to IS NULL OR pe.valid_to > $3::timestamptz)
+    AND (pe.mode = $4::text OR (pe.mode = 'any' AND NOT EXISTS (
+      SELECT 1 FROM public.price_entries exact WHERE exact.variant_id = s.id
+        AND exact.price_list_id = pe.price_list_id AND exact.active AND exact.min_qty = 1
+        AND exact.amount_kind = 'gross' AND exact.mode = $4::text
+        AND exact.valid_from <= $3::timestamptz AND (exact.valid_to IS NULL OR exact.valid_to > $3::timestamptz))))`;
+const FACTS = `s.status AS sku_status, s.sellable_standalone, s.sellable_in_subscription,
+  s.net_weight_g, pr.status AS product_status,
+  (pr.primary_sku_id IS NOT NULL AND revision.id IS NOT NULL) AS document_ready,
+  COALESCE((SELECT jsonb_agg(jsonb_build_object('issuer', identifier.issuer, 'normalizedValue', identifier.normalized_value,
+    'kind', identifier.identifier_kind, 'packKind', identifier.pack_kind, 'packQuantity', identifier.quantity, 'isPrimary', identifier.is_primary))
+    FROM public.catalog_sku_identifiers identifier WHERE identifier.catalog_sku_id = s.id), '[]'::jsonb) AS identifiers`;
+const REFERENCE = `(SELECT (array_agg(candidate.unit_price_minor))[1] FROM (${ANCHORS}) candidate)`;
+const COUNT = `(SELECT count(*) FROM (${ANCHORS}) candidate)`;
+export const COMPONENT_SQL = `
+  SELECT c.bundle_id, s.sku, s.title, pr.slug AS product_slug, s.id AS variant_id,
+    c.quantity, c.is_addon, c.sort_order, ${FACTS},
+    ${REFERENCE.replace("%LIST%", "$2::uuid")} AS reference_unit_price_minor,
+    ${COUNT.replace("%LIST%", "$2::uuid")} AS reference_price_count
+  FROM public.catalog_bundle_components c
+  JOIN public.catalog_skus s ON s.id = c.catalog_sku_id
+  JOIN public.catalog_products pr ON pr.id = s.product_id
+  LEFT JOIN public.catalog_product_document_revisions revision ON revision.id = pr.current_document_revision_id AND revision.product_id = pr.id
+  WHERE c.bundle_id = $1::uuid ORDER BY c.sort_order, s.sku`;
+export const FEED_COMPONENT_SQL = `
+  SELECT c.bundle_id, s.sku, s.title, pr.slug AS product_slug, s.id AS variant_id,
+    c.quantity, c.is_addon, c.sort_order, ${FACTS},
+    ${REFERENCE.replace("%LIST%", "selected.price_list_id")} AS reference_unit_price_minor,
+    ${COUNT.replace("%LIST%", "selected.price_list_id")} AS reference_price_count
+  FROM unnest($1::uuid[], $2::uuid[]) AS selected(bundle_id, price_list_id)
+  JOIN public.catalog_bundle_components c ON c.bundle_id = selected.bundle_id
+  JOIN public.catalog_skus s ON s.id = c.catalog_sku_id
+  JOIN public.catalog_products pr ON pr.id = s.product_id
+  LEFT JOIN public.catalog_product_document_revisions revision ON revision.id = pr.current_document_revision_id AND revision.product_id = pr.id
+  ORDER BY c.bundle_id, c.sort_order, s.sku`;
+export const PRICE_SQL = `
+  SELECT p.mode, p.price_list_id, p.target_price_minor, list.currency, p.amount_kind, p.active, p.valid_from, p.valid_to
+  FROM public.catalog_bundle_prices p JOIN public.price_lists list ON list.id = p.price_list_id
+  WHERE p.bundle_id = $1::uuid ORDER BY p.valid_from DESC`;
+export const OWN_LIST_SQL = `
+  SELECT list.id, list.currency, list.region_code, p.mode
+  FROM public.catalog_bundle_prices p JOIN public.price_lists list ON list.id = p.price_list_id
+  WHERE p.bundle_id = $1::uuid AND p.active AND p.amount_kind = 'gross'
+    AND (p.mode = $2::text OR p.mode = 'any') AND list.status = 'active'
+    AND p.valid_from <= $3::timestamptz AND (p.valid_to IS NULL OR p.valid_to > $3::timestamptz)
+    AND list.valid_from <= $3::timestamptz AND (list.valid_to IS NULL OR list.valid_to > $3::timestamptz)
+  ORDER BY p.valid_from DESC`;
+export const CURRENCY_LIST_SQL = `
+  SELECT id, currency, region_code FROM public.price_lists
+  WHERE currency = $1::text AND status = 'active' AND ($2::text IS NULL OR region_code = $2::text)
+    AND valid_from <= $3::timestamptz AND (valid_to IS NULL OR valid_to > $3::timestamptz)`;
+export const FEED_SQL = `
+  SELECT b.id, b.code, b.title, b.fulfillment_mode, p.mode, p.target_price_minor, p.price_list_id, list.currency, list.region_code
+  FROM public.catalog_bundles b
+  JOIN public.catalog_bundle_prices p ON p.bundle_id = b.id AND p.active
+  JOIN public.price_lists list ON list.id = p.price_list_id
+  WHERE b.status = 'active' AND p.amount_kind = 'gross' AND p.target_price_minor > 0
+    AND list.status = 'active' AND ($1::text IS NULL OR list.currency = $1::text)
+    AND ($2::text IS NULL OR list.region_code = $2::text) AND (p.mode = $4::text OR p.mode = 'any')
+    AND p.valid_from <= $3::timestamptz AND (p.valid_to IS NULL OR p.valid_to > $3::timestamptz)
+    AND list.valid_from <= $3::timestamptz AND (list.valid_to IS NULL OR list.valid_to > $3::timestamptz)
+  ORDER BY b.code, p.valid_from DESC`;
+
+const SUMMARY_COLUMNS = `b.id, b.code, b.title, b.status, b.fulfillment_mode, b.updated_at,
+  b.composition_constraint, b.metadata,
+  (SELECT count(*) FROM public.catalog_bundle_components c WHERE c.bundle_id = b.id) AS component_count,
+  EXISTS (SELECT 1 FROM public.catalog_bundle_prices p JOIN public.price_lists list ON list.id = p.price_list_id
+    WHERE p.bundle_id = b.id AND p.active AND p.amount_kind = 'gross' AND p.target_price_minor > 0
+      AND p.mode IN ('one_time', 'any') AND list.status = 'active'
+      AND p.valid_from <= CURRENT_TIMESTAMP AND (p.valid_to IS NULL OR p.valid_to > CURRENT_TIMESTAMP)
+      AND list.valid_from <= CURRENT_TIMESTAMP AND (list.valid_to IS NULL OR list.valid_to > CURRENT_TIMESTAMP)) AS has_active_target_price`;
+export const DETAIL_SQL = `SELECT ${SUMMARY_COLUMNS} FROM public.catalog_bundles b WHERE b.code = $1`;
+export const LIST_SQL = `SELECT ${SUMMARY_COLUMNS} FROM public.catalog_bundles b
+  WHERE ($1::text = 'all' OR b.status = $1::text)
+    AND ($2::text IS NULL OR b.code ILIKE '%' || $2 || '%' OR b.title ILIKE '%' || $2 || '%')
+  ORDER BY b.code LIMIT $3 OFFSET $4`;