@openlup/platform 0.27.0 → 0.29.0

package/src/account-support/contracts/account.ts

@@ -0,0 +1,306 @@
+/** Host-verified selection; never an authorization claim from a request body. */
+export interface CustomerContext { principalId: string; clientId: string; graph: "managed" | "native" }
+export type AccountReadRefusal = "FORBIDDEN" | "NOT_FOUND" | "UPSTREAM_UNAVAILABLE" | "INVALID_RESPONSE";
+/** Owner DTOs stay host supplied, including private profile and market fields.
+ * Null and thrown failures retain their existing host mappings. No cursor is promised.
+ */
+export interface AccountReadPort<Account, OrderList, OrderDetail> {
+  getAccount(userId: string): Promise<Account | null>;
+  listOrders(userId: string, input: { limit: number }): Promise<OrderList | null>;
+  getOrderDetail(userId: string, orderId: string): Promise<OrderDetail | null>;
+}
+
+import type { AccountSupportMoney, SubscriptionPaymentMethodStatus } from "./commands.js";
+import type { CustomerDocumentDeliveryStatus } from "./invoice.js";
+
+export interface AccountProfile {
+  clientId: string;
+  email: string;
+  firstName: string | null;
+  lastName: string | null;
+  phone: string | null;
+  lifecycleStage: "lead" | "tester" | "customer" | "inactive"
+}
+
+export interface AccountAddress {
+  addressId: string;
+  kind: "shipping" | "billing" | "both";
+  label: string | null;
+  recipientName: string | null;
+  contactPhone: string | null;
+  companyName: string | null;
+  taxId: string | null;
+  line1: string;
+  line2: string | null;
+  city: string;
+  postalCode: string;
+  country: string;
+  isDefault: boolean;
+  deliveryNotes: string | null;
+  courierInstructions: string | null;
+  lastUsedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface AccountBillingProfile {
+  profileId: string;
+  label: string | null;
+  fullName: string;
+  email: string;
+  phone: string | null;
+  companyName: string | null;
+  taxId: string | null;
+  companyVerificationLevel?: "registry_verified" | "provider_verified" | "manual_unverified" | "invalid" | null;
+  companyIdentitySource?: string | null;
+  companyIdentityEvidenceHash?: string | null;
+  isDefault: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+
+/** Method/provider vocabulary is supplied by the selected host, never a platform provider list. */
+export interface AccountPaymentPreference<Method extends string = string> {
+  scope: "one_time" | "subscription" | "any";
+  methodKind: Method;
+  lastSelectedAt: string
+}
+
+export interface AccountPickupPoint {
+  id: string;
+  name: string;
+  address: { line1: string; postalCode: string; city: string; country: string } | null
+}
+
+export interface AccountDeliverySelection {
+  deliveryKind: "courier" | "parcel-locker";
+  providerKind: string | null;
+  carrierKind: string | null;
+  carrierCode: string | null;
+  serviceCode: string | null;
+  pickupPoint: AccountPickupPoint | null;
+}
+
+export interface AccountDeliveryPreference<Provider extends string = string> extends AccountDeliverySelection {
+  scope: "one_time" | "subscription" | "any";
+  providerKind: Provider;
+  carrierKind: string;
+  carrierCode: string;
+  serviceCode: string;
+  lastSelectedAt: string;
+}
+
+export interface AccountEvent {
+  eventId: string;
+  eventType: string;
+  entityType: string;
+  entityId: string | null;
+  occurredAt: string
+}
+
+export interface AccountSubscriptionLine {
+  lineId: string;
+  variantId: string;
+  qty: number;
+  sortOrder: number;
+  isAddon: boolean;
+  title: string | null;
+  sku: string | null;
+  productSlug?: string | null;
+  displayLabel?: string | null;
+  accentColor?: string | null;
+  unitPrice?: AccountSupportMoney | null;
+  lineSubtotal?: AccountSupportMoney | null;
+}
+
+export interface AccountSubscription {
+  subscriptionId: string;
+  shippingAddressId: string | null;
+  status: "pending_activation" | "active" | "paused" | "cancelled" | "activation_failed" | "completed";
+  pausePreset: "2_weeks" | "1_month" | "indefinite" | null;
+  pauseStartedAt: string | null;
+  pauseEndsAt: string | null;
+  cadenceDays: number;
+  nextCycleAt: string | null;
+  deliveryAlignment?: { state: "protected" | "aligned" };
+  editCutoffAt: string | null;
+  canEditUpcomingPackage: boolean;
+  editBlockedReason: "not_active" | "edit_window_closed" | "cycle_locked" | "payment_blocked" | "missing_payment_method" | null;
+  paymentMethodKind: string | null;
+  paymentMethodStatus?: SubscriptionPaymentMethodStatus;
+  templateVersion: number;
+  sizeConstraint: Record<string, unknown> | null;
+  packageSummary: string | null;
+  recurringPrice: {
+    subtotalGross: AccountSupportMoney;
+    totalGross: AccountSupportMoney;
+    currency: string;
+    source: "frozen_quote_line" | "missing"
+  }
+  | null;
+  nextCharge?: { totalGross: AccountSupportMoney; starterStage: "delivery2" | "graduation" | null } | null;
+  lines: AccountSubscriptionLine[];
+}
+
+export interface AccountTrackingReference {
+  providerKind: string;
+  trackingNumber: string;
+  trackingUrl: string | null;
+  carrierKind: string | null;
+  service: string | null;
+  updatedAt: string | null
+}
+
+export interface AccountTrackingEvent {
+  eventType: string;
+  label: string;
+  occurredAt: string | null;
+  source: "webhook" | "reconciliation" | "manual" | "simulator" | "fulfillment"
+}
+
+export interface AccountInvoiceSummary {
+  invoiceId: string;
+  orderId: string;
+  invoiceRef: string;
+  status: string;
+  providerInvoiceNumber: string | null;
+  ksefNumber: string | null;
+  ksefStatus: string;
+  documentDeliveryStatus: CustomerDocumentDeliveryStatus;
+  totalGross: AccountSupportMoney;
+  issuedAt: string | null;
+  downloadAvailable: boolean;
+  downloadUrl: string | null;
+  createdAt: string;
+}
+
+export interface AccountInvoiceDocument extends Omit<AccountInvoiceSummary, "totalGross"> {
+  documentKey: string;
+  role: "original" | "correction" | "replacement";
+  artifact: "invoice" | "correction";
+  isCurrent: boolean;
+  totalGross: AccountSupportMoney | null;
+}
+
+export interface AccountOrderSummary {
+  orderId: string;
+  orderRef: string;
+  orderNumber: string | null;
+  subscriptionId: string | null;
+  status: string;
+  paymentStatus: string | null;
+  fulfillmentStatus: string | null;
+  customerFulfillmentStep?: "paid" | "accepted" | "packing" | "transit" | "delivered" | "exception" | "cancelled";
+  total: AccountSupportMoney;
+  trackingNumber: string | null;
+  trackingNumbers: string[];
+  trackingUrl: string | null;
+  carrierKind: string | null;
+  service: string | null;
+  trackingReferences: AccountTrackingReference[];
+  trackingTimeline: AccountTrackingEvent[];
+  deliverySelection: AccountDeliverySelection | null;
+  invoice: AccountInvoiceSummary | null;
+  invoiceDocuments: AccountInvoiceDocument[];
+  invoiceRequestStatus: "not_requested" | "preparing" | "available";
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface AccountOrderLine {
+  lineId: string;
+  skuId: string | null;
+  title: string;
+  quantity: number;
+  unitPrice: AccountSupportMoney;
+  total: AccountSupportMoney;
+  variantName: string | null;
+  productSlug?: string | null;
+  displayLabel?: string | null;
+  accentColor?: string | null;
+  listTotal?: AccountSupportMoney | null;
+  discount?: AccountSupportMoney | null;
+}
+
+export interface AccountFulfillmentSummary {
+  fulfillmentOrderId: string | null;
+  status: string | null;
+  providerKind: string | null;
+  trackingNumber: string | null;
+  trackingNumbers: string[];
+  trackingReferences: AccountTrackingReference[];
+  lastEventType: string | null;
+  updatedAt: string | null;
+  trackingTimeline: AccountTrackingEvent[];
+}
+
+export interface AccountOrderDetail extends AccountOrderSummary {
+  subtotal: AccountSupportMoney;
+  discount: AccountSupportMoney;
+  shipping: AccountSupportMoney;
+  tax: AccountSupportMoney;
+  lines: AccountOrderLine[];
+  fulfillment: AccountFulfillmentSummary | null;
+}
+
+export interface AccountOrderList {
+  contractVersion: "customer.orders.v2";
+  orders: AccountOrderSummary[]
+}
+
+export interface AccountOrderDetailResponse {
+  contractVersion: "customer.orders.v2";
+  order: AccountOrderDetail
+}
+
+export interface AccountActionRequired {
+  actionId: string;
+  kind: "payment_recovery"
+  | "payment_method_missing"
+  | "subscription_blocked"
+  | "order_attention"
+  | "invoice_attention";
+  severity: "info" | "warning" | "critical";
+  entityType: "subscription" | "order" | "invoice" | "account";
+  entityId: string | null;
+  subscriptionId: string | null;
+  orderId: string | null;
+  messageCode: AccountActionMessage;
+  blockedReason: AccountActionMessage | null;
+  title: string;
+  body: string | null;
+  cta: "repair_payment" | "view_subscription" | "view_order" | "contact_support" | null;
+  failureCause: "needs_confirmation"
+  | "method_cannot_recur"
+  | "method_dead"
+  | "method_data_invalid"
+  | "method_missing"
+  | "unknown";
+  recoveryEligible: boolean;
+  dueAt: string | null;
+  nextRetryAt: string | null;
+}
+
+export type AccountActionMessage = "payment_blocked"
+  | "payment_expired"
+  | "missing_payment_method"
+  | "payment_failed"
+  | "payment_requires_action"
+  | "subscription_edit_blocked"
+  | "invoice_pdf_unavailable"
+  | "subscription_activation_missing_mandate";
+
+export interface AccountSnapshot<Extension = unknown> {
+  contractVersion: "customer.account.v3";
+  profile: AccountProfile;
+  extension: Extension;
+  subscriptions: AccountSubscription[];
+  addresses: AccountAddress[];
+  ordererProfiles: AccountBillingProfile[];
+  billingProfiles: AccountBillingProfile[];
+  paymentPreferences: AccountPaymentPreference[];
+  deliveryPreferences: AccountDeliveryPreference[];
+  recentOrders: AccountOrderSummary[];
+  events: AccountEvent[];
+  actionRequired: AccountActionRequired[];
+}

package/src/account-support/contracts/capabilities.ts

@@ -0,0 +1,30 @@
+import type { SubscriptionCapabilities } from "./commands.js";
+export type AccountSupportCapability<Code extends string> = { supported: true } | { supported: false; refusalCode: Code };
+export type AccountSupportLaneUnavailable<Code extends string> = Extract<AccountSupportCapability<Code>, { supported: false }>;
+/** Explicit driver selections; importing the module installs no capability. */
+export interface AccountSupportCapabilities {
+  graph: "managed" | "native";
+  accountRead: AccountSupportCapability<"host_binding_required">;
+  customer360Read: AccountSupportCapability<"host_binding_required">;
+  invoiceAccess: AccountSupportCapability<"host_binding_required">;
+  paymentMethodSetup: AccountSupportCapability<"unsupported">;
+  commerceRecovery: AccountSupportCapability<"host_binding_required">;
+  configuredPurchase: AccountSupportCapability<"host_binding_required">;
+  operatorSubscription: AccountSupportCapability<"operator_subscription_authority_unavailable">;
+  operatorContact: AccountSupportCapability<"operator_subscription_authority_unavailable">;
+  subscriptions: SubscriptionCapabilities;
+  communicationGifts: AccountSupportCapability<"unsupported_preference">;
+}
+
+/** Per-action/subcase truth, independent of the host's unrelated read selections. */
+export interface OperatorAuthorityCapabilities {
+  graph: "managed" | "native";
+  email: AccountSupportCapability<"operator_subscription_authority_unavailable">;
+  phone: AccountSupportCapability<"operator_subscription_authority_unavailable">;
+  link: AccountSupportCapability<"operator_subscription_authority_unavailable">;
+  address: AccountSupportCapability<"operator_subscription_authority_unavailable">;
+  shortBand: AccountSupportCapability<"operator_subscription_authority_unavailable">;
+  unpaidResume: AccountSupportCapability<"operator_subscription_authority_unavailable">;
+  preparedAttemptPause: AccountSupportCapability<"operator_subscription_authority_unavailable">;
+  pause: { supported: true }; resume: { supported: true }; slide: { supported: true };
+}

package/src/account-support/contracts/commands.ts

@@ -0,0 +1,243 @@
+import type { CustomerContext } from "./account.js";
+import type { AccountSupportCapabilities, AccountSupportLaneUnavailable } from "./capabilities.js";
+/** Local transcriptions of owner contracts; portFit checks equality against the owners. */
+export interface SubscriptionCommandContext {
+  actor: { kind: "customer" | "operator"; actorId: string; clientId: string };
+  subscriptionId: string; idempotencyKey: string; now: string;
+}
+export type SubscriptionCommand = SubscriptionCommandContext & (
+  | { action: "pause"; pausePreset: string; reason: string | null; survey: string | null; saveOffer: string | null }
+  | { action: "resume" | "skip" | "cancel"; reason: string | null; confirmedChargeTiming: boolean }
+  | { action: "slide"; newNextCycleAt: string; confirmedChargeTiming: boolean }
+  | { action: "edit_future_terms"; shippingAddressId: string; planDays: number; cadenceDays: number;
+      expectedTemplateVersion: number;
+      /** Empty string means no quote (semantic no-op). */
+      acceptedQuoteHash: string; confirmedChargeTiming: boolean;
+      coreLines: readonly SubscriptionBundleLine[]; addonLines: readonly SubscriptionBundleLine[];
+      compositionConstraint: string }
+);
+export interface SubscriptionBundleLine { sku: string; quantity: number }
+export interface SubscriptionCommandReceipt {
+  actorId: string; idempotencyKey: string; commandFingerprint: string;
+  outcome: "applied" | "replayed" | "noop"; subscriptionId: string;
+  originalState: string; nextCycleAt: string | null; revision: string; eventId: string | null;
+}
+export interface SubscriptionCommandRefusal {
+  outcome: "refused";
+  /** Stable machine code; never provider, PostgreSQL diagnostic or customer text.
+   * Unrecognized native or host diagnostics map to subscription_command_invalid_input. */
+  reason:
+    | "multi_cycle_prepaid_unsupported"
+    | "subscription_command_addon_not_found"
+    | "subscription_command_bundle_total_mismatch"
+    | "subscription_command_charge_timing_not_confirmed"
+    | "subscription_command_idempotency_conflict"
+    | "subscription_command_invalid_composition_constraint"
+    | "subscription_command_invalid_input"
+    | "subscription_command_not_active"
+    | "subscription_command_operation_busy"
+    | "subscription_command_pause_forbidden"
+    | "subscription_command_payment_blocked"
+    | "subscription_command_preview_unsupported"
+    | "subscription_command_renewal_terms_missing"
+    | "subscription_command_unsupported_action"
+    | "subscription_edit_catalog_unavailable"
+    | "subscription_edit_invalid_lines"
+    | "subscription_edit_invalid_request"
+    | "subscription_edit_quote_expired"
+    | "subscription_edit_quote_required"
+    | "subscription_edit_stale_template"
+    | "subscription_edit_window_closed"
+    | "subscription_lifecycle_invalid_transition"
+    | "subscription_lifecycle_invalid_skip"
+    | "subscription_lifecycle_invalid_slide"
+    | "subscription_lifecycle_payment_blocked";
+}
+export type SubscriptionUnsupportedCode = "multi_cycle_prepaid_unsupported" | "native_generic_bundle_commands_unsupported" | "native_command_bound_receipts_unsupported" | "native_prepared_attempt_store_unsupported";
+export interface SubscriptionUnsupported { supported: false; refusalCode: SubscriptionUnsupportedCode }
+/** Readiness must be selected explicitly; a port declaration does not install a store. */
+export interface SubscriptionCapabilities {
+  graph: "managed" | "native";
+  multiCyclePrepaid: { supported: false; refusalCode: "multi_cycle_prepaid_unsupported" };
+  genericBundleCommands: { supported: true } | { supported: false; refusalCode: "native_generic_bundle_commands_unsupported" };
+  commandBoundReceipts: { supported: true } | { supported: false; refusalCode: "native_command_bound_receipts_unsupported" };
+  preparedAttemptStore: { supported: true } | { supported: false; refusalCode: "native_prepared_attempt_store_unsupported" };
+  retryRecovery: "unavailable" | "selected";
+  stockRecovery: "unavailable" | "selected";
+  deliveryAdmission: "required";
+  executorCount: 1;
+  defaultEnabled: false;
+}
+/** Exact raw native owner command; its result still requires a host codec. */
+export interface NativeSubscriptionCommand {
+  actorId: string; clientId: string; idempotencyKey: string; subscriptionId: string;
+  action: string; payload: Record<string, unknown>; now: string;
+}
+
+/** Driver DTOs are explicit type arguments, never a claim that all graphs implement them. */
+export interface SelfServiceCommandFacade<ManagedRequest, ManagedPreviewRequest, ManagedPreview, ManagedReceipt,
+  ProfileRequest, ProfileResult, MethodRequest, MethodResult, CommerceRequest, CommerceResult, RecoveryRequest, RecoveryResult, ControlSnapshot = unknown> {
+  capabilities: AccountSupportCapabilities;
+  managedSubscription: {
+    previewAction(userId: string, request: ManagedPreviewRequest): Promise<ManagedPreview | null | AccountSupportLaneUnavailable<"host_binding_required">>;
+    applyAction(userId: string, request: ManagedRequest): Promise<ManagedReceipt | null | AccountSupportLaneUnavailable<"host_binding_required">>;
+  };
+  nativeLegacySubscription: {
+    previewAction(userId: string, request: ManagedPreviewRequest): Promise<ManagedPreview | null | AccountSupportLaneUnavailable<"host_binding_required">>;
+    applyAction(userId: string, request: ManagedRequest): Promise<ManagedReceipt | null | AccountSupportLaneUnavailable<"host_binding_required">>;
+  };
+  subscriptionControl: { getSnapshot(userId: string): Promise<ControlSnapshot | AccountSupportLaneUnavailable<"host_binding_required">> };
+  nativeRawSubscription: {
+    preview(command: NativeSubscriptionCommand): Promise<Record<string, unknown> | AccountSupportLaneUnavailable<"host_binding_required">>;
+    apply(command: NativeSubscriptionCommand): Promise<Record<string, unknown> | AccountSupportLaneUnavailable<"host_binding_required">>;
+  };
+  nativeSubscription: {
+    apply(command: SubscriptionCommand): Promise<SubscriptionCommandReceipt | SubscriptionCommandRefusal | SubscriptionUnsupported | AccountSupportLaneUnavailable<"host_binding_required">>;
+    preview(command: Extract<SubscriptionCommand, { action: "edit_future_terms" }>): Promise<Record<string, unknown> | SubscriptionCommandRefusal | AccountSupportLaneUnavailable<"host_binding_required">>;
+  };
+  profile: { updateProfile(userId: string, request: ProfileRequest): Promise<ProfileResult | null | AccountSupportLaneUnavailable<"host_binding_required">> };
+  paymentMethod: { execute(userId: string, request: MethodRequest): Promise<MethodResult | AccountSupportLaneUnavailable<"unsupported">> };
+  commerce: { execute(userId: string, request: CommerceRequest): Promise<CommerceResult | AccountSupportLaneUnavailable<"host_binding_required">> };
+  recovery: { startPaymentRecovery(userId: string, request: RecoveryRequest): Promise<RecoveryResult | null | AccountSupportLaneUnavailable<"host_binding_required">> };
+}
+
+export interface AccountSupportMoney { amountMinor: number; currency: string }
+export type SubscriptionPaymentMethodStatus = "usable" | "expiring" | "missing" | "revoked" | "requires_action" | "invalid" | "provider_disabled";
+export type SubscriptionRenewalBlockStatus = "blocked_preflight" | "payment_pending" | "dunning" | "paid_fulfillment_pending" | "fulfillment_blocked" | "catalog_blocked" | "customer_action_required";
+export type EligibilityRefusal =
+  | "not_active"
+  | "edit_window_closed"
+  | "cycle_locked"
+  | "payment_blocked"
+  | "missing_payment_method"
+  | "invalid_address"
+  | null;
+
+export interface LegacySubscriptionPreviewResponse {
+  preview: {
+    subscriptionId: string;
+    action: string;
+    canApply: boolean;
+    blockedReason: EligibilityRefusal;
+    nextCycleAt: string | null;
+    editCutoffAt: string | null;
+    templateVersion: number | null;
+    lockedCycle?: {
+      locked: boolean;
+      status: SubscriptionRenewalBlockStatus | null;
+    };
+    futureTemplate?: {
+      templateVersion: number | null;
+      effectiveCycleAt: string | null;
+      priceAgreementPolicy: "lock_until_edit";
+    };
+    paymentMethodStatus?: SubscriptionPaymentMethodStatus;
+    deliverability?: {
+      status: "address_book_validated" | "blocked" | "unknown";
+      blockedReason: EligibilityRefusal;
+    };
+    catalogAvailability?: {
+      status: "available" | "blocked" | "unknown";
+      blockedReason: EligibilityRefusal;
+    };
+    quoteHash?: string;
+    quoteExpiresAt?: string;
+    currentTotal?: AccountSupportMoney;
+    newTotal?: AccountSupportMoney;
+    delta?: AccountSupportMoney;
+    chargeTiming?: {
+      requiresConfirmation: boolean;
+      confirmed: boolean;
+      earliestChargeAt: string | null;
+    };
+    dateAvailability?: {
+      earliestAllowedAt: string;
+      latestAllowedAt: string;
+      availableDates: string[];
+      blockedReason: EligibilityRefusal;
+    };
+    packageEdit?: {
+      currentRecurringPrice: AccountSupportMoney;
+      newRecurringPrice: AccountSupportMoney;
+      delta: AccountSupportMoney;
+      quoteHash: string;
+      effectiveCycleAt: string | null;
+      priceAgreementPolicy: "lock_until_edit";
+    };
+  };
+}
+
+
+/** Already resolved host request. The codec never supplies policy or catalogue fields. */
+export interface LegacySubscriptionRequest<Action extends string = string, Payload extends Record<string, unknown> = Record<string, unknown>> {
+  subscriptionId: string;
+  idempotencyKey: string;
+  action: Action;
+  payload: Payload;
+}
+export interface RawSubscriptionCommands {
+  preview(command: NativeSubscriptionCommand): Promise<Record<string, unknown>>;
+  apply(command: NativeSubscriptionCommand): Promise<Record<string, unknown>>;
+}
+/** Only checked native quote records reach a host projection. */
+export interface NativeSubscriptionPreview extends Record<string, unknown> {
+  status: "previewed";
+  canApply: true;
+  templateVersion: number;
+  quoteHash: string;
+  quoteExpiresAt: string;
+  currentTotalMinor: number;
+  newTotalMinor: number;
+  lines: { variantId: string; quantity: number; isAddon: boolean; sortOrder: number; unitPriceMinor: number; currency: string }[];
+  priceAgreementPolicy: { kind: "lock_until_edit"; proration: "none"; cycleEffect: "future_unlocked_cycles_only" };
+}
+export type NativePreviewProjection<Preview> =
+  | { kind: "projected"; preview: Preview }
+  | { kind: "owner"; result: Record<string, unknown> };
+export interface SubscriptionDriver<Request, Preview, Receipt> {
+  preview(context: CustomerContext, request: Request): Promise<Preview>;
+  apply(context: CustomerContext, request: Request): Promise<Receipt>;
+}
+/** Browser-safe transcription of M07 collection; instantiate with its branded handoff. */
+export interface MethodSetupInput {
+  customer: string;
+  metadata: Record<string, string>;
+  idempotencyKey: string;
+}
+export type MethodSetupResult<Handoff> =
+  | { kind: "ready"; setupRef: string; handoff: Handoff; replayed: boolean }
+  | { kind: "unsupported" };
+export interface MethodSetupPort<Handoff> {
+  setupMethod(input: MethodSetupInput): Promise<MethodSetupResult<Handoff>>;
+}
+/** Host parts retain repricing, quote validation, authorization and error construction. */
+export interface NativeLegacySubscriptionParts<Request, PreviewRequest, Preview, Receipt, ControlSnapshot = unknown> {
+  explicitPause: { applyAction(userId: string, request: Request): Promise<Receipt | null> };
+  control: LegacySubscriptionPort<Request, PreviewRequest, Preview, Receipt> & {
+    hasSubscription(userId: string, subscriptionId: string): Promise<boolean>;
+    getSnapshot(userId: string): Promise<ControlSnapshot>;
+  };
+  ownershipRefusal(): unknown;
+}
+export interface LegacySubscriptionPort<Request, PreviewRequest, Preview, Receipt> {
+  previewAction(userId: string, request: PreviewRequest): Promise<Preview | null>;
+  applyAction(userId: string, request: Request): Promise<Receipt | null>;
+}
+/** The host supplies capabilities and explicitly selects each owner lane. */
+export type SelfServiceCommandFacadeInput<Request, PreviewRequest, Preview, Receipt,
+  ProfileRequest, ProfileResult, MethodRequest, MethodResult, CommerceRequest, CommerceResult, RecoveryRequest, RecoveryResult, ControlSnapshot = unknown> =
+  {
+    context: CustomerContext;
+    capabilities: AccountSupportCapabilities;
+    managedSubscription?: LegacySubscriptionPort<Request, PreviewRequest, Preview, Receipt>;
+    nativeLegacySubscription?: NativeLegacySubscriptionParts<Request, PreviewRequest, Preview, Receipt, ControlSnapshot>;
+    nativeRawSubscription?: RawSubscriptionCommands;
+    nativeSubscription?: {
+      apply(command: SubscriptionCommand): Promise<SubscriptionCommandReceipt | SubscriptionCommandRefusal | SubscriptionUnsupported>;
+      preview(command: Extract<SubscriptionCommand, { action: "edit_future_terms" }>): Promise<Record<string, unknown> | SubscriptionCommandRefusal>;
+    };
+    profile?: { updateProfile(userId: string, request: ProfileRequest): Promise<ProfileResult | null> };
+    paymentMethod?: { execute(userId: string, request: MethodRequest): Promise<MethodResult> };
+    commerce?: { execute(userId: string, request: CommerceRequest): Promise<CommerceResult> };
+    recovery?: { startPaymentRecovery(userId: string, request: RecoveryRequest): Promise<RecoveryResult | null> };
+  };