@openlup/platform 0.25.0 → 0.27.0

package/dist/commerce/server/emailRuntime.d.ts

@@ -0,0 +1,47 @@
+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/dist/commerce/server/emailRuntime.js

@@ -0,0 +1 @@
+export {};

package/dist/commerce/server/handlerSupport.d.ts

@@ -0,0 +1,68 @@
+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 declare const unprojectedOmsReadGate: OmsReadGate;

package/dist/commerce/server/handlerSupport.js

@@ -0,0 +1 @@
+export const unprojectedOmsReadGate = { blocked: false, audit: async () => { }, maskOrders: response => response };

package/dist/commerce/server/index.d.ts

@@ -0,0 +1,178 @@
+/**
+ * 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";

package/dist/commerce/server/index.js

@@ -0,0 +1,127 @@
+/**
+ * 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 { createAdminCommerceOrderMarkRefundedHandler } from "./commerceOmsMarkRefundedHandler.js";
+export { createCommerceOmsControlPlaneListHandler, createCommerceOmsControlPlaneDetailHandler } from "./commerceOmsControlPlaneHandlers.js";
+export { createManagedCommerceOmsPort, mapReplacementRefusal } 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 { distinctIds } 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 { emptyOmsManagedReadProjections } 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 { createPostgresOrderReviewLifecyclePort, createPostgresOrderReviewAdminReadPort } from "./orderReviewLifecycle.js";
+export { createPostgresOrderReviewMediaPort } from "./orderReviewMedia.js";
+export { createSupabaseCommerceReturnsPort } from "./supabaseCommerceReturnsPort.js";
+export { createSupabaseOrderFeedbackSubmitPort } from "./orderFeedbackSubmit.js";
+export { createSupabaseOrderFeedbackTokenCheckPort } 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/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/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/commerceCheckoutCustomerDefaults.ts */
+export { readCheckoutCustomerDefaults, readCheckoutCustomerDefaultsOrRespond } from "./commerceCheckoutCustomerDefaults.js";
+/** @consumer server/domains/commerce/commerceCheckoutTiming.ts */
+export { createCheckoutTimingLogger } 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/commerceStarterOfferGuard.ts */
+export { createStarterOfferGuard, withStarterPackContext } from "./commerceStarterOfferGuard.js";
+/** @consumer server/domains/commerce/commerceCheckoutQuoteGuard.ts */
+export { createCheckoutQuoteGuard } from "./commerceCheckoutQuoteGuard.js";
+/** @consumer server/domains/commerce/commerceCheckoutResumeGuard.ts */
+export { createCheckoutResumeGuard, selectedDeliveryMatches, subscriptionResponse } 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/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 server/adapters/managed/commerce/commerceRuntimePort.ts */
+export { createManagedCommerceRuntimeOrderPort, mapRpcError as mapCommerceFinalizeRpcError } from "./commerceRuntimePort.js";
+/** @consumer server/adapters/managed/commerce/reservationSweepPort.ts */
+export { createManagedReservationSweepPort } from "./reservationSweepPort.js";
+/** @consumer Reference checkout compensation binding. */
+export { createCheckoutCompensationRpcAdapter, cancelAbandonedCheckout, cancelUnstartedPromotionCheckout } from "./checkoutCompensation.js";
+/** @consumer server/domains/commerce/checkoutRecoveryToken.ts */
+export { hashCheckoutRecoveryToken, generateCheckoutRecoveryToken, CHECKOUT_RECOVERY_TOKEN_PREFIX, classifyCheckoutRecoveryTokenState } from "./checkoutRecoveryToken.js";
+/** @consumer server/domains/commerce/checkoutExpiredRecoveryPolicy.ts */
+export { createExpiredCheckoutRecoveryPolicy, EXPIRED_CHECKOUT_RECOVERY_WINDOW_MS, quotesMatchForRecovery } from "./checkoutExpiredRecoveryPolicy.js";
+/** @consumer Reference checkout resume store binding. */
+export { createCommerceCheckoutResumeQueryPort } from "./commerceCheckoutResume.js";
+/** @consumer Reference configurator intent persistence binding. */
+export { createConfiguratorIntentPersistenceRpcPort } from "./configuratorIntentPersistence.js";
+/** @consumer Reference physical-stock availability binding. */
+export { createOfferAvailabilityPort } from "./offerAvailability.js";

package/dist/commerce/server/offerAvailability.d.ts

