@v-office/website-sdk 2.11.0 → 2.13.0

package/dist/{search-QlZrI7ue.mjs → search-Byi6XboR.mjs}

@@ -1,5 +1,5 @@
-import { a as parseQueryParameters, i as collectQueryParameters, n as makeV9CustomAttributeFilterCapabilities, o as toQueryString, r as toBasicQueryInputs, s as applyVofficeFilterDerivedBasicQueryInputs } from "./client-DYAHnU5F.mjs";
-import { a as searchQuery, c as VofficeUnitDataFieldSchemas, m as parseVofficeUnitData, n as toImages, r as toAddress, t as toRentalHighlights } from "./to-rental-highlights-B6a_fi0j.mjs";
+import { a as parseQueryParameters, i as collectQueryParameters, n as makeV9CustomAttributeFilterCapabilities, o as toQueryString, r as toBasicQueryInputs, s as applyVofficeFilterDerivedBasicQueryInputs } from "./client-Ma0daa2H.mjs";
+import { a as searchQuery, c as VofficeUnitDataFieldSchemas, m as parseVofficeUnitData, n as toImages, r as toAddress, t as toRentalHighlights } from "./to-rental-highlights-BVikT4Iz.mjs";
 import { CoreSDKError, STABLE_SEARCH_INPUTS, daysBetweenLocalDates, expandCustomAttributeFilterCompositions, parseChildrenAges, parseOccupancyCount, resolveExpandedCompositions, toFormattedSearchPrice, toIsoDateFromPeriodQueryDate, toStableSearchInputBackendQueryKeys, toStableSearchInputParameterValues, toStableSearchInputQueryKeys, toUnusedFilterKeys } from "@v-office/sdk-core";
 import { Effect } from "effect";
 //#region src/legacy-v9/parser/search/input/search-input-error.ts
@@ -79,9 +79,11 @@ const PERIOD_QUERY_KEYS = toStableSearchInputBackendQueryKeys({
 	backend: "v9",
 	group: STABLE_SEARCH_INPUTS.period
 });
+const UNSUPPORTED_FLEXIBLE_PERIOD_QUERY_KEYS = new Set(STABLE_SEARCH_INPUTS.period.keys.filter((key) => !PERIOD_QUERY_KEYS.has(key)));
 //#endregion
 //#region src/legacy-v9/parser/search/input/period/collect-period-query-parameters.ts
 const hasPeriodInput = (query) => parseQueryParameters(query).some(([key]) => PERIOD_QUERY_KEYS.has(key));
