@lockerverse/sdk 0.2.177 → 0.2.181-dev.1

package/MIGRATIONS.md

@@ -36,7 +36,7 @@ If it cannot be found, report that limit and use the baseline review below. Do n
 claim that every historical migration was applied. Read this file even if the
 version already matches: a previous upgrade may have missed host adoption steps.
 
-## 0.2.177 — Secure checkout loading recovery
+## 0.2.176-dev.1 — Secure checkout loading recovery
 
 - **Affected:** React payment widget Stripe fields.
 - **Automatic:** failed field or script loads show a reload action. Fields that
@@ -48,9 +48,23 @@ version already matches: a previous upgrade may have missed host adoption steps.
 - Reload is an explicit customer action and can clear unsaved form entries.
   Saved payment recovery remains in session storage.
 
-
 ## 0.2.175 — Match Stripe Elements payment method configuration
 
+- **Affected:** Core checkout submission and React payment widgets.
+- **Automatic:** React configures explicit card, Link, and community-enabled bank
+  methods in Stripe Elements and marks the confirmation request with
+  `paymentMethodConfiguration: "explicit"`. This matches the backend's Stripe
+  PaymentIntent configuration.
+- **Required:** deploy the backend that supports this optional marker before
+  upgrading React. Keep Core and React matched. Existing Core-only callers omit
+  the marker and retain automatic payment methods. Custom Elements integrations
+  must send the marker only when they use the explicit method list.
+- **Check:** submit card and bank payments through Stripe Elements in test mode,
+  including recurring checkout. Confirm pending recovery and settlement.
+
+
+## 0.2.174-dev.1 — Match Stripe Elements payment method configuration
+
 - **Affected:** Core checkout submission and React payment widgets.
 - **Automatic:** React configures explicit card, Link, and community-enabled bank
   methods in Stripe Elements and marks the confirmation request with
@@ -124,7 +138,39 @@ version already matches: a previous upgrade may have missed host adoption steps.
   verify a changed selection cannot discard it. Check both paid and free order
   confirmation panels. Do not submit a live transaction for this check.
 
-## 0.2.170 — six-month payment widgets
+## 0.2.172-dev.1 — Check pending payment status
+
+- **Affected:** React payment widgets with unresolved payments.
+- **Automatic behavior:** the existing pending-payment screen now offers Check
+  payment status. It checks the saved payment reference and cannot submit a new
+  payment. The control is disabled while the check runs.
+- **Required host changes:** none. Update Core and React together.
+- **Verification:** complete a test bank payment, return to its pending checkout,
+  and check its status. Confirm completion clears recovery storage.
+
+## 0.2.171-dev.1 — SDK payment recovery and completion UI
+
+- **Affected:** React payment widgets and custom hosts that persist payment recovery.
+- **Optional adoption:** pass `recoveryStorageKey` to `LockerversePayment` to let
+  the SDK save and restore the pending payment in session storage. Use a stable
+  key scoped to the API environment, community, and widget. Remove the host's
+  storage code and recovery-driven component key. Do not combine automatic
+  persistence with a second host persistence writer.
+- **Compatibility:** the SDK reads the hosted Next app's existing version 1
+  records when the same key is used. It writes version 2 records with widget
+  identity. It checks widget and selection identity before recovery and keeps
+  an unresolved record if those details differ. Recovery uses the saved connected
+  account even if current payment routing has changed. Storage is read after hydration,
+  before the payable form mounts. No contact details or payment tokens are saved.
+- **Optional UI adoption:** use `completionView="summary"` for the SDK confirmation
+  panel and remove the host's duplicate success panel. Completion callbacks still
+  run. The default inline message and explicit `resumePayment` integrations remain
+  supported. Auctions and legacy custom checkout forms are unchanged.
+- **Check:** reload a pending checkout and confirm the existing payment is checked;
+  verify a changed selection cannot discard it. Check both paid and free order
+  confirmation panels. Do not submit a live transaction for this check.
+
+## 0.2.169-dev.1 — six-month payment widgets
 
 Affected: @lockerverse/sdk checkout and @lockerverse/react payment widgets.
 
@@ -140,6 +186,31 @@ Affected: @lockerverse/sdk checkout and @lockerverse/react payment widgets.
   submission. Do not submit a live payment for an integration check.
 
 
