@openlup/platform 0.25.0 → 0.27.0

package/src/commerce/server/configuratorIntentPersistence.ts

@@ -0,0 +1,161 @@
+import type { z } from "zod";
+import type { ConfiguratorIntentPersistencePort } from "../contracts/ports.js";
+import type { CheckoutCommandPersistencePort } from "../contracts/runtimePorts.js";
+import type { RpcError } from "../contracts/omsTypes.js";
+import { ConfiguratorIntentPersistenceConflictError } from "./configuratorIntentPersistenceHandler.js";
+
+interface ConfiguratorIntentIdentityQueryResult {
+  data: Array<{ response_payload?: unknown }> | null;
+  error: RpcError | null;
+}
+
+interface ConfiguratorIntentIdentityQuery {
+  eq(column: string, value: unknown): ConfiguratorIntentIdentityQuery;
+  limit(count: number): PromiseLike<ConfiguratorIntentIdentityQueryResult>;
+}
+
+interface ConfiguratorIntentIdentityTable {
+  select(columns: string): ConfiguratorIntentIdentityQuery;
+}
+
+/**
+ * The identity the ROUTE proved for this request, and the only identity the RPC
+ * is allowed to believe.
+ *
+ * ⛔ It is not read from the request body and never can be: `withVerifiedSubject`
+ * writes it last and unconditionally, so a payload that carries the key has it
+ * overwritten rather than honoured. A guest is `null`, which is a positive claim
+ * that nobody proved anything - not an absence the RPC may fill in.
+ */
+export interface ConfiguratorIntentPersistenceIdentity {
+  authenticatedUserId: string | null;
+}
+
+type PersistIntentPayload<Request, Command> =
+  (Request | Command) & { authenticatedUserId: string | null };
+
+export interface ConfiguratorIntentRpcQueryClient<Request, Command> {
+  rpc(
+    functionName: "commerce_configurator_persist_intent",
+    args: { p_intent: PersistIntentPayload<Request, Command> },
+  ): PromiseLike<{ data: unknown; error: RpcError | null }>;
+  from(tableName: "commerce_idempotency_keys"): ConfiguratorIntentIdentityTable;
+}
+
+/** Scope used by the persist-intent RPC for its idempotency-key rows. */
+const CONFIGURATOR_INTENT_SCOPE = "commerce_configurator_intent";
+
+export function createConfiguratorIntentPersistenceRpcPort<Request extends object, Response, Command extends object, Persistence>(
+  client: ConfiguratorIntentRpcQueryClient<Request, Command>,
+  bindings: {
+    responseSchema: z.ZodType<Response>;
+    decodeCommandResponse(data: unknown): Persistence;
+    normalizePhoneToE164(phone: string, country: unknown): string | null;
+  },
+  identity: ConfiguratorIntentPersistenceIdentity = { authenticatedUserId: null },
+): ConfiguratorIntentPersistencePort<Request, Response> & CheckoutCommandPersistencePort<Command, Persistence> {
+  return {
+    async persistIntent(
+      request: Request,
+    ): Promise<Response> {
+      const { data, error } = await client.rpc("commerce_configurator_persist_intent", {
+        p_intent: withVerifiedSubject(withCanonicalIntentPhone(request), identity),
+      });
+      if (error) throw mapRpcError(error);
+
+      return bindings.responseSchema.parse(data);
+    },
+
+    async persistCheckoutCommand(command) {
+      const { data, error } = await client.rpc("commerce_configurator_persist_intent", {
+        p_intent: withVerifiedSubject(withCanonicalCommandPhone(command), identity),
+      });
+      if (error) throw mapRpcError(error);
+
+      return bindings.decodeCommandResponse(data);
+    },
+
+    async findCompletedIdentity(
+      idempotencyKey: string,
+    ): Promise<Response | null> {
+      // Read back the identity the RPC stored on the COMPLETED key. The RPC writes
+      // the full response object into `response_payload`, so it validates against
+      // the same schema persistIntent returns. A different/missing row -> null,
+      // which the caller treats as "cannot resume -> 409".
+      const { data, error } = await client
+        .from("commerce_idempotency_keys")
+        .select("response_payload")
+        .eq("scope", CONFIGURATOR_INTENT_SCOPE)
+        .eq("idempotency_key", idempotencyKey)
+        .eq("status", "completed")
+        .limit(1);
+      if (error) {
+        throw new Error(
+          `Configurator intent identity lookup failed: ${error.message ?? "query failed"}`,
+        );
+      }
+
+      const payload = data?.[0]?.response_payload;
+      if (!payload) return null;
+
+      const parsed = bindings.responseSchema.safeParse(payload);
+      return parsed.success ? parsed.data : null;
+    },
+  };
+
+  // Canonicalization is fail-open: an unparseable non-empty phone is preserved verbatim.
+  function canonicalPhoneRewrite(contact: unknown, address: unknown): string | null {
+    const phone = (contact as { phone?: unknown } | undefined)?.phone;
+    if (typeof phone !== "string" || phone.trim() === "") return null;
+
+    const country = (address as { country?: unknown } | undefined)?.country;
+    const canonical = bindings.normalizePhoneToE164(phone, country) ?? phone;
+    return canonical === phone ? null : canonical;
+  }
+
+  /**
+   * Stamp the route-verified subject onto the payload, LAST.
+   *
+   * The RPC resolves its client row by e-mail, and an e-mail typed into an
+   * anonymous request is a client-supplied object identifier - knowing one is not
+   * authorization to edit the record it names. This is the single line that decides
+   * whose identity the database is allowed to write, so it overwrites rather than
+   * defaults: a caller who puts `authenticatedUserId` in the body gets it replaced.
+   */
+  function withVerifiedSubject<T extends object>(
+    payload: T,
+    identity: ConfiguratorIntentPersistenceIdentity,
+  ): T & { authenticatedUserId: string | null } {
+    return { ...payload, authenticatedUserId: identity.authenticatedUserId };
+  }
+
+  function withCanonicalIntentPhone(
+    request: Request,
+  ): Request {
+    const phone = canonicalPhoneRewrite((request as { contact?: unknown }).contact, (request as { address?: unknown }).address);
+    if (phone === null) return request;
+    return { ...request, contact: { ...(request as { contact?: object }).contact, phone } };
+  }
+
+  function withCanonicalCommandPhone(command: Command): Command {
+    const phone = canonicalPhoneRewrite((command as { customer?: unknown }).customer, (command as { shippingAddress?: unknown }).shippingAddress);
+    if (phone === null) return command;
+    return { ...command, customer: { ...(command as { customer?: object }).customer, phone } };
+  }
+
+}
+
+function mapRpcError(error: RpcError): Error {
+  const text = [error.message, error.details, error.hint].filter(Boolean).join(" ");
+  if (
+    error.code === "23505" ||
+    /configurator_intent_.*(?:conflict|invalid|missing)/.test(text)
+  ) {
+    return new ConfiguratorIntentPersistenceConflictError(
+      "Configurator intent persistence conflict",
+      { code: error.code },
+    );
+  }
+
+  return new Error(`Configurator intent persistence RPC failed: ${text}`);
+}