+const hasUnsupportedFlexiblePeriodInput = (query) => parseQueryParameters(query).some(([key]) => UNSUPPORTED_FLEXIBLE_PERIOD_QUERY_KEYS.has(key));
 const collectPeriodQueryParameters = ({ query }) => {
 	const { matchingParameters, remainingParameters } = collectQueryParameters({
 		query,
@@ -178,6 +180,7 @@ const toVofficeSorting = (sort) => {
 //#endregion
 //#region src/legacy-v9/parser/search/input/to-query-input.ts
 const toQueryInput = ({ query, sort, customAttributeFilterDefinitions, locale, translations }) => Effect.gen(function* () {
+	if (hasUnsupportedFlexiblePeriodInput(query)) return yield* failInvalidV9SearchInput("Legacy v9 search does not support flexible period query parameters \"month\", \"dates\", \"nights\", or \"weekend\". Use \"start\" and \"end\" for a fixed period.");
 	const compositionResult = expandCustomAttributeFilterCompositions({
 		capabilities: makeV9CustomAttributeFilterCapabilities(customAttributeFilterDefinitions),
 		customAttributeFilterDefinitions,
@@ -221,21 +224,41 @@ const toQueryInput = ({ query, sort, customAttributeFilterDefinitions, locale, t
 				alternatives: true,
 				sorting: toVofficeSorting(sort)
 			},
-			basicQueryInputs
+			basicQueryInputs: basicQueryInputs.length > 0 ? basicQueryInputs : null
 		},
 		unusedFilterKeys: compositionFilters.unusedFilterKeys
 	};
 });
 //#endregion
-//#region src/legacy-v9/parser/search/output/to-formatted-price.ts
-const DEFAULT_V9_SEARCH_CURRENCY$1 = "EUR";
-const toFormattedPrice = ({ locale, calc }) => {
-	if (calc?.total == null) return Effect.succeed(null);
-	return Effect.succeed(toFormattedSearchPrice({
+//#region src/legacy-v9/parser/search/output/to-search-price-fields.ts
+const DEFAULT_V9_SEARCH_CURRENCY = "EUR";
+const toSearchPriceFields = ({ locale, calc }) => {
+	if (calc?.total == null) return {};
+	const formattedTotal = toFormattedSearchPrice({
 		amount: calc.total,
-		currency: DEFAULT_V9_SEARCH_CURRENCY$1,
+		currency: DEFAULT_V9_SEARCH_CURRENCY,
 		locale
-	}));
+	});
+	if (calc.oTotal == null || calc.oTotal <= calc.total) return { formattedTotal };
+	const label = calc.discountName?.trim();
+	return {
+		formattedTotal,
+		discount: {
+			formattedOriginalTotal: toFormattedSearchPrice({
+				amount: calc.oTotal,
+				currency: DEFAULT_V9_SEARCH_CURRENCY,
+				locale
+			}),
+			applied: label == null || label.length === 0 ? [] : [{
+				label,
+				formattedAmount: toFormattedSearchPrice({
+					amount: calc.total - calc.oTotal,
+					currency: DEFAULT_V9_SEARCH_CURRENCY,
+					locale
+				})
+			}]
+		}
+	};
 };
 //#endregion
 //#region src/legacy-v9/parser/search/to-search-output-item.ts
@@ -258,26 +281,23 @@ const toSearchOutputItem = ({ locale, imageProxyBaseUrl, rentalHighlightPrioriti
 		attributes: data
 	});
 	if (highlights != null) item.highlights = highlights;
-	const formattedPrice = yield* toFormattedPrice({
+	if (includeFormattedTotal) Object.assign(item, toSearchPriceFields({
 		locale,
 		calc: rental.additional_voffice_data?.calc
-	});
-	if (includeFormattedTotal && formattedPrice != null) item.formattedTotal = formattedPrice;
+	}));
 	return item;
 });
 //#endregion
 //#region src/legacy-v9/parser/search/output/to-alternative-periods.ts
-const DEFAULT_V9_SEARCH_CURRENCY = "EUR";
 const toAlternativePeriods = ({ locale, alternatives }) => Effect.succeed((alternatives ?? []).flatMap((alternative) => {
 	if (alternative.fromdate == null || alternative.tilldate == null) return [];
 	return [{
 		start: alternative.fromdate,
 		end: alternative.tilldate,
-		...alternative.calc?.total == null ? {} : { formattedTotal: toFormattedSearchPrice({
-			amount: alternative.calc.total,
-			currency: DEFAULT_V9_SEARCH_CURRENCY,
-			locale
-		}) }
+		...toSearchPriceFields({
+			locale,
+			calc: alternative.calc
+		})
 	}];
 }));
 //#endregion

package/dist/{to-rental-highlights-B6a_fi0j.mjs → to-rental-highlights-BVikT4Iz.mjs}

@@ -5900,10 +5900,11 @@ const toRentalHighlights = ({ locale, translations, highlightPrioritization, cus
 			const attribute = customAttributes.byKey[highlightKey];
 			if (attribute === void 0) continue;
 			const binding = attribute.v9;
+			const value = binding === void 0 ? void 0 : knownAttributes[binding] ?? attributes.unknown[binding];
 			const highlight = renderResolvedCustomAttribute({
 				attribute,
 				locale,
-				value: binding === void 0 ? void 0 : knownAttributes[binding] ?? attributes.unknown[binding]
+				value
 			});
 			if (highlight != null) {
 				highlights.push(highlight);
@@ -5914,9 +5915,10 @@ const toRentalHighlights = ({ locale, translations, highlightPrioritization, cus
 		if (seenKeys.has(v9Key)) continue;
 		seenKeys.add(v9Key);
 		const metadata = VofficeUnitDataPropertyMetadata[v9Key];
+		const label = yield* translate(metadata.labelKey, v9Key);
 		const highlight = renderLabeledAttributeValue({
 			key: v9Key,
-			label: yield* translate(metadata.labelKey, v9Key),
+			label,
 			locale,
 			value: knownAttributes[v9Key]
 		});

package/dist/translations/shared/de-DE/booking.json

@@ -4,6 +4,13 @@
   "booking.payment.schedule.prepayment.label": "Anzahlung",
   "booking.payment.schedule.rest.label": "Restzahlung",
   "booking.payment.schedule.dueOn": "Zahlbar bis zum",
+  "booking.payment.schedule.location.online": "Online zahlbar",
+  "booking.payment.schedule.location.onSite": "Vor Ort zahlbar",
+  "booking.payment.schedule.location.onSite.partner": "Vor Ort an den Vermieter zu zahlen",
+  "booking.payment.schedule.location.onSite.us": "Vor Ort an vOffice zu zahlen",
+  "booking.payment.schedule.location.external": "Extern zu zahlen",
+  "booking.payment.schedule.location.external.partner": "Extern an den Vermieter zu zahlen",
+  "booking.payment.schedule.location.external.us": "Extern an vOffice zu zahlen",
   "booking.payment.schedule.deposit": "Kaution",
   "booking.payment.schedule.price": "Preis",
   "booking.payment.schedule.totalAmount": "Endpreis",

package/dist/translations/shared/en-US/booking.json

@@ -4,6 +4,13 @@
   "booking.payment.schedule.prepayment.label": "Down payment",
   "booking.payment.schedule.rest.label": "Remaining payment",
   "booking.payment.schedule.dueOn": "Payable until",
+  "booking.payment.schedule.location.online": "Payable online",
+  "booking.payment.schedule.location.onSite": "Payable on site",
+  "booking.payment.schedule.location.onSite.partner": "Payable on site to the host",
+  "booking.payment.schedule.location.onSite.us": "Payable on site to vOffice",
+  "booking.payment.schedule.location.external": "Payable externally",
+  "booking.payment.schedule.location.external.partner": "Payable externally to the host",
+  "booking.payment.schedule.location.external.us": "Payable externally to vOffice",
   "booking.payment.schedule.deposit": "Deposit",
   "booking.payment.schedule.price": "Price",
   "booking.payment.schedule.totalAmount": "Final price",

package/instructions/CHANGELOG.md

@@ -4,6 +4,8 @@ This file is the versioned changelog index for the website SDK instructions.
 
 ## Versions
 
+- `versions/2.13.0/CHANGELOG.md`: `@v-office/website-sdk` 2.13.0 release notes.
+- `versions/2.12.0/CHANGELOG.md`: `@v-office/website-sdk` 2.12.0 release notes.
 - `versions/2.11.0/CHANGELOG.md`: `@v-office/website-sdk` 2.11.0 release notes.
 - `versions/2.10.0/CHANGELOG.md`: `@v-office/website-sdk` 2.10.0 release notes.
 - `versions/2.9.0/CHANGELOG.md`: `@v-office/website-sdk` 2.9.0 release notes.

package/instructions/MIGRATION.md

@@ -4,6 +4,8 @@ This file is the versioned migration index for the website SDK instructions.
 
 ## Available Guides
 
+- `versions/2.13.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.12.0 to 2.13.0.
+- `versions/2.12.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.11.0 to 2.12.0.
 - `versions/2.11.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.10.0 to 2.11.0.
 - `versions/2.10.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.9.0 to 2.10.0.
 - `versions/2.9.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.8.0 to 2.9.0.

package/instructions/README.md

@@ -1,7 +1,7 @@
 # Website SDK Instructions
 
 These instructions describe the current source targeted for
-`@v-office/website-sdk` 2.11.0. Package versions remain unchanged until the release
+`@v-office/website-sdk` 2.13.0. Package versions remain unchanged until the release
 workflow performs the coordinated core and website bumps.
 
 Use this directory as the consumer-facing reference for the package:
@@ -12,12 +12,18 @@ Use this directory as the consumer-facing reference for the package:
 - `custom-attributes.md`: custom attribute catalog, configuration, per-backend behaviour, and the v9-to-v10 move.
 - `search.md`: `sdk.live.search.search`.
 - `availability.md`: date-picker availability flows.
-- `quote.md`: quote, additional services, cancellation policy, and insurance flows.
+- `quote.md`: quote booking-card modifiers, additional services, cancellation policy, and insurance flows.
 - `booking.md`: booking and payment option submission.
 - `contact.md`: contact submission.
 - `document-structured-json.md`: `sdk.static.documents.getTermsAndPrivacyPolicy` and structured document JSON rendering rules.
 - `CHANGELOG.md`: versioned changelog index.
 - `MIGRATION.md`: versioned migration index.
+- `versions/2.13.0/`: 2.13.0 static search capability discovery, shared v9/v10
+  booking-payment output, corrected remaining-payment deadlines, opaque booking
+  credentials, and the 2.12.0-to-2.13.0 migration guide.
+- `versions/2.12.0/`: 2.12.0 legacy-v9 search discounts, empty-query browsing,
+  and flexible-period rejection; quote booking-card cleanup; and v10 modifier
+  guidance, plus the 2.11.0-to-2.12.0 migration guide.
 - `versions/2.11.0/`: 2.11.0 search-discount release notes and
   2.10.0-to-2.11.0 migration guide.
 - `versions/2.10.0/`: 2.10.0 option-booking release notes and 2.9.0-to-2.10.0 migration guide.
@@ -39,7 +45,9 @@ Use this directory as the consumer-facing reference for the package:
 pnpm add @v-office/website-sdk
 ```
 
-The package is ESM-only and exports the root SDK facade from `@v-office/website-sdk`.
+The package is ESM-only. It exports the SDK facade from `@v-office/website-sdk`
+and instance-independent search capability helpers from
+`@v-office/website-sdk/capabilities/search`.
 
 ## Quick Start
 
@@ -79,5 +87,5 @@ website-sdk --backend v10 search --locale de-DE --query "adults=2" --sort '{"by"
 ```
 
 Config file examples in these docs use the flat `WebsiteSDKConfig` shape introduced
-in 2.0.0 and kept in 2.11.0. v10 config additionally requires `searchEndpoint` as
+in 2.0.0 and kept in 2.13.0. v10 config additionally requires `searchEndpoint` as
 of 2.5.0.

package/instructions/booking.md

@@ -78,47 +78,63 @@ Sample:
 ```json
 {
   "bookingNumber": "B-2026-0001",
-  "guestToken": "guest-token",
-  "paymentSchedules": [
-    {
-      "label": "Deposit",
-      "dueOn": "2026-06-15",
-      "lines": [
-        {
-          "label": "Deposit",
-          "amount": "300.00 EUR"
-        }
-      ],
-      "total": "300.00 EUR",
-      "paymentOptions": [
-        {
-          "kind": "bank_transfer",
-          "label": "Bank transfer",
-          "holder": "Example GmbH",
-          "iban": "DE02120300000000202051",
-          "swiftOrBic": "BYLADEM1001",
-          "remittanceText": "B-2026-0001"
-        },
-        {
-          "kind": "redirect",
-          "provider": "adyen",
-          "label": "Credit card",
-          "url": "https://checkout.example.com"
-        },
-        {
-          "kind": "stripe_checkout",
-          "provider": "stripe",
-          "label": "Credit card",
-          "sessionId": "cs_live_a1Upmvi1v62AdILeDZl4l",
-          "accountId": "acct_1MpAB7AFrTg9gw7b"
-        }
-      ]
-    }
-  ],
-  "insurancePaymentOptions": []
+  "payment": {
+    "schedule": [
+      {
+        "kind": "prepayment",
+        "label": "Down payment",
+        "amount": "€76.00",
+        "dueOn": "Payable until August 19, 2026",
+        "paymentOptions": [
+          {
+            "kind": "bank_transfer",
+            "label": "Bank transfer",
+            "holder": "Example GmbH",
+            "iban": "DE02120300000000202051",
+            "swiftOrBic": "BYLADEM1001",
+            "remittanceText": "Booking number: B-2026-0001"
+          }
+        ]
+      },
+      {
+        "kind": "remaining_payment",
+        "label": "Remaining payment",
+        "amount": "€304.00",
+        "dueOn": "Payable until February 6, 2027"
+      }
+    ],
+    "alternatives": [
+      {
+        "kind": "full_amount",
+        "label": "Total payment",
+        "amount": "€380.00",
+        "paymentOptions": [
+          {
+            "kind": "bank_transfer",
+            "label": "Bank transfer",
+            "holder": "Example GmbH",
+            "iban": "DE02120300000000202051",
+            "swiftOrBic": "BYLADEM1001",
+            "remittanceText": "Booking number: B-2026-0001"
+          }
+        ]
+      }
+    ]
+  }
 }
 ```
 
+`payment.schedule` contains the remaining contractual payment steps known to the backend. Its `kind` is one of `prepayment`, `remaining_payment`, `installment`, or `deposit`. `v9` emits named prepayment and remaining-payment steps; `v10` emits its backend-provided installment and deposit steps.
+
+`payment.alternatives` contains ways to settle the complete outstanding balance. A `full_amount` alternative has no inferred deadline. `dueOn`, `paymentAt`, labels, amounts, and line amounts are already translated and formatted for the booking locale.
+
+`paymentOptions` is present only when the SDK can currently perform that payment. Future or on-site steps remain visible without payment options.
+
+An optional `insurancePaymentOptions` array is returned only when post-booking insurance payment is available.
+
+Sites upgrading from 2.12.0 must replace the former `paymentSchedules` output. See
+`versions/2.13.0/MIGRATION.md`.
+
 Payment option variants:
 
 - `bank_transfer`: display-only payment details.
@@ -153,13 +169,13 @@ try {
 
 Online payment providers return the guest to a URL derived from `relativeRedirectUrl`. Stripe returns to that path with `payment=stripe&success=true` after payment and `payment=stripe&cancel=true` after cancellation, so the path must exist in your site and should read those query parameters.
 
-`relativeRedirectUrl` is supplied before the reservation exists, so the return URL cannot carry the booking number or guest token. Persist whatever the return page needs, for example in `sessionStorage`, before submitting a payment option.
+`relativeRedirectUrl` is supplied before the reservation exists, so the return URL cannot carry the booking number. Persist whatever the return page needs, for example in `sessionStorage`, before submitting a payment option.
 
 A successful return means the provider sent the browser back, not that the payment has settled. Confirmation reaches vOffice through the provider's webhook.
 
 ## Configuration
 
-Booking requests are rate-limited to one backend request per second with a queue size of five. `v9` books through the v0 `book` action and initializes one Stripe Checkout Session per payment schedule option when the property has Stripe enabled. `v10` books through GraphQL and initializes Adyen redirect payment options.
+Booking requests are rate-limited to one backend request per second with a queue size of five. `v9` books through the v0 `book` action and initializes Stripe only for currently payable choices when the property has Stripe enabled. `v10` books through GraphQL, preserves all remaining payment steps for display, and initializes Adyen for the next payable online step and the full-outstanding alternative.
 
 ## CLI Usage
 

package/instructions/quote.md

@@ -62,13 +62,13 @@ Sample:
 ```
 
 Dates are local dates formatted as `YYYY-MM-DD`. For `v9`, `rentalId` must be a numeric vOffice unit id.
-Both backends accept `voucher` on quote and booking flows. `v10` can expose voucher discounts as booking-card modifiers when the backend returns voucher modifiers; `v9` reflects voucher effects in the quoted totals but does not expose a separate voucher modifier line.
+Both backends accept `voucher` on quote and booking flows. On `v10`, applied voucher and non-voucher modifiers can be exposed through the booking-card fields described below. `v9` reflects voucher effects in quoted totals but does not expose booking-card modifier details.
 
 ## Output
 
 Returns `Promise<GuestQuoteResult>`.
 
-Available sample:
+Available sample without modifiers:
 
 ```json
 {
@@ -139,6 +139,94 @@ Unavailable sample:
 
 Selection methods return `{ ok: true, quote }` or `{ ok: false, error }`. Possible selection errors include unknown additional service, additional service limit exceeded, unknown cancellation policy, unavailable cancellation policy quote, and unavailable quote combination.
 
+## Booking-Card Breakdown
+
+Booking-card sections are returned in display order. On both v9 and v10, the SDK
+omits numeric zero-value lines without subitems from the included, tax, and other
+breakdown sections. If no lines remain in a section, the section is omitted.
+Non-zero lines are unchanged, including when they share an `other` section with a
+filtered zero-value line.
+
+A zero-total line with subitems can remain because those subitems carry
+descriptive content. Do not use the absence or presence of a zero-value price row
+as service-selection state; use the quote's explicit service or selection data.
+
+### Modifiers and Pre-Modifier Totals
+
+On `v10`, a booking-card item at
+`bookingCardInformation.sections[].lines[].item` can include these optional
+fields:
+
+```ts
+{
+  modifiers?: readonly {
+    label: string;
+    amount: string;
+  }[];
+  totalBeforeModifiers?: string;
+}
+```
+
+`modifiers` contains localized, formatted adjustments applied to that item. A
+negative amount represents a deduction and a positive amount represents a
+surcharge. The SDK groups backend modifiers with the same label and formats their
+summed amount as one entry. The field is omitted when the item has no modifiers.
+
+`item.totalBeforeModifiers` is the formatted item amount before its modifiers. It
+is present when the item has a non-zero net modifier effect and the amount can be
+derived; otherwise it is omitted. `item.appliedCharge` remains the final amount
+after modifiers.
+
+The booking card itself can also include
+`bookingCardInformation.totalBeforeModifiers`. It is the formatted whole-card
+total before all backend modifiers and is present when those modifiers have a
+non-zero net effect. It is omitted when there are no modifiers or their amounts
+net to zero. The SDK derives quote pre-modifier totals from the final amounts and
+modifier values.
+
+Items in the included, tax, and other sections carry their adjustments in
+`item.modifiers`; do not expect those adjustments to be separate section lines.
+Negative modifiers on backend lines that cannot be mapped to those sections may
+instead appear as dedicated booking-card lines. `v9` quote cards omit
+`modifiers` and both `totalBeforeModifiers` fields.
+
+Discounted `v10` example for locale `de-DE`:
+
+```json
+{
+  "bookingCardInformation": {
+    "sections": [
+      {
+        "lines": [
+          {
+            "item": {
+              "position": "Inklusivpreis",
+              "appliedCharge": "1.554,00 €",
+              "modifiers": [
+                {
+                  "label": "Frühbucher/Last-Minute",
+                  "amount": "-140,00 €"
+                }
+              ],
+              "totalBeforeModifiers": "1.694,00 €"
+            }
+          }
+        ]
+      }
+    ],
+    "total": "1.596,70 €",
+    "totalBeforeModifiers": "1.736,70 €"
+  }
+}
+```
+
+For a price breakdown that keeps its arithmetic visible, render
+`totalBeforeModifiers` as the pre-modifier amount, show each modifier as an
+adjustment row, and use `appliedCharge` or `total` as the resulting final amount.
+The SDK supplies formatted values but does not decide whether a reference price
+should be displayed or struck through; that presentation and its legal
+requirements remain the consuming site's responsibility.
+
 ## Vouchers
 
 When `voucher` is provided in the quote input, an available quote may include `quote.voucher`:
@@ -153,7 +241,11 @@ When `voucher` is provided in the quote input, an available quote may include `q
 
 `status` is `"applied"`, `"not_applied"`, or `"unknown"`. `v10` reports `"applied"` when the backend returns a non-zero voucher modifier and `"not_applied"` when no voucher modifier is returned for the requested voucher. `v9` returns `"unknown"` for available voucher quotes because the legacy response does not provide a reliable voucher modifier signal.
 
-Voucher modifiers can appear in `bookingCardInformation.sections`. Sections are returned in display order.
+Do not assume an applied voucher appears as its own section line. On `v10`, a
+voucher adjustment on an included, tax, or other line appears in that line's
+`item.modifiers`; an unmapped negative modifier can appear as a dedicated line.
+Use `quote.voucher.status` for voucher application status and the booking-card
+fields for price presentation.
 
 ## Additional Services
 
@@ -301,16 +393,18 @@ quote = await sdk.live.quote.selectInsurancePayment({
 });
 ```
 
-After the rental booking is created, complete insurance booking with the booking number and guest token:
+After the rental booking is created, complete insurance booking with the opaque booking result. Keep the live result object; its private backend credentials are intentionally not serialized:
 
 ```ts
 const insuranceBooking = await sdk.live.quote.bookInsurance({
   quote,
-  bookingNumber: booking.bookingNumber,
-  guestToken: booking.guestToken,
+  booking,
 });
 ```
 
+This is a breaking change in 2.13.0. The former public `guestToken` input is no
+longer used; see `versions/2.13.0/MIGRATION.md`.
+
 `v9` supports real insurance option refresh, pre-contract, payment selection, and booking. `v10` currently returns a no-insurance placeholder and insurance actions resolve as not required.
 
 ## Configuration