+## 0.2.168-dev.1 — bank authorization terms
+
+- **Affected:** React payment widgets with ACH enabled.
+- **Automatic:** Stripe displays its bank authorization terms before payment confirmation.
+- **Adoption:** update the matching SDK/React development pair. No prop changes are required.
+- **Check:** confirm that the bank authorization text is visible when a bank account is selected.
+
+## 0.2.167-dev.1 — widget ACH and subscription payment recovery
+
+- **Affected:** Core checkout data and React payment widgets.
+- **Automatic:** bank payment availability follows the organization default and
+  community override returned by the backend. Missing policy remains disabled.
+  Pending payments keep their existing payment reference. A failed subscription
+  invoice can return `action_required` with `requiresAction: false` and `retryUrl`;
+  React shows a link to pay the same invoice instead of creating a second subscription.
+- **Required for custom payment UI:** preserve the reference for pending and
+  action-required results. Handle `retryUrl` by opening that invoice, and recover
+  status before permitting a new checkout. Do not treat submission as settlement.
+- **Adoption:** deploy the matching backend policy and recovery contract before
+  enabling ACH. Existing React hosts need no component prop changes. Keep Core and
+  React versions matched when upgrading. Auction payment methods are unchanged.
+- **Check:** verify disabled/inherited/enabled bank visibility and pending, bank
+  verification, invoice retry, success, and terminal failure in Stripe test mode.
+  Do not create a live transaction for this check.
+
 ## 0.2.166 — single dropdown arrow
 
 - **Affected:** native single-select custom fields in React signup and payment forms.

package/dist/types.js