package/src/commerce/server/configuratorIntentPersistenceHandler.ts

@@ -0,0 +1,54 @@
+import type { z } from "zod";
+import type { HttpRequest, HttpResponse } from "../../http/index.js";
+import type { BffResponder } from "../../bff/index.js";
+import type { ConfiguratorIntentPersistencePort } from "../contracts/index.js";
+
+export class ConfiguratorIntentPersistenceConflictError extends Error {
+  readonly details: Record<string, unknown>;
+
+  constructor(message = "Configurator intent idempotency conflict", details: Record<string, unknown> = {}) {
+    super(message);
+    this.name = "ConfiguratorIntentPersistenceConflictError";
+    this.details = details;
+  }
+}
+
+export function createConfiguratorIntentPersistenceHandler<Request, Response>({
+  persistencePort, responder, requestSchema, responseSchema,
+}: { persistencePort: ConfiguratorIntentPersistencePort<Request, Response>; responder: BffResponder; requestSchema: z.ZodType<Request>; responseSchema: z.ZodType<Response> }) {
+  const { sendBffError, sendBffSuccess, sendMethodNotAllowed } = responder;
+  return async function handler(req: HttpRequest, res: HttpResponse): Promise<void> {
+    if (req.method !== "POST") {
+      sendMethodNotAllowed(res, ["POST"]);
+      return;
+    }
+
+    const request = requestSchema.safeParse(req.body);
+    if (!request.success) {
+      sendBffError(res, "BAD_REQUEST", "Invalid configurator intent", {
+        details: request.error.flatten(),
+      });
+      return;
+    }
+
+    try {
+      const persisted = await persistencePort.persistIntent(request.data);
+      const response = responseSchema.safeParse(persisted);
+      if (!response.success) {
+        sendBffError(res, "INVALID_RESPONSE", "Configurator intent persistence returned invalid response");
+        return;
+      }
+
+      sendBffSuccess(res, response.data, {
+        contractVersion: "commerce.configurator_intent_persistence.v1",
+      });
+    } catch (error) {
+      if (error instanceof ConfiguratorIntentPersistenceConflictError) {
+        sendBffError(res, "CONFLICT", error.message, { details: error.details });
+        return;
+      }
+
+      sendBffError(res, "UPSTREAM_UNAVAILABLE", "Configurator intent persistence failed");
+    }
+  };
+}