@@ -0,0 +1,21 @@
+import type { CommerceOfferAvailabilityPort } from "../contracts/availability.js";
+export interface OfferAvailabilityQueryClient {
+    from(table: string): OfferAvailabilityQueryBuilder;
+}
+interface OfferAvailabilityQueryBuilder extends PromiseLike<OfferAvailabilityQueryResult> {
+    select(columns: string, options?: Record<string, unknown>): OfferAvailabilityQueryBuilder;
+    in(column: string, values: unknown[]): PromiseLike<OfferAvailabilityQueryResult>;
+}
+interface OfferAvailabilityQueryResult {
+    data: unknown;
+    error: {
+        code?: string;
+        message?: string;
+    } | null;
+}
+export declare function createOfferAvailabilityPort(client: OfferAvailabilityQueryClient, options: {
+    isStockProvider: (providerKind: string) => boolean;
+    lowStockThreshold?: number;
+    now?: () => Date;
+}): CommerceOfferAvailabilityPort;
+export {};

package/dist/commerce/server/offerAvailability.js

@@ -0,0 +1,163 @@
+import { DEFAULT_LOW_STOCK_THRESHOLD, deriveOfferAvailability, } from "../offerAvailability.js";
+// Orders in a terminal, non-committed state must NOT hold stock. A cancelled
+// order historically stranded its `reserved` rows (no release path fired), so
+// even with the release-on-cancel trigger in place we defensively exclude these
+// here — legacy stranded rows can never depress sellableNow. Paid /
+// fulfillment_pending / pending_payment reservations stay counted: that stock is
+// legitimately committed.
+const TERMINAL_ORDER_STATUSES = new Set([
+    "cancelled",
+    "failed",
+    "expired",
+]);
+export function createOfferAvailabilityPort(client, options) {
+    const lowStockThreshold = options.lowStockThreshold ?? DEFAULT_LOW_STOCK_THRESHOLD;
+    const now = options.now ?? (() => new Date());
+    return {
+        async getAvailability({ items }) {
+            if (items.length === 0)
+                return [];
+            const skus = [...new Set(items.map((item) => item.sku))];
+            const [providerResult, balanceResult, reservationResult] = await Promise.all([
+                client
+                    .from("fulfillment_provider_stock_current")
+                    .select("sku, provider_kind, provider_for_sale_quantity, last_synced_at, stale_after")
+                    .in("sku", skus),
+                client
+                    .from("inventory_balances")
+                    .select("on_hand, unavailable, safety_stock, catalog_skus!inventory_balances_sku_id_fkey!inner(sku), inventory_locations!inventory_balances_location_id_fkey!inner(status, fulfillable), inventory_lots!inventory_balances_lot_id_fkey(status, expires_at)")
+                    .in("catalog_skus.sku", skus),
+                client
+                    .from("inventory_reservations")
+                    .select("quantity, status, expires_at, catalog_skus!inventory_reservations_sku_id_fkey!inner(sku), commerce_orders!inventory_reservations_order_id_fkey!inner(status)")
+                    .in("catalog_skus.sku", skus),
+            ]);
+            if (providerResult.error || balanceResult.error || reservationResult.error) {
+                return items.map((item) => unknownAvailability(item, "inventory_read_failed"));
+            }
+            const requestedAt = now();
+            const activeReservedBySku = sumActiveReservedBySku((reservationResult.data ?? []), requestedAt);
+            const safetyStockBySku = sumSafetyStockBySku((balanceResult.data ?? []), requestedAt);
+            const providerBySku = providerStockBySku((providerResult.data ?? []), options.isStockProvider);
+            if (providerBySku.size > 0) {
+                return items.map((item) => providerAvailability({
+                    item,
+                    provider: providerBySku.get(item.sku) ?? null,
+                    activeReserved: activeReservedBySku.get(item.sku) ?? 0,
+                    safetyStock: safetyStockBySku.get(item.sku) ?? 0,
+                    requestedAt,
+                    lowStockThreshold,
+                }));
+            }
+            const localBaseBySku = sumLocalAvailableBaseBySku((balanceResult.data ?? []), requestedAt);
+            return items.map((item) => {
+                const sellableNow = localBaseBySku.has(item.sku)
+                    ? Math.max(0, (localBaseBySku.get(item.sku) ?? 0) - (activeReservedBySku.get(item.sku) ?? 0))
+                    : null;
+                return deriveOfferAvailability({
+                    ...item,
+                    sellableNow,
+                    lowStockThreshold,
+                    source: "inventory",
+                });
+            });
+        },
+    };
+}
+function providerStockBySku(rows, isStockProvider) {
+    return new Map(rows
+        .filter((row) => isStockProvider(row.provider_kind) && row.sku)
+        .map((row) => [row.sku, row]));
+}
+function providerAvailability(input) {
+    if (!input.provider) {
+        return unavailable(input.item, "provider_stock_missing");
+    }
+    if (Date.parse(input.provider.stale_after) <= input.requestedAt.getTime()) {
+        return unavailable(input.item, "provider_stock_stale");
+    }
+    return deriveOfferAvailability({
+        ...input.item,
+        sellableNow: Math.max(0, input.provider.provider_for_sale_quantity - input.activeReserved - input.safetyStock),
+        lowStockThreshold: input.lowStockThreshold,
+        source: "inventory_provider",
+    });
+}
+function sumActiveReservedBySku(rows, requestedAt) {
+    const result = new Map();
+    for (const row of rows) {
+        const sku = row.catalog_skus?.sku;
+        if (!sku || !reservationBlocksStock(row, requestedAt))
+            continue;
+        result.set(sku, (result.get(sku) ?? 0) + row.quantity);
+    }
+    return result;
+}
+function sumSafetyStockBySku(rows, requestedAt) {
+    const result = new Map();
+    for (const row of rows) {
+        const sku = row.catalog_skus?.sku;
+        if (!sku || !balanceUsable(row, requestedAt))
+            continue;
+        result.set(sku, (result.get(sku) ?? 0) + row.safety_stock);
+    }
+    return result;
+}
+function sumLocalAvailableBaseBySku(rows, requestedAt) {
+    const result = new Map();
+    for (const row of rows) {
+        const sku = row.catalog_skus?.sku;
+        if (!sku || !balanceUsable(row, requestedAt))
+            continue;
+        result.set(sku, (result.get(sku) ?? 0) + Math.max(0, row.on_hand - row.unavailable - row.safety_stock));
+    }
+    return result;
+}
+function balanceUsable(row, requestedAt) {
+    const location = row.inventory_locations;
+    if (location?.status !== "active" || location.fulfillable !== true)
+        return false;
+    const lotStatus = row.inventory_lots?.status;
+    if (lotStatus && lotStatus !== "available")
+        return false;
+    const expiresAt = row.inventory_lots?.expires_at;
+    if (expiresAt && Date.parse(expiresAt) <= requestedAt.getTime())
+        return false;
+    return true;
+}
+function reservationBlocksStock(row, requestedAt) {
+    if (row.status !== "reserved")
+        return false;
+    // A reserved row tied to a terminal (cancelled/failed/expired) order is a
+    // stranded hold — do not let it depress sellableNow.
+    const orderStatus = row.commerce_orders?.status;
+    if (orderStatus && TERMINAL_ORDER_STATUSES.has(orderStatus))
+        return false;
+    if (!row.expires_at)
+        return true;
+    return Date.parse(row.expires_at) > requestedAt.getTime();
+}
+function unavailable(item, reasonCode) {
+    return {
+        sku: item.sku,
+        productSlug: item.productSlug,
+        variantId: item.variantId,
+        status: "out_of_stock",
+        visibleInConfigurator: false,
+        sellableNow: 0,
+        reasonCode,
+        source: "inventory_provider",
+    };
+}
+function unknownAvailability(item, reasonCode) {
+    return {
+        sku: item.sku,
+        productSlug: item.productSlug,
+        variantId: item.variantId,
+        status: "unknown",
+        visibleInConfigurator: true,
+        sellableNow: null,
+        reasonCode,
+        source: "inventory",
+    };
+}

package/dist/commerce/server/orderDraftRpcPayload.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare const ORDER_DRAFT_RPC_NAME = "commerce_create_order_draft_with_outbox";
+type OrderDraftRpcSchema<Quote extends z.ZodType, Draft extends z.ZodType> = z.ZodObject<{
+    p_idempotency_key: z.ZodString;
+    p_quote_snapshot: Quote;
+    p_order_draft_snapshot: Draft;
+    p_client_id: z.ZodOptional<z.ZodGUID>;
+}, z.core.$strict>;
+export declare function createOrderDraftRpcPayload<Quote extends z.ZodType, Draft extends z.ZodType>(input: {
+    quoteSchema: Quote;
+    draftSchema: Draft;
+    createSnapshot(quote: z.output<Quote>): z.input<Draft>;
+}): {
+    orderDraftRpcArgsSchema: OrderDraftRpcSchema<Quote, Draft>;
+    createOrderDraftRpcArgs: (request: {
+        idempotencyKey: string;
+        quoteSnapshot: z.output<Quote>;
+    }, clientId?: string | null) => z.output<OrderDraftRpcSchema<Quote, Draft>>;
+};
+export {};