@@ -1,2 +1,2 @@
-const e=`0.2.177`;var t=class extends Error{code;operation;reportable;recoveryRecommended;sdkVersion;serverCode;status;constructor({code:t,message:n,operation:r,reportable:i,recoveryRecommended:a=!1,serverCode:o,status:s}){super(n),this.name=`LockerverseSdkError`,this.code=t,this.operation=r,this.reportable=i,this.recoveryRecommended=a,this.sdkVersion=e,this.serverCode=o,this.status=s}};export{t as n,e as t};
+const e=`0.2.181-dev.1`;var t=class extends Error{code;operation;reportable;recoveryRecommended;sdkVersion;serverCode;status;constructor({code:t,message:n,operation:r,reportable:i,recoveryRecommended:a=!1,serverCode:o,status:s}){super(n),this.name=`LockerverseSdkError`,this.code=t,this.operation=r,this.reportable=i,this.recoveryRecommended=a,this.sdkVersion=e,this.serverCode=o,this.status=s}};export{t as n,e as t};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":["packageMetadata.version"],"sources":["../package.json","../src/types.ts"],"sourcesContent":["","import packageMetadata from \"../package.json\" with { type: \"json\" };\nimport type { GeneratedPaymentResult } from \"./generated/public-contract-types.ts\";\n\nexport type LockerversePaymentOption =\n  | \"one-time\"\n  | \"monthly\"\n  | \"annually\"\n  | \"every-six-months\";\nexport type LockerverseEnvironment = \"development\" | \"production\";\nexport type LockerverseFulfillmentType = \"none\" | \"event_admission\";\n\nexport const LOCKERVERSE_SDK_VERSION = packageMetadata.version;\n\nexport type LockerverseProduct = {\n  id: string;\n  listingId: string;\n  slug: string;\n  name: string;\n  description: string | null;\n  fulfillmentType: LockerverseFulfillmentType;\n  pricingMode: \"fixed\" | \"custom\";\n  paymentOption: LockerversePaymentOption;\n  amountCents: number | null;\n  minimumAmountCents: number | null;\n  minimumQuantity: number | null;\n  /** Per-order limit for this widget listing. Null means no per-order limit. */\n  maximumQuantity: number | null;\n  inventoryQuantity: number | null;\n  acceptsDiscounts: boolean;\n};\n\nexport type LockerverseAvailabilityStatus = \"available\" | \"sold_out\";\n\nexport type LockerverseCatalogAvailability = {\n  listings: Array<{\n    listingId: string;\n    maxPurchasableQuantity: number | null;\n    remainingQuantity: number | null;\n    status: LockerverseAvailabilityStatus;\n  }>;\n  sharedLimits: Array<{\n    id: string;\n    listingIds: string[];\n    remainingQuantity: number;\n    status: LockerverseAvailabilityStatus;\n  }>;\n};\n\nexport type LockerverseCatalog = {\n  availability: LockerverseCatalogAvailability;\n  community: LockerverseCommunityBranding | null;\n  event: LockerverseEvent | null;\n  payment: LockerversePaymentConfiguration;\n  pricingPolicy: LockerverseCheckoutPricingPolicy;\n  products: LockerverseProduct[];\n  widget: LockerverseWidgetConfiguration;\n};\n\nexport type LockerverseEvent = {\n  description: string | null;\n  endAt: string;\n  id: string;\n  location: string | null;\n  name: string;\n  startAt: string;\n  status: \"draft\" | \"active\" | \"finished\" | \"cancelled\";\n};\n\nexport type LockerverseCommunityBranding = {\n  widgetAchEnabled?: boolean | undefined;\n  accentColor: string;\n  imageUrl: string | null;\n  memberIdLabel?: string | null | undefined;\n  name: string;\n};\n\nexport type LockerverseCheckoutPricingPolicy = {\n  currency: \"usd\";\n  serviceFeeRateBasisPoints: number;\n};\n\nexport type LockerversePaymentConfiguration = {\n  connectedAccountId: string | null;\n  currency: \"usd\";\n  publishableKey: string;\n};\n\nexport type LockerverseWidgetFields = {\n  memberId: boolean;\n  merchSize: boolean;\n  phone: boolean;\n  promoCode: boolean;\n  serviceFee: boolean;\n  shipping: boolean;\n  tipping: boolean;\n};\n\nexport type LockerverseCustomFieldOption = { id: string; label: string };\n\ntype LockerverseCustomFieldBase = {\n  id: string;\n  label: string;\n  paymentOptionIds?: string[] | undefined;\n  required: boolean;\n};\n\nexport type LockerverseTextCustomField = LockerverseCustomFieldBase & {\n  type: \"text\" | \"textarea\";\n};\n\nexport type LockerverseBooleanCustomField = LockerverseCustomFieldBase & {\n  type: \"checkbox\";\n};\n\nexport type LockerverseSingleOptionCustomField = LockerverseCustomFieldBase & {\n  options: LockerverseCustomFieldOption[];\n  type: \"radio\" | \"select\";\n};\n\nexport type LockerverseMultiOptionCustomField = LockerverseCustomFieldBase & {\n  options: LockerverseCustomFieldOption[];\n  type: \"checkboxes\" | \"multi_select\";\n};\n\nexport type LockerverseCustomField =\n  | LockerverseBooleanCustomField\n  | LockerverseTextCustomField\n  | LockerverseSingleOptionCustomField\n  | LockerverseMultiOptionCustomField;\n\nexport type LockerverseCustomFieldAnswerValue<\n  Field extends LockerverseCustomField,\n> = Field extends LockerverseBooleanCustomField\n  ? boolean\n  : Field extends LockerverseMultiOptionCustomField\n    ? string[]\n    : string;\n\nexport type LockerverseCustomFieldAnswer<\n  Field extends LockerverseCustomField = LockerverseCustomField,\n> = Field extends LockerverseCustomField\n  ? { fieldId: Field[\"id\"]; value: LockerverseCustomFieldAnswerValue<Field> }\n  : never;\n\nexport type LockerverseWidgetConfiguration = {\n  customFields: LockerverseCustomField[];\n  description: string | null;\n  fields: LockerverseWidgetFields;\n  id: string;\n  name: string;\n  showCommunityBranding: boolean;\n  title: string | null;\n};\n\nexport type LockerverseSdkErrorCode =\n  | \"public_events_load_failed\"\n  | \"auction_load_failed\"\n  | \"auction_bid_failed\"\n  | \"auction_purchase_failed\"\n  | \"auction_purchase_status_failed\"\n  | \"auction_receipt_failed\"\n  | \"widget_load_failed\"\n  | \"signup_load_failed\"\n  | \"signup_submit_failed\"\n  | \"total_calculation_failed\"\n  | \"payment_submit_failed\"\n  | \"payment_status_failed\"\n  | \"invalid_selection\";\n\nexport type LockerverseSdkOperation =\n  | \"list_public_events\"\n  | \"list_auctions\"\n  | \"load_auction\"\n  | \"create_auction_bid\"\n  | \"create_auction_purchase\"\n  | \"get_auction_purchase_receipt\"\n  | \"get_auction_purchase_status\"\n  | \"load_widget\"\n  | \"load_signup\"\n  | \"submit_signup\"\n  | \"calculate_total\"\n  | \"submit_payment\"\n  | \"get_payment_status\";\n\nexport type LockerverseSdkServerCode =\n  | \"PAYMENT_WIDGET_SALES_LIMIT_REACHED\"\n  | \"PAYMENT_WIDGET_PHONE_INVALID\"\n  | \"PAYMENT_WIDGET_PHONE_REQUIRED\"\n  | \"SIGN_UP_WIDGET_PHONE_INVALID\"\n  | \"SIGN_UP_WIDGET_PHONE_REQUIRED\";\n\nexport class LockerverseSdkError extends Error {\n  readonly code: LockerverseSdkErrorCode;\n  readonly operation: LockerverseSdkOperation;\n  readonly reportable: boolean;\n  readonly recoveryRecommended: boolean;\n  readonly sdkVersion: string;\n  readonly serverCode: LockerverseSdkServerCode | undefined;\n  readonly status: number | undefined;\n\n  constructor({\n    code,\n    message,\n    operation,\n    reportable,\n    recoveryRecommended = false,\n    serverCode,\n    status,\n  }: {\n    code: LockerverseSdkErrorCode;\n    message: string;\n    operation: LockerverseSdkOperation;\n    reportable: boolean;\n    recoveryRecommended?: boolean;\n    serverCode?: LockerverseSdkServerCode;\n    status?: number;\n  }) {\n    super(message);\n    this.name = \"LockerverseSdkError\";\n    this.code = code;\n    this.operation = operation;\n    this.reportable = reportable;\n    this.recoveryRecommended = recoveryRecommended;\n    this.sdkVersion = LOCKERVERSE_SDK_VERSION;\n    this.serverCode = serverCode;\n    this.status = status;\n  }\n}\n\nexport type LockerverseCheckoutLineItem = {\n  productId: string;\n  productName: string;\n  listingId: string;\n  listingSlug: string;\n  acceptsDiscounts: boolean;\n  eventId: string | null;\n  fulfillmentType: LockerverseFulfillmentType;\n  pricingMode: \"fixed\" | \"custom\";\n  paymentOption: LockerversePaymentOption;\n  quantity: number;\n  unitAmountCents: number;\n  subtotalCents: number;\n};\n\nexport type LockerverseAppliedDiscount = {\n  percentageOff: number;\n  source: \"email_list\" | \"promo_code\";\n};\n\nexport type LockerverseCheckoutAmounts = {\n  amountCents: number;\n  discountableSubtotalCents: number;\n  discountCents: number;\n  serviceFeeCents: number;\n  subtotalCents: number;\n  tipCents: number;\n  totalCents: number;\n};\n\nexport type LockerverseCheckoutQuote = LockerverseCheckoutAmounts & {\n  appliedDiscount: LockerverseAppliedDiscount | null;\n  authoritative: true;\n  paymentReference: string;\n  payment: LockerversePaymentConfiguration;\n  paymentOption: LockerversePaymentOption;\n  lineItems: LockerverseCheckoutLineItem[];\n};\n\nexport type LockerverseCheckoutEstimate = LockerverseCheckoutAmounts & {\n  appliedDiscount: null;\n  authoritative: false;\n  items: readonly LockerverseCheckoutItem[];\n  lineItems: readonly LockerverseCheckoutLineItem[];\n  paymentOption: LockerversePaymentOption;\n};\n\nexport type LockerverseCheckoutPricingInput = {\n  email?: string;\n  includeServiceFee?: boolean;\n  promoCode?: string;\n  tipCents?: number;\n};\n\nexport type LockerversePaymentStatus =\n  | \"action_required\"\n  | \"failed\"\n  | \"pending\"\n  | \"success\";\n\nexport type LockerversePaymentResult = {\n  checkoutId: string;\n  paymentReference: string;\n  checkoutStatus: LockerversePaymentStatus;\n  retryUrl?: string | undefined;\n  clientSecret: string | null;\n  paymentRequired: boolean;\n  requiresAction: boolean;\n  status: string | null;\n};\n\nexport type LockerversePaymentCompletion = LockerversePaymentResult & {\n  email: string | null;\n  lineItems: readonly LockerverseCheckoutLineItem[] | null;\n};\n\ntype AssertPaymentContract<T extends true> = T;\ntype _PaymentResultMatchesGenerated = AssertPaymentContract<\n  LockerversePaymentResult extends GeneratedPaymentResult\n    ? GeneratedPaymentResult extends LockerversePaymentResult\n      ? true\n      : false\n    : false\n>;\n\nexport type LockerverseShipping = {\n  address: {\n    city: string;\n    country: string;\n    line1: string;\n    line2?: string;\n    postal_code: string;\n    state: string;\n  };\n  name: string;\n};\n\nexport type LockerversePaymentSubmission = {\n  confirmationToken?: string;\n  paymentMethodConfiguration?: \"explicit\";\n  customFieldAnswers?: LockerverseCustomFieldAnswer[];\n  email: string;\n  memberId?: string;\n  merchSize?: \"XS\" | \"S\" | \"M\" | \"L\" | \"XL\" | \"XXL\" | \"XXXL\";\n  metadata?: Record<string, string>;\n  phone?: string;\n  shipping?: LockerverseShipping;\n};\n\nexport type LockerverseCheckoutItem =\n  | { productId: string; quantity: number }\n  | { productId: string; amountCents: number }\n  | { productId: string };\n\nexport type LockerverseCheckoutSelectionItem =\n  | { productSlug: string; quantity: number }\n  | { productSlug: string; amountCents: number }\n  | { productSlug: string };\n\nexport type LockerverseEstimateCheckoutInput =\n  LockerverseCheckoutPricingInput & {\n    selection: LockerverseCheckoutSelectionItem[];\n  };\n\nexport type LockerverseLoadCheckoutInput = {\n  selection: LockerverseCheckoutSelectionItem[];\n};\n\nexport type LockerverseCalculateTotalInput = LockerverseCheckoutPricingInput & {\n  catalog: LockerverseCatalog;\n} & (\n    | {\n        items: LockerverseCheckoutItem[];\n        selection?: never;\n      }\n    | {\n        items?: never;\n        selection: LockerverseCheckoutSelectionItem[];\n      }\n  );\n\nexport type LockerversePreparedCheckout = Readonly<\n  LockerverseCheckoutQuote & {\n    items: readonly LockerverseCheckoutItem[];\n    pricing: Readonly<LockerverseCheckoutPricingInput>;\n  }\n>;\n\nexport type LockerverseLoadedCheckout = Readonly<{\n  catalog: LockerverseCatalog;\n  checkout: LockerversePreparedCheckout;\n}>;\n\nexport type LockerverseSubmitPaymentInput = {\n  checkout: LockerversePreparedCheckout;\n  submission: LockerversePaymentSubmission;\n};\n\ntype CreateLockerverseWidgetBaseOptions = {\n  communitySlug: string;\n  fetch?: typeof globalThis.fetch;\n  onError?: (error: LockerverseSdkError) => void;\n  requestTimeoutMs?: number;\n  sentryDsn?: string | null;\n  widgetSlug: string;\n};\n\nexport type LockerverseResourceEnvironmentOptions =\n  | {\n      apiBaseUrl: string;\n      environment: LockerverseEnvironment;\n    }\n  | {\n      apiBaseUrl?: undefined;\n      environment?: \"production\";\n    };\n\nexport type CreateLockerverseWidgetOptions =\n  CreateLockerverseWidgetBaseOptions & LockerverseResourceEnvironmentOptions;\n\nexport type LockerverseCheckoutClient = {\n  calculateTotal: (\n    input: LockerverseCalculateTotalInput\n  ) => Promise<LockerversePreparedCheckout>;\n  getPaymentStatus: (\n    paymentReference: string\n  ) => Promise<LockerversePaymentResult>;\n  load: {\n    (): Promise<LockerverseCatalog>;\n    (input: LockerverseLoadCheckoutInput): Promise<LockerverseLoadedCheckout>;\n  };\n  submitPayment: (\n    input: LockerverseSubmitPaymentInput\n  ) => Promise<LockerversePaymentResult>;\n};\n"],"mappings":"ACWA,MAAa,EAA0BA,UAoLvC,IAAa,EAAb,cAAyC,KAAM,CAC7C,KACA,UACA,WACA,oBACA,WACA,WACA,OAEA,YAAY,CACV,OACA,UACA,YACA,aACA,sBAAsB,GACtB,aACA,UASC,CACD,MAAM,CAAO,EACb,KAAK,KAAO,sBACZ,KAAK,KAAO,EACZ,KAAK,UAAY,EACjB,KAAK,WAAa,EAClB,KAAK,oBAAsB,EAC3B,KAAK,WAAa,EAClB,KAAK,WAAa,EAClB,KAAK,OAAS,CAChB,CACF"}
+{"version":3,"file":"types.js","names":["packageMetadata.version"],"sources":["../package.json","../src/types.ts"],"sourcesContent":["","import packageMetadata from \"../package.json\" with { type: \"json\" };\nimport type { GeneratedPaymentResult } from \"./generated/public-contract-types.ts\";\n\nexport type LockerversePaymentOption =\n  | \"one-time\"\n  | \"monthly\"\n  | \"annually\"\n  | \"every-six-months\";\nexport type LockerverseEnvironment = \"development\" | \"production\";\nexport type LockerverseFulfillmentType = \"none\" | \"event_admission\";\n\nexport const LOCKERVERSE_SDK_VERSION = packageMetadata.version;\n\nexport type LockerverseProduct = {\n  id: string;\n  listingId: string;\n  slug: string;\n  name: string;\n  description: string | null;\n  fulfillmentType: LockerverseFulfillmentType;\n  pricingMode: \"fixed\" | \"custom\";\n  paymentOption: LockerversePaymentOption;\n  amountCents: number | null;\n  minimumAmountCents: number | null;\n  minimumQuantity: number | null;\n  /** Per-order limit for this widget listing. Null means no per-order limit. */\n  maximumQuantity: number | null;\n  inventoryQuantity: number | null;\n  acceptsDiscounts: boolean;\n};\n\nexport type LockerverseAvailabilityStatus = \"available\" | \"sold_out\";\n\nexport type LockerverseCatalogAvailability = {\n  listings: Array<{\n    listingId: string;\n    maxPurchasableQuantity: number | null;\n    remainingQuantity: number | null;\n    status: LockerverseAvailabilityStatus;\n  }>;\n  sharedLimits: Array<{\n    id: string;\n    listingIds: string[];\n    remainingQuantity: number;\n    status: LockerverseAvailabilityStatus;\n  }>;\n};\n\nexport type LockerverseCatalog = {\n  availability: LockerverseCatalogAvailability;\n  community: LockerverseCommunityBranding | null;\n  event: LockerverseEvent | null;\n  payment: LockerversePaymentConfiguration;\n  pricingPolicy: LockerverseCheckoutPricingPolicy;\n  products: LockerverseProduct[];\n  widget: LockerverseWidgetConfiguration;\n};\n\nexport type LockerverseEvent = {\n  description: string | null;\n  endAt: string;\n  id: string;\n  location: string | null;\n  name: string;\n  startAt: string;\n  status: \"draft\" | \"active\" | \"finished\" | \"cancelled\";\n};\n\nexport type LockerverseCommunityBranding = {\n  widgetAchEnabled?: boolean | undefined;\n  accentColor: string;\n  imageUrl: string | null;\n  memberIdLabel?: string | null | undefined;\n  name: string;\n};\n\nexport type LockerverseCheckoutPricingPolicy = {\n  currency: \"usd\";\n  serviceFeeRateBasisPoints: number;\n};\n\nexport type LockerversePaymentConfiguration = {\n  connectedAccountId: string | null;\n  currency: \"usd\";\n  publishableKey: string;\n};\n\nexport type LockerverseWidgetFields = {\n  memberId: boolean;\n  merchSize: boolean;\n  phone: boolean;\n  promoCode: boolean;\n  serviceFee: boolean;\n  shipping: boolean;\n  tipping: boolean;\n};\n\nexport type LockerverseCustomFieldOption = { id: string; label: string };\n\ntype LockerverseCustomFieldBase = {\n  id: string;\n  label: string;\n  paymentOptionIds?: string[] | undefined;\n  required: boolean;\n};\n\nexport type LockerverseTextCustomField = LockerverseCustomFieldBase & {\n  type: \"text\" | \"textarea\";\n};\n\nexport type LockerverseBooleanCustomField = LockerverseCustomFieldBase & {\n  type: \"checkbox\";\n};\n\nexport type LockerverseSingleOptionCustomField = LockerverseCustomFieldBase & {\n  options: LockerverseCustomFieldOption[];\n  type: \"radio\" | \"select\";\n};\n\nexport type LockerverseMultiOptionCustomField = LockerverseCustomFieldBase & {\n  options: LockerverseCustomFieldOption[];\n  type: \"checkboxes\" | \"multi_select\";\n};\n\nexport type LockerverseCustomField =\n  | LockerverseBooleanCustomField\n  | LockerverseTextCustomField\n  | LockerverseSingleOptionCustomField\n  | LockerverseMultiOptionCustomField;\n\nexport type LockerverseCustomFieldAnswerValue<\n  Field extends LockerverseCustomField,\n> = Field extends LockerverseBooleanCustomField\n  ? boolean\n  : Field extends LockerverseMultiOptionCustomField\n    ? string[]\n    : string;\n\nexport type LockerverseCustomFieldAnswer<\n  Field extends LockerverseCustomField = LockerverseCustomField,\n> = Field extends LockerverseCustomField\n  ? { fieldId: Field[\"id\"]; value: LockerverseCustomFieldAnswerValue<Field> }\n  : never;\n\nexport type LockerverseWidgetConfiguration = {\n  customFields: LockerverseCustomField[];\n  description: string | null;\n  fields: LockerverseWidgetFields;\n  id: string;\n  name: string;\n  showCommunityBranding: boolean;\n  title: string | null;\n};\n\nexport type LockerverseSdkErrorCode =\n  | \"public_events_load_failed\"\n  | \"auction_load_failed\"\n  | \"auction_bid_failed\"\n  | \"auction_purchase_failed\"\n  | \"auction_purchase_status_failed\"\n  | \"auction_receipt_failed\"\n  | \"widget_load_failed\"\n  | \"signup_load_failed\"\n  | \"signup_submit_failed\"\n  | \"total_calculation_failed\"\n  | \"payment_submit_failed\"\n  | \"payment_status_failed\"\n  | \"invalid_selection\";\n\nexport type LockerverseSdkOperation =\n  | \"list_public_events\"\n  | \"list_auctions\"\n  | \"load_auction\"\n  | \"create_auction_bid\"\n  | \"create_auction_purchase\"\n  | \"get_auction_purchase_receipt\"\n  | \"get_auction_purchase_status\"\n  | \"load_widget\"\n  | \"load_signup\"\n  | \"submit_signup\"\n  | \"calculate_total\"\n  | \"submit_payment\"\n  | \"get_payment_status\";\n\nexport type LockerverseSdkServerCode =\n  | \"PAYMENT_WIDGET_SALES_LIMIT_REACHED\"\n  | \"PAYMENT_WIDGET_PHONE_INVALID\"\n  | \"PAYMENT_WIDGET_PHONE_REQUIRED\"\n  | \"SIGN_UP_WIDGET_PHONE_INVALID\"\n  | \"SIGN_UP_WIDGET_PHONE_REQUIRED\";\n\nexport class LockerverseSdkError extends Error {\n  readonly code: LockerverseSdkErrorCode;\n  readonly operation: LockerverseSdkOperation;\n  readonly reportable: boolean;\n  readonly recoveryRecommended: boolean;\n  readonly sdkVersion: string;\n  readonly serverCode: LockerverseSdkServerCode | undefined;\n  readonly status: number | undefined;\n\n  constructor({\n    code,\n    message,\n    operation,\n    reportable,\n    recoveryRecommended = false,\n    serverCode,\n    status,\n  }: {\n    code: LockerverseSdkErrorCode;\n    message: string;\n    operation: LockerverseSdkOperation;\n    reportable: boolean;\n    recoveryRecommended?: boolean;\n    serverCode?: LockerverseSdkServerCode;\n    status?: number;\n  }) {\n    super(message);\n    this.name = \"LockerverseSdkError\";\n    this.code = code;\n    this.operation = operation;\n    this.reportable = reportable;\n    this.recoveryRecommended = recoveryRecommended;\n    this.sdkVersion = LOCKERVERSE_SDK_VERSION;\n    this.serverCode = serverCode;\n    this.status = status;\n  }\n}\n\nexport type LockerverseCheckoutLineItem = {\n  productId: string;\n  productName: string;\n  listingId: string;\n  listingSlug: string;\n  acceptsDiscounts: boolean;\n  eventId: string | null;\n  fulfillmentType: LockerverseFulfillmentType;\n  pricingMode: \"fixed\" | \"custom\";\n  paymentOption: LockerversePaymentOption;\n  quantity: number;\n  unitAmountCents: number;\n  subtotalCents: number;\n};\n\nexport type LockerverseAppliedDiscount = {\n  percentageOff: number;\n  source: \"email_list\" | \"promo_code\";\n};\n\nexport type LockerverseCheckoutAmounts = {\n  amountCents: number;\n  discountableSubtotalCents: number;\n  discountCents: number;\n  serviceFeeCents: number;\n  subtotalCents: number;\n  tipCents: number;\n  totalCents: number;\n};\n\nexport type LockerverseCheckoutQuote = LockerverseCheckoutAmounts & {\n  appliedDiscount: LockerverseAppliedDiscount | null;\n  authoritative: true;\n  paymentReference: string;\n  payment: LockerversePaymentConfiguration;\n  paymentOption: LockerversePaymentOption;\n  lineItems: LockerverseCheckoutLineItem[];\n};\n\nexport type LockerverseCheckoutEstimate = LockerverseCheckoutAmounts & {\n  appliedDiscount: null;\n  authoritative: false;\n  items: readonly LockerverseCheckoutItem[];\n  lineItems: readonly LockerverseCheckoutLineItem[];\n  paymentOption: LockerversePaymentOption;\n};\n\nexport type LockerverseCheckoutPricingInput = {\n  email?: string;\n  includeServiceFee?: boolean;\n  promoCode?: string;\n  tipCents?: number;\n};\n\nexport type LockerversePaymentStatus =\n  | \"action_required\"\n  | \"failed\"\n  | \"pending\"\n  | \"success\";\n\nexport type LockerversePaymentResult = {\n  checkoutId: string;\n  paymentReference: string;\n  checkoutStatus: LockerversePaymentStatus;\n  retryUrl?: string | undefined;\n  clientSecret: string | null;\n  paymentRequired: boolean;\n  requiresAction: boolean;\n  status: string | null;\n};\n\nexport type LockerversePaymentCompletion = LockerversePaymentResult & {\n  email: string | null;\n  lineItems: readonly LockerverseCheckoutLineItem[] | null;\n};\n\ntype AssertPaymentContract<T extends true> = T;\ntype _PaymentResultMatchesGenerated = AssertPaymentContract<\n  LockerversePaymentResult extends GeneratedPaymentResult\n    ? GeneratedPaymentResult extends LockerversePaymentResult\n      ? true\n      : false\n    : false\n>;\n\nexport type LockerverseShipping = {\n  address: {\n    city: string;\n    country: string;\n    line1: string;\n    line2?: string;\n    postal_code: string;\n    state: string;\n  };\n  name: string;\n};\n\nexport type LockerversePaymentSubmission = {\n  confirmationToken?: string;\n  paymentMethodConfiguration?: \"explicit\";\n  customFieldAnswers?: LockerverseCustomFieldAnswer[];\n  email: string;\n  memberId?: string;\n  merchSize?: \"XS\" | \"S\" | \"M\" | \"L\" | \"XL\" | \"XXL\" | \"XXXL\";\n  metadata?: Record<string, string>;\n  phone?: string;\n  shipping?: LockerverseShipping;\n};\n\nexport type LockerverseCheckoutItem =\n  | { productId: string; quantity: number }\n  | { productId: string; amountCents: number }\n  | { productId: string };\n\nexport type LockerverseCheckoutSelectionItem =\n  | { productSlug: string; quantity: number }\n  | { productSlug: string; amountCents: number }\n  | { productSlug: string };\n\nexport type LockerverseEstimateCheckoutInput =\n  LockerverseCheckoutPricingInput & {\n    selection: LockerverseCheckoutSelectionItem[];\n  };\n\nexport type LockerverseLoadCheckoutInput = {\n  selection: LockerverseCheckoutSelectionItem[];\n};\n\nexport type LockerverseCalculateTotalInput = LockerverseCheckoutPricingInput & {\n  catalog: LockerverseCatalog;\n} & (\n    | {\n        items: LockerverseCheckoutItem[];\n        selection?: never;\n      }\n    | {\n        items?: never;\n        selection: LockerverseCheckoutSelectionItem[];\n      }\n  );\n\nexport type LockerversePreparedCheckout = Readonly<\n  LockerverseCheckoutQuote & {\n    items: readonly LockerverseCheckoutItem[];\n    pricing: Readonly<LockerverseCheckoutPricingInput>;\n  }\n>;\n\nexport type LockerverseLoadedCheckout = Readonly<{\n  catalog: LockerverseCatalog;\n  checkout: LockerversePreparedCheckout;\n}>;\n\nexport type LockerverseSubmitPaymentInput = {\n  checkout: LockerversePreparedCheckout;\n  submission: LockerversePaymentSubmission;\n};\n\ntype CreateLockerverseWidgetBaseOptions = {\n  communitySlug: string;\n  fetch?: typeof globalThis.fetch;\n  onError?: (error: LockerverseSdkError) => void;\n  requestTimeoutMs?: number;\n  sentryDsn?: string | null;\n  widgetSlug: string;\n};\n\nexport type LockerverseResourceEnvironmentOptions =\n  | {\n      apiBaseUrl: string;\n      environment: LockerverseEnvironment;\n    }\n  | {\n      apiBaseUrl?: undefined;\n      environment?: \"production\";\n    };\n\nexport type CreateLockerverseWidgetOptions =\n  CreateLockerverseWidgetBaseOptions & LockerverseResourceEnvironmentOptions;\n\nexport type LockerverseCheckoutClient = {\n  calculateTotal: (\n    input: LockerverseCalculateTotalInput\n  ) => Promise<LockerversePreparedCheckout>;\n  getPaymentStatus: (\n    paymentReference: string\n  ) => Promise<LockerversePaymentResult>;\n  load: {\n    (): Promise<LockerverseCatalog>;\n    (input: LockerverseLoadCheckoutInput): Promise<LockerverseLoadedCheckout>;\n  };\n  submitPayment: (\n    input: LockerverseSubmitPaymentInput\n  ) => Promise<LockerversePaymentResult>;\n};\n"],"mappings":"ACWA,MAAa,EAA0BA,gBAoLvC,IAAa,EAAb,cAAyC,KAAM,CAC7C,KACA,UACA,WACA,oBACA,WACA,WACA,OAEA,YAAY,CACV,OACA,UACA,YACA,aACA,sBAAsB,GACtB,aACA,UASC,CACD,MAAM,CAAO,EACb,KAAK,KAAO,sBACZ,KAAK,KAAO,EACZ,KAAK,UAAY,EACjB,KAAK,WAAa,EAClB,KAAK,oBAAsB,EAC3B,KAAK,WAAa,EAClB,KAAK,WAAa,EAClB,KAAK,OAAS,CAChB,CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lockerverse/sdk",
-  "version": "0.2.177",
+  "version": "0.2.181-dev.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Lockerverse/lockerverse-sdk.git",