package/src/commerce/server/emailRuntime.ts

@@ -0,0 +1,30 @@
+import type { ZodType } from "zod";
+import type { OutboxEventRow, OutboxHandler, OutboxHandlerOutcome } from "../outboxDispatchContracts.js";
+import type { OrderEmailTotals, OrderPaidRawData, TransactionalEmailSendOutcome } from "../outboxOrderDraftEmailPorts.js";
+import type { OrderEmailLinePresentation } from "../orderEmailLines.js";
+
+export interface TransactionalEmailHandlerSpec<Payload, Recipient> {
+  eventType: string;
+  timeoutMs: number;
+  templateSlug: string;
+  schema: ZodType<Payload>;
+  resolveKey(payload: Payload): string;
+  recipientPort: { resolve(key: string, signal: AbortSignal): Promise<Recipient | null> };
+  findExistingSend(templateSlug: string, outboxEventId: string): Promise<boolean>;
+  send(ctx: { row: OutboxEventRow; payload: Payload; recipient: Recipient; signal: AbortSignal }): Promise<TransactionalEmailSendOutcome>;
+}
+
+/** Host bindings to the communications owner and presentation/provider policy. */
+export interface CommerceEmailRuntime<Locale extends string = string> extends OrderEmailLinePresentation<Locale> {
+  parseOutboxPayload<Payload>(schema: ZodType<Payload>, payload: unknown):
+    { ok: true; data: Payload } | { ok: false; outcome: OutboxHandlerOutcome };
+  mapSendOutcome(outcome: TransactionalEmailSendOutcome): OutboxHandlerOutcome;
+  createTransactionalEmailHandler<Payload, Recipient>(spec: TransactionalEmailHandlerSpec<Payload, Recipient>): OutboxHandler;
+  resolveLocale(country: string | null | undefined): Locale;
+  /** null preserves ordinary totals and item prices; a presentation suppresses item prices. */
+  presentPaidOrder(data: OrderPaidRawData): OrderEmailTotals | null;
+  providerOwnsDeliveredNotification(providerKind: string): boolean;
+  normalizeCarrierKind(input: { carrierKind: string | null; service: string | null }): string | null;
+  carrierTrackingUrl(carrierKind: string | null, trackingNumber: string): string | null;
+  legacyTrackingUrl(ref: { providerKind: string | null; carrierKind: string | null; trackingNumber: string }, hasExplicitReferences: boolean): string | null;
+}

package/src/commerce/server/handlerSupport.ts

@@ -0,0 +1,22 @@
+import type { AdminCommerceOrdersListRequest,AdminCommerceOrdersListResponse } from "../oms/omsContracts.js";
+export interface OmsHandlerRequest { method?: string; query?: Record<string, unknown>; body?: unknown }
+export interface OmsHandlerResponder<Response> {
+  sendMethodNotAllowed(res: Response, methods: readonly string[]): void;
+  sendBffSuccess(res: Response, data: unknown): void;
+  sendBffError(res: Response, code: "UNAUTHORIZED" | "FORBIDDEN" | "BAD_REQUEST" | "INVALID_RESPONSE" | "NOT_FOUND" | "CONFLICT" | "UPSTREAM_UNAVAILABLE", message: string, options?: { details: unknown }): void;
+}
+export type OmsAdminAuthResult = { ok: false; code: "UNAUTHORIZED" | "FORBIDDEN"; message: string } | { ok: true; userId: string; isMachineActor?: boolean };
+export interface OmsReadGate {
+  blocked: boolean;
+  audit(customerIds: string[]): Promise<void>;
+  maskOrders<T extends { orders: AdminCommerceOrdersListResponse["orders"] }>(response: T): T;
+}
+export interface OmsHandlerDeps<Response> {
+  authorizeAdmin(req: OmsHandlerRequest): Promise<OmsAdminAuthResult>;
+  respond: OmsHandlerResponder<Response>;
+  listRequestSchema?: { safeParse(value: unknown): { success: true; data: AdminCommerceOrdersListRequest } | { success: false; error: { flatten(): unknown } } };
+  listResponseSchema?: { safeParse(value: unknown): { success: true; data: AdminCommerceOrdersListResponse } | { success: false } };
+  detailResponseSchema?: { safeParse(value: unknown): { success: true; data: import("../oms/omsContracts.js").AdminCommerceOrderDetailResponse } | { success: false } };
+  readGate?(input: { authorization: Extract<OmsAdminAuthResult, { ok: true }>; view: "list" | "detail"; query: Record<string, unknown> }): OmsReadGate;
+}
+export const unprojectedOmsReadGate: OmsReadGate = { blocked: false, audit: async () => {}, maskOrders: response => response };

package/src/commerce/server/index.ts

@@ -0,0 +1,181 @@
+/**
+ * Node-only commerce entry for server handlers, use cases, stores and adapters.
+ * Node builtins, database clients, HTTP/storage operations and engine composition
+ * belong here; commerce remains for browser-safe schemas, pure helpers and ports,
+ * while commerce/contracts stays type-only.
+ */
+export { buildOmsOrderDetailResponse } from "../model/omsReadModel.js";
+export { createAdminCommerceOrderCancelHandler } from "./commerceOmsCancelOrderHandler.js";
+export { createAdminCommerceOrdersListHandler, createAdminCommerceOrderDetailHandler, createAdminCommerceOrderHoldHandler, createAdminCommerceOrderReleaseHoldHandler, createAdminCommerceOrderNoteHandler, createAdminCommerceOrderUpdateShippingAddressHandler, authorize, parseOmsRequest, sendOmsMutationResponse } from "./commerceOmsHandlers.js";
+export type { AdminAuthResult, BaseDeps } from "./commerceOmsHandlers.js";
+export { createAdminCommerceOrderMarkRefundedHandler } from "./commerceOmsMarkRefundedHandler.js";
+export { createCommerceOmsControlPlaneListHandler, createCommerceOmsControlPlaneDetailHandler } from "./commerceOmsControlPlaneHandlers.js";
+export { createManagedCommerceOmsPort, mapReplacementRefusal } from "../adapters/managed/commerceOmsPort.js";
+export type { CommerceOmsRpcClient } from "../adapters/managed/commerceOmsPort.js";
+export { addCommerceOmsNote, updateCommerceOmsShippingAddress, callOmsRpc, mapRpcError } from "../adapters/managed/commerceOmsMutations.js";
+export { createManagedCommerceOmsControlPlanePort } from "../adapters/managed/commerceOmsControlPlane.js";
+export { readAccountingOutbox } from "../adapters/managed/oms/accounting.js";
+export { readOmsInboundEvents } from "../adapters/managed/oms/inboundEvents.js";
+export { readOrderPaidOutboxEvents } from "../adapters/managed/oms/outboxEvents.js";
+export { readActivePaymentAttempts } from "../adapters/managed/oms/paymentAttempts.js";
+export { readQueueSelection } from "../adapters/managed/oms/queueSelection.js";
+export type { QueueSelection } from "../adapters/managed/oms/queueSelection.js";
+export { distinctIds } from "../adapters/managed/oms/types.js";
+export type { CommerceOmsStore, ManagedQueryBuilder, ManagedQueryResult, RpcError } from "../adapters/managed/oms/types.js";
+export { readShipmentRefsByOrderIds, readShipmentRefsByOrderId, isOptionalProviderEvidenceColumnError, readFulfillmentParcelsByOrderId, readFulfillmentOrdersByOrderIds } from "../adapters/managed/oms/fulfillmentReads.js";
+export { listCommerceOmsOrders, getCommerceOmsOrderDetail, getCommerceOmsOrderDetails } from "../adapters/managed/oms/readQueries.js";
+export { unprojectedOmsReadGate } from "./handlerSupport.js";
+export type { OmsHandlerRequest, OmsHandlerResponder, OmsAdminAuthResult, OmsReadGate, OmsHandlerDeps } from "./handlerSupport.js";
+export { emptyOmsManagedReadProjections } from "../adapters/managed/oms/readProjections.js";
+export type { OmsManagedReadProjections } from "../adapters/managed/oms/readProjections.js";
+export { createCustomerReturnRequestHandler, createAdminReturnApproveHandler, createAdminReturnRejectHandler } from "./commerceReturnsHandlers.js";
+export { createOrderReviewHandlers } from "./orderReviewHandlers.js";
+export { createOrderReviewAdminHandlers } from "./orderReviewAdminHandlers.js";
+export { createOrderReviewRawUploadHandler, inspectImageHeader } from "./orderReviewRawUploadHandler.js";
+export type { OrderReviewMediaMime, OrderReviewRawUploadSession, OrderReviewRawUploadBinding, OrderReviewRawUploadResult, OrderReviewRawUploadBindingState } from "./orderReviewRawUploadHandler.js";
+export { createPostgresOrderReviewLifecyclePort, createPostgresOrderReviewAdminReadPort } from "./orderReviewLifecycle.js";
+export { createPostgresOrderReviewMediaPort } from "./orderReviewMedia.js";
+export type { OrderReviewMediaTransactionLane } from "./orderReviewMedia.js";
+export { createSupabaseCommerceReturnsPort } from "./supabaseCommerceReturnsPort.js";
+export type { CommerceReturnsRpcClient } from "./supabaseCommerceReturnsPort.js";
+export { createSupabaseOrderFeedbackSubmitPort } from "./orderFeedbackSubmit.js";
+export type { OrderFeedbackSubmitRpcClient, OrderFeedbackSubmitPort } from "./orderFeedbackSubmit.js";
+export { createSupabaseOrderFeedbackTokenCheckPort } from "./orderFeedbackTokenCheck.js";
+export type { OrderFeedbackTokenCheckRpcClient } from "./orderFeedbackTokenCheck.js";
+
+/** Node-only commerce effect consumers. Hosts bind runtime and presentation ports. */
+export * from "./emailRuntime.js";
+export * from "./outboxDispatchRegistry.js";
+export * from "./outboxDispatchRegistryComposition.js";
+export * from "./outboxCheckoutExpiredEmailHandler.js";
+export * from "./outboxCheckoutRecoveryEmailHandler.js";
+export * from "./outboxOrderDraftEmailHandler.js";
+export * from "./outboxOrderPaidEmailHandler.js";
+export * from "./outboxOrderPaidFulfillmentHandler.js";
+export * from "./outboxOrderPaidFulfillmentPorts.js";
+export * from "./outboxOrderRefundedEmailHandler.js";
+export * from "./outboxPaymentFailedEmailHandler.js";
+export * from "./outboxReturnEmailHandlers.js";
+export * from "./outboxShipmentDeliveredEmailHandler.js";
+export * from "./outboxShipmentDispatchedEmailHandler.js";
+export * from "./outboxShipmentExceptionEmailHandler.js";
+
+/** @consumer server/domains/commerce/commerceCheckoutCompensation.ts */
+export { tryCompensate } from "./commerceCheckoutCompensation.js";
+/** @consumer server/domains/commerce/commerceCheckoutCompensation.ts */
+export type { CheckoutCompensationPort } from "./commerceCheckoutCompensation.js";
+/** @consumer server/domains/commerce/commerceCheckoutOrchestrationError.ts */
+export { CheckoutOrchestrationError } from "./commerceCheckoutOrchestrationError.js";
+/** @consumer server/domains/commerce/checkoutConflictClassifiers.ts */
+export { isStockUnavailableCheckoutConflict, isProviderAttemptInFlightCheckoutConflict, isJourneyConsumedCheckoutConflict, START_RUNTIME_SIMPLE_CONFLICTS } from "./checkoutConflictClassifiers.js";
+/** @consumer server/domains/commerce/commerceDiagnostics.ts */
+export { safeCommerceDiagnosticValue, checkoutOrchestrationFailureDetails } from "./commerceDiagnostics.js";
+/** @consumer server/domains/commerce/checkoutPaymentContinuationCredential.ts */
+export { mintPaymentContinuationOnFreshAction, createCheckoutPaymentContinuationCodec } from "./checkoutPaymentContinuationCredential.js";
+/** @consumer server/domains/commerce/checkoutPaymentContinuationCredential.ts */
+export type { CheckoutPaymentContinuationInput, CheckoutPaymentContinuationClaims, CheckoutPaymentContinuationCodec, CheckoutPaymentContinuationMinter, CheckoutCookieResponse } from "./checkoutPaymentContinuationCredential.js";
+/** @consumer server/domains/commerce/checkoutRefusalContinuation.ts */
+export { mintCheckoutRefusalContinuation } from "./checkoutRefusalContinuation.js";
+/** @consumer server/domains/commerce/commerceCheckoutProviderPayment.ts */
+export { createCheckoutClientAction, providerPayerFromRequest } from "./commerceCheckoutProviderPayment.js";
+/** @consumer server/domains/commerce/checkoutOfferPolicyPort.ts */
+export { CHECKOUT_OFFER_VERSION_UNSUPPORTED, CheckoutOfferRefusedError, resolveCheckoutOffer, withCheckoutOfferContext } from "./checkoutOfferPolicyPort.js";
+/** @consumer server/domains/commerce/checkoutOfferPolicyPort.ts */
+export type { CheckoutOfferPolicyPort, CheckoutOfferBinding } from "./checkoutOfferPolicyPort.js";
+/** @consumer server/domains/commerce/commerceCheckoutCustomerDefaults.ts */
+export { readCheckoutCustomerDefaults, readCheckoutCustomerDefaultsOrRespond } from "./commerceCheckoutCustomerDefaults.js";
+/** @consumer server/domains/commerce/commerceCheckoutTiming.ts */
+export { createCheckoutTimingLogger } from "./commerceCheckoutTiming.js";
+/** @consumer server/domains/commerce/commerceCheckoutTiming.ts */
+export type { CheckoutTimingStage, CheckoutTimingOutcome, CheckoutStage, CheckoutStageRecorder } from "./commerceCheckoutTiming.js";
+/** @consumer server/domains/commerce/checkoutInvoiceBuyerSnapshot.ts */
+export { buildCheckoutInvoiceBuyerSnapshot } from "./checkoutInvoiceBuyerSnapshot.js";
+/** @consumer server/domains/commerce/commerceCheckoutSavedPaymentMethod.ts */
+export { createCheckoutSavedPaymentMethodResolver } from "./commerceCheckoutSavedPaymentMethod.js";
+/** @consumer server/domains/commerce/commerceCheckoutSavedPaymentMethod.ts */
+export type { ResolveSavedMethodResult } from "./commerceCheckoutSavedPaymentMethod.js";
+/** @consumer server/domains/commerce/commerceStarterOfferGuard.ts */
+export { createStarterOfferGuard, withStarterPackContext } from "./commerceStarterOfferGuard.js";
+/** @consumer server/domains/commerce/commerceStarterOfferGuard.ts */
+export type { StarterOfferGuardResult } from "./commerceStarterOfferGuard.js";
+/** @consumer src/domains/commerce/starterTermsPort.ts */
+export type { StarterTermsPort, StarterTermsDecision, StarterTermsResolution, StarterTermsRefusal } from "./starterTermsPort.js";
+/** @consumer server/domains/commerce/commerceCheckoutQuoteGuard.ts */
+export { createCheckoutQuoteGuard } from "./commerceCheckoutQuoteGuard.js";
+/** @consumer server/domains/commerce/commerceCheckoutQuoteGuard.ts */
+export type { CheckoutQuoteGuardResult } from "./commerceCheckoutQuoteGuard.js";
+/** @consumer server/domains/commerce/commerceCheckoutResumeGuard.ts */
+export { createCheckoutResumeGuard, selectedDeliveryMatches, subscriptionResponse } from "./commerceCheckoutResumeGuard.js";
+/** @consumer server/domains/commerce/commerceCheckoutResumeGuard.ts */
+export type { CheckoutResumeGuardDeps, QuoteLikeSnapshot } from "./commerceCheckoutResumeGuard.js";
+/** @consumer server/domains/commerce/commerceCheckoutContinuationTerms.ts */
+export { createSavedAcquisitionContinuation } from "./commerceCheckoutContinuationTerms.js";
+/** @consumer server/domains/commerce/commerceProviderAttemptFailure.ts */
+export { createCheckoutProviderAttemptFailure } from "./commerceProviderAttemptFailure.js";
+/** @consumer server/domains/commerce/commerceCheckoutStartRuntimeFailure.ts */
+export { createCheckoutStartRuntimeFailure } from "./commerceCheckoutStartRuntimeFailure.js";
+/** @consumer server/domains/commerce/commerceRuntimeStartResponse.ts */
+export { createRuntimeStartResponse } from "./commerceRuntimeStartResponse.js";
+/** @consumer server/domains/commerce/commerceRuntimeService.ts */
+export { createCommerceRuntimeService } from "./commerceRuntimeService.js";
+/** @consumer server/domains/commerce/commercePaidOrderOrchestration.ts */
+export { createPaidOrderOrchestration } from "./commercePaidOrderOrchestration.js";
+/** @consumer server/domains/commerce/commercePaidOrderOrchestration.ts */
+export type { OrchestratedCheckoutResult, CheckoutPaymentStartedEvent } from "./commercePaidOrderOrchestration.js";
+/** @consumer server/domains/commerce/commerceCheckoutCommandExecution.ts */
+export { createCheckoutCommandExecutor, checkoutCommandJourney } from "./commerceCheckoutCommandExecution.js";
+/** @consumer server/domains/commerce/configuratorIntentPersistenceHandler.ts */
+export { createConfiguratorIntentPersistenceHandler, ConfiguratorIntentPersistenceConflictError } from "./configuratorIntentPersistenceHandler.js";
+/** @consumer server/domains/commerce/referenceCheckoutHandler.ts */
+export { createReferenceCheckoutHandler } from "./referenceCheckoutHandler.js";
+/** @consumer server/domains/commerce/commerceCheckoutHandlerHelpers.ts */
+export { createCheckoutHandlerHelpers, runBestEffortAccountLink } from "./commerceCheckoutHandlerHelpers.js";
+/** @consumer server/domains/commerce/commerceCheckoutHandlerAdmission.ts */
+export { createCheckoutAdmission } from "./commerceCheckoutHandlerAdmission.js";
+/** @consumer server/domains/commerce/commerceCheckoutPromotionPriceChange.ts */
+export { createPromotionPriceChange } from "./commerceCheckoutPromotionPriceChange.js";
+/** @consumer server/domains/commerce/commerceCheckoutFailureHandler.ts */
+export { createCheckoutFailureHandler } from "./commerceCheckoutFailureHandler.js";
+/** @consumer server/domains/commerce/commerceCheckoutHandler.ts */
+export { createCommerceCheckoutHandler } from "./commerceCheckoutHandler.js";
+/** @consumer server/domains/commerce/orderDraftRpcPayload.ts */
+export { ORDER_DRAFT_RPC_NAME, createOrderDraftRpcPayload } from "./orderDraftRpcPayload.js";
+/** @consumer Reference order-draft store binding. */
+export { createCommerceOrderDraftRpcPort, ORDER_DRAFT_SUPERSEDE_RPC_NAME } from "./commerceOrderDraft.js";
+/** @consumer Reference order-draft store binding. */
+export type { CommerceOrderDraftRpcClient } from "./commerceOrderDraft.js";
+/** @consumer server/adapters/managed/commerce/commerceRuntimePort.ts */
+export { createManagedCommerceRuntimeOrderPort, mapRpcError as mapCommerceFinalizeRpcError } from "./commerceRuntimePort.js";
+/** @consumer server/adapters/managed/commerce/commerceRuntimePort.ts */
+export type { ManagedCommerceRuntimeClient } from "./commerceRuntimePort.js";
+/** @consumer server/adapters/managed/commerce/reservationSweepPort.ts */
+export { createManagedReservationSweepPort } from "./reservationSweepPort.js";
+/** @consumer server/adapters/managed/commerce/reservationSweepPort.ts */
+export type { ReservationSweepCounts, ReservationSweepRpcClient, RetryHoldSweepCounts } from "./reservationSweepPort.js";
+/** @consumer Reference checkout compensation binding. */
+export { createCheckoutCompensationRpcAdapter, cancelAbandonedCheckout, cancelUnstartedPromotionCheckout } from "./checkoutCompensation.js";
+/** @consumer Reference checkout compensation binding. */
+export type { CompensationRpcClient } from "./checkoutCompensation.js";
+/** @consumer server/domains/commerce/checkoutRecoveryToken.ts */
+export { hashCheckoutRecoveryToken, generateCheckoutRecoveryToken, CHECKOUT_RECOVERY_TOKEN_PREFIX, classifyCheckoutRecoveryTokenState } from "./checkoutRecoveryToken.js";
+/** @consumer server/domains/commerce/checkoutRecoveryToken.ts */
+export type { CheckoutRecoveryTokenContext, CheckoutRecoveryTokenInspection, CheckoutRecoveryTokenPort } from "./checkoutRecoveryToken.js";
+/** @consumer server/domains/commerce/checkoutRecoveryOrderPort.ts */
+export type { CheckoutRecoveryOrderSnapshot, CheckoutRecoveryOrderReadPort, CheckoutRecoveryPriorPaymentEvidence } from "./checkoutRecoveryOrderPort.js";
+/** @consumer server/domains/commerce/checkoutExpiredRecoveryPolicy.ts */
+export { createExpiredCheckoutRecoveryPolicy, EXPIRED_CHECKOUT_RECOVERY_WINDOW_MS, quotesMatchForRecovery } from "./checkoutExpiredRecoveryPolicy.js";
+/** @consumer server/domains/commerce/checkoutExpiredRecoveryPolicy.ts */
+export type { ExpiredRecoveryEligibility } from "./checkoutExpiredRecoveryPolicy.js";
+/** @consumer Reference checkout resume store binding. */
+export { createCommerceCheckoutResumeQueryPort } from "./commerceCheckoutResume.js";
+/** @consumer Reference checkout resume store binding. */
+export type { CommerceCheckoutResumeClient } from "./commerceCheckoutResume.js";
+/** @consumer Reference configurator intent persistence binding. */
+export { createConfiguratorIntentPersistenceRpcPort } from "./configuratorIntentPersistence.js";
+/** @consumer Reference configurator intent persistence binding. */
+export type { ConfiguratorIntentRpcQueryClient, ConfiguratorIntentPersistenceIdentity } from "./configuratorIntentPersistence.js";
+
+/** @consumer Reference physical-stock availability binding. */
+export { createOfferAvailabilityPort } from "./offerAvailability.js";
+/** @consumer Reference physical-stock availability binding. */
+export type { OfferAvailabilityQueryClient } from "./offerAvailability